Twilio Receive SMS — Handling Incoming Text Messages with Webhooks

from flask import Flask, request, Response
from twilio.twiml.messaging_response import MessagingResponse

app = Flask(__name__)

@app.route('/twilio/sms-inbound', methods=['POST'])
def handle_incoming_sms():
    # Extract message details
    from_number = request.form.get('From')
    to_number = request.form.get('To')
    body = request.form.get('Body', '').strip()
    message_sid = request.form.get('MessageSid')

    print(f"Received SMS from {from_number}: {body}")

    # Log the incoming message
    database.log_incoming_message(
        sid=message_sid,
        from_number=from_number,
        to_number=to_number,
        body=body
    )

    # Create a response
    response = MessagingResponse()
    response.message(f"Thanks for your message! We received: '{body[:50]}...'")

    return Response(str(response), mimetype='text/xml')

@app.route('/twilio/sms-interactive', methods=['POST'])
def handle_interactive_sms():
    from_number = request.form.get('From')
    body = request.form.get('Body', '').strip().upper()
    response = MessagingResponse()

    if body == 'HELP':
        response.message(
            "Available commands:\n"
            "STATUS - Check your order status\n"
            "BALANCE - Check account balance\n"
            "SUPPORT - Talk to a human\n"
            "STOP - Unsubscribe"
        )

    elif body == 'STATUS':
        orders = database.get_recent_orders(from_number)
        if orders:
            msg = "Your orders:\n"
            for order in orders[:3]:
                msg += f"#{order['id']}: {order['status']}\n"
            response.message(msg)
        else:
            response.message("No recent orders found.")

    elif body.startswith('SUPPORT'):
        database.create_support_ticket(from_number, body)
        response.message(
            "A support agent will contact you shortly. "
            "Your ticket ID: TKT-" + str(int(time.time()))
        )

    elif body == 'STOP':
        database.update_sms_preference(from_number, opted_out=True)
        response.message("You've been unsubscribed. Reply START to resubscribe.")

    else:
        response.message(
            "I didn't understand that. Reply HELP for available commands."
        )

    return Response(str(response), mimetype='text/xml')

def parse_sms_command(body, from_number):
    """Parse incoming SMS and determine the action to take"""
    body = body.strip().upper()

    if body == 'STOP' or body == 'STOPALL' or body == 'UNSUBSCRIBE' or body == 'CANCEL':
        return {'action': 'opt_out', 'message': 'You have been unsubscribed.'}

    elif body == 'START' or body == 'YES':
        return {'action': 'opt_in', 'message': 'You have been resubscribed.'}

    elif body == 'HELP' or body == 'INFO':
        return {
            'action': 'help',
            'message': 'Commands: HELP, STATUS, BALANCE, SUPPORT, STOP'
        }

    elif body.startswith('Y') or body.startswith('YES'):
        return {'action': 'confirm', 'message': 'Confirmed!'}

    elif body.startswith('N') or body == 'NO':
        return {'action': 'decline', 'message': 'Action cancelled.'}

    else:
        return {'action': 'unknown', 'message': 'Reply HELP for options.'}