Twilio-Anrufe registrieren

Wann Sie welchen Ansatz verwenden sollten

Bevor Sie beginnen, sollten Sie die Unterschiede zwischen der nativen Integration und dem Ansatz zum Registrieren von Anrufen kennen:

Überblick

Der Endpunkt zum Registrieren von Anrufen ermöglicht Ihnen, Ihre eigene Twilio-Infrastruktur zu verwenden und gleichzeitig ElevenLabs-Agenten für Gespräche einzusetzen. Statt Ihre Twilio-Nummer in ElevenLabs zu importieren, behalten Sie die volle Kontrolle über Ihre Twilio-Einrichtung und verwenden die ElevenLabs API, um Anrufe zu registrieren und TwiML zu erhalten, um sie mit Ihren Agenten zu verbinden.

Dieser Ansatz ist ideal, wenn Sie:

• Ihre bestehende Twilio-Infrastruktur und Workflows beibehalten müssen
• Programmatische Kontrolle über Anrufrouting und -verarbeitung wünschen
• Komplexe Anrufabläufe haben, die eigene Twilio-Logik erfordern, bevor ein Agent verbunden wird
• ElevenLabs-Agenten in ein bestehendes Telefonsystem integrieren müssen

So funktioniert es

1. Ihr Server empfängt einen eingehenden Anruf oder initiiert über Twilio einen ausgehenden Anruf
2. Ihr Server ruft den ElevenLabs-Endpunkt zum Registrieren von Anrufen mit Agenten- und Anrufdetails auf
3. ElevenLabs gibt TwiML zurück, das den Anruf über WebSocket mit Ihrem Agenten verbindet
4. Sie geben diese TwiML an Twilio zurück, um die Verbindung herzustellen

Voraussetzungen

• Ein ElevenLabs-Konto
• Ein konfigurierter ElevenLabs Conversational Agent (hier erstellen)
• Ein Twilio-Konto mit einer aktiven Telefonnummer
• Ihr Agent ist mit dem Audioformat μ-law 8000 Hz konfiguriert (siehe Agentenkonfiguration)

Agentenkonfiguration

Konfigurieren Sie Ihren Agenten vor der Verwendung des Endpunkts zum Registrieren von Anrufen für das von Twilio unterstützte korrekte Audioformat.

1

TTS-Ausgabe konfigurieren

1. Navigieren Sie zu Ihren Agenteneinstellungen
2. Öffnen Sie den Bereich Voice
3. Wählen Sie im Dropdown-Menü „μ-law 8000 Hz“ aus

2

Eingabeformat festlegen

1. Navigieren Sie zu Ihren Agenteneinstellungen
2. Öffnen Sie den Bereich Advanced
3. Wählen Sie für das Eingabeformat „μ-law 8000 Hz“ aus

API-Referenz

Der Endpunkt zum Registrieren von Anrufen akzeptiert die folgenden Parameter:

Der Endpunkt gibt TwiML zurück, das Sie direkt an Twilio übergeben sollten.

Implementierung

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)

Ausgehende Anrufe

Für ausgehende Anrufe initiieren Sie den Anruf über Twilio und verweisen die Webhook-URL auf Ihren Server, der den Anruf dann bei ElevenLabs registriert:

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")

Gespräche personalisieren

Verwenden Sie den Parameter conversation_initiation_client_data, um dynamische Variablen zu übergeben und die Agentenkonfiguration zu überschreiben:

{
  "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"
    }
  }
}

Twilio-Konfiguration

Konfigurieren Sie Ihre Twilio-Telefonnummer so, dass sie auf Ihren Server verweist:

1

Öffentliche URL erstellen

Verwenden Sie für die lokale Entwicklung ngrok, um Ihren Server öffentlich verfügbar zu machen:

ngrok http 8000

2

Ihre Twilio-Nummer konfigurieren

1. Öffnen Sie die Twilio Console
2. Navigieren Sie zu Phone Numbers > Manage > Active numbers
3. Wählen Sie Ihre Telefonnummer aus
4. Legen Sie unter „Voice Configuration“ die Webhook-URL auf Ihren Server-Endpunkt fest (z. B. https://your-ngrok-url.ngrok.app/twilio/inbound)
5. Setzen Sie die HTTP-Methode auf POST

Einschränkungen

Bei Verwendung des Endpunkts zum Registrieren von Anrufen statt der nativen Integration:

• Keine Anrufweiterleitungen: Die Weiterleitungsfunktion ist nicht verfügbar, da ElevenLabs keinen Zugriff auf Ihre Twilio-Zugangsdaten hat
• Manuelle Konfiguration: Sie müssen Audioformate konfigurieren und das TwiML-Routing selbst verwalten
• Kein Dashboard-Import: Auf diese Weise registrierte Telefonnummern erscheinen nicht im ElevenLabs-Dashboard für Telefonnummern