Twilio Voice Calls — Making and Receiving Phone Calls Programmatically

from twilio.rest import Client
from twilio.twiml.voice_response import VoiceResponse, Say, Gather

client = Client(TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN)

def make_verification_call(to_number, code):
    """Make an automated call that reads a verification code"""
    response = VoiceResponse()
    response.say("Your DodaTech verification code is:", voice='alice')
    response.say(' '.join(code), voice='alice')  # Reads digits individually
    response.say("Repeat: " + ' '.join(code), voice='alice')
    response.hangup()

    call = client.calls.create(
        twiml=str(response),
        to=to_number,
        from_='+15551234567'
    )
    print(f"Call initiated: {call.sid}")
    return call.sid

@app.route('/twilio/voice/ivr', methods=['POST'])
def ivr_main_menu():
    response = VoiceResponse()
    gather = Gather(
        num_digits=1,
        action='/twilio/voice/handle-menu',
        timeout=5
    )
    gather.say(
        "Welcome to DodaTech support. "
        "Press 1 for account support. "
        "Press 2 for technical support. "
        "Press 3 to speak to a representative.",
        voice='alice'
    )
    response.append(gather)

    # If no input, try again
    response.say("Sorry, I didn't receive any input. Goodbye.")
    response.hangup()

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

@app.route('/twilio/voice/handle-menu', methods=['POST'])
def handle_menu():
    digits = request.form.get('Digits', '')
    response = VoiceResponse()

    if digits == '1':
        response.say("Redirecting to account support.")
        response.dial('+15559876543')  # Forward to agent

    elif digits == '2':
        response.say("Redirecting to technical support.")
        response.dial('+15558765432')  # Forward to tech support

    elif digits == '3':
        response.say("Please hold while we connect you.")
        response.dial('+15557654321')  # Forward to operator

    else:
        response.say("Invalid option.")
        response.redirect('/twilio/voice/ivr')

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

def make_recorded_call(to_number, message):
    """Make a call with recording enabled"""
    response = VoiceResponse()
    response.say(message, voice='alice')
    response.record(
        action='/twilio/voice/recording-complete',
        method='POST',
        max_length=30,
        play_beep=True
    )
    response.hangup()

    call = client.calls.create(
        twiml=str(response),
        to=to_number,
        from_='+15551234567',
        record=True,
        recording_status_callback='/twilio/voice/recording-status'
    )
    return call.sid

@app.route('/twilio/voice/recording-status', methods=['POST'])
def recording_status():
    recording_sid = request.form.get('RecordingSid')
    recording_url = request.form.get('RecordingUrl')
    call_sid = request.form.get('CallSid')
    duration = request.form.get('RecordingDuration')

    database.store_recording(call_sid, recording_sid, recording_url, duration)
    return '', 200