Overview

Caller → Plivo → Your Server (Answer URL) → XML Response → Plivo executes

Your App → Plivo API → Call Recipient → XML from answer_url → Execute

<Response>
    <Speak>Hello! Welcome to our service.</Speak>
    <Play>https://example.com/audio/menu.mp3</Play>
</Response>

<Response>
    <Speak>Please hold while we connect you.</Speak>
    <Play>https://example.com/hold-music.mp3</Play>
    <Dial>
        <Number>+14155551234</Number>
    </Dial>
    <Speak>Sorry, no one is available. Goodbye.</Speak>
    <Hangup/>
</Response>

<Response>
    <GetDigits action="/handle-input/" numDigits="1">
        <Speak>Press 1 for sales, 2 for support.</Speak>
    </GetDigits>
    <Speak>We didn't receive any input. Goodbye.</Speak>
</Response>

# Flask
from flask import Response
return Response(xml_string, mimetype='application/xml')

// Express
res.set('Content-Type', 'application/xml');
res.send(xmlString);

# Sinatra
content_type 'application/xml'
xml_string

// PHP
header('Content-Type: application/xml');
echo $xml_string;

<Response>
</Response>

from flask import Flask, request, Response
from plivo import plivoxml

app = Flask(__name__)

@app.route('/answer/', methods=['GET', 'POST'])
def answer():
    call_uuid = request.values.get('CallUUID')
    caller = request.values.get('From')
    called = request.values.get('To')
    direction = request.values.get('Direction')

    response = plivoxml.ResponseElement()

    if direction == 'inbound':
        # Log the incoming call
        print(f"Incoming call from {caller} to {called}, UUID: {call_uuid}")

        # Custom greeting based on caller ID
        if is_vip_customer(caller):
            response.add(plivoxml.SpeakElement('Welcome back, valued customer!'))
        else:
            response.add(plivoxml.SpeakElement('Thank you for calling.'))
    else:
        response.add(plivoxml.SpeakElement('Connecting your call.'))

    return Response(response.to_string(), mimetype='application/xml')

<Response>
    <GetDigits action="/ivr-response/" numDigits="1" timeout="10">
        <Speak>
            Welcome to Acme Corp.
            Press 1 for sales.
            Press 2 for support.
            Press 3 to hear our hours.
        </Speak>
    </GetDigits>
    <Speak>Sorry, we didn't receive any input. Goodbye.</Speak>
    <Hangup/>
</Response>

<Response>
    <Dial callerId="+14155551234">
        <Number>+14155559876</Number>
    </Dial>
</Response>