Enregistrer des appels Twilio

Quand utiliser chaque approche

Avant de commencer, comprenez les compromis entre l’intégration native et l’approche d’enregistrement d’appel :

Vue d’ensemble

Le point de terminaison d’enregistrement d’appel vous permet d’utiliser votre propre infrastructure Twilio tout en tirant parti des agents ElevenLabs pour la conversation. Au lieu d’importer votre numéro Twilio dans ElevenLabs, vous gardez le contrôle total de votre configuration Twilio et utilisez l’API ElevenLabs pour enregistrer les appels et recevoir du TwiML afin de les connecter à vos agents.

Cette approche est idéale si vous :

• Devez conserver votre infrastructure et vos workflows Twilio existants
• Souhaitez contrôler par programmation le routage et le traitement des appels
• Disposez de flux d’appel complexes nécessitant une logique Twilio personnalisée avant la connexion à un agent
• Devez intégrer des agents ElevenLabs à un système de téléphonie existant

Fonctionnement

1. Votre serveur reçoit un appel entrant ou lance un appel sortant via Twilio
2. Votre serveur appelle le point de terminaison d’enregistrement d’appel ElevenLabs avec les détails de l’agent et de l’appel
3. ElevenLabs renvoie du TwiML qui connecte l’appel à votre agent via WebSocket
4. Vous renvoyez ce TwiML à Twilio afin d’établir la connexion

Prérequis

• Un compte ElevenLabs
• Un agent conversationnel ElevenLabs configuré (créez-en un ici)
• Un compte Twilio avec un numéro de téléphone actif
• Votre agent configuré avec le format audio μ-law 8000 Hz, consultez la configuration de l’agent

Configuration de l’agent

Avant d’utiliser le point de terminaison d’enregistrement d’appel, configurez votre agent pour utiliser le bon format audio pris en charge par Twilio.

1

Configurer la sortie TTS

1. Accédez aux paramètres de votre agent
2. Ouvrez la section Voice
3. Sélectionnez « μ-law 8000 Hz » dans la liste déroulante

2

Définir le format d’entrée

1. Accédez aux paramètres de votre agent
2. Ouvrez la section Advanced
3. Sélectionnez « μ-law 8000 Hz » comme format d’entrée

Référence API

Le point de terminaison d’enregistrement d’appel accepte les paramètres suivants :

Le point de terminaison renvoie du TwiML que vous devez transmettre directement à Twilio.

Implémentation

import os
from fastapi import FastAPI, Request
from fastapi.responses import Response
from elevenlabs import ElevenLabs
app = FastAPI()
elevenlabs = ElevenLabs()
AGENT_ID = os.getenv("ELEVENLABS_AGENT_ID")
@app.post("/twilio/inbound")
async def handle_inbound_call(request: Request):
    form_data = await request.form()
    from_number = form_data.get("From")
    to_number = form_data.get("To")
    # Register the call with ElevenLabs
    twiml = elevenlabs.conversational_ai.twilio.register_call(
        agent_id=AGENT_ID,
        from_number=from_number,
        to_number=to_number,
        direction="inbound",
        conversation_initiation_client_data={
            "dynamic_variables": {
                "caller_number": from_number,
            }
        }
    )
    # Return the TwiML directly to Twilio
    return Response(content=twiml, media_type="application/xml")
if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

Appels sortants

Pour les appels sortants, lancez l’appel via Twilio et dirigez l’URL du webhook vers votre serveur, qui s’enregistre ensuite auprès d’ElevenLabs :

from twilio.rest import Client
import os
from fastapi import Request
from fastapi.responses import Response
from elevenlabs import ElevenLabs
# Initialize clients
twilio_client = Client(
    os.getenv("TWILIO_ACCOUNT_SID"),
    os.getenv("TWILIO_AUTH_TOKEN")
)
elevenlabs = ElevenLabs()
AGENT_ID = os.getenv("ELEVENLABS_AGENT_ID")
def initiate_outbound_call(to_number: str):
    call = twilio_client.calls.create(
        from_=os.getenv("TWILIO_PHONE_NUMBER"),
        to=to_number,
        url="https://your-server.com/twilio/outbound"
    )
    return call.sid
@app.post("/twilio/outbound")
async def handle_outbound_webhook(request: Request):
    form_data = await request.form()
    from_number = form_data.get("From")
    to_number = form_data.get("To")
    twiml = elevenlabs.conversational_ai.twilio.register_call(
        agent_id=AGENT_ID,
        from_number=from_number,
        to_number=to_number,
        direction="outbound",
    )
    return Response(content=twiml, media_type="application/xml")

Personnaliser les conversations

Utilisez le paramètre conversation_initiation_client_data pour transmettre des variables dynamiques et remplacer la configuration de l’agent :

{
  "agent_id": "your-agent-id",
  "from_number": "+1234567890",
  "to_number": "+0987654321",
  "direction": "inbound",
  "conversation_initiation_client_data": {
    "dynamic_variables": {
      "customer_name": "John Doe",
      "account_type": "premium",
      "order_id": "ORD-12345"
    }
  }
}

Configuration Twilio

Configurez votre numéro de téléphone Twilio pour qu’il pointe vers votre serveur :

1

Créer une URL publique

Pour le développement local, utilisez ngrok afin d’exposer votre serveur :

ngrok http 8000

2

Configurer votre numéro Twilio

1. Accédez à la console Twilio
2. Accédez à Phone Numbers > Manage > Active numbers
3. Sélectionnez votre numéro de téléphone
4. Sous « Voice Configuration », définissez l’URL du webhook sur le point de terminaison de votre serveur, par exemple https://your-ngrok-url.ngrok.app/twilio/inbound
5. Définissez la méthode HTTP sur POST

Limites

Lorsque vous utilisez le point de terminaison d’enregistrement d’appel au lieu de l’intégration native :

• Aucun transfert d’appel : la fonctionnalité de transfert n’est pas disponible, car ElevenLabs n’a pas accès à vos identifiants Twilio
• Configuration manuelle : vous devez configurer les formats audio et gérer vous-même le routage TwiML
• Aucune importation dans le dashboard : les numéros de téléphone enregistrés de cette manière n’apparaissent pas dans le dashboard des numéros de téléphone ElevenLabs