Personalizacja Twilio

Skonfiguruj personalizację przychodzących połączeń Twilio za pomocą webhooków.

Omówienie

Gdy odbierasz połączenia przychodzące Twilio, możesz dynamicznie pobierać dane inicjujące rozmowę przez webhook. Pozwala to dostosować działanie agenta na podstawie informacji o rozmówcy i innych danych kontekstowych.

Informacje o tym, kiedy webhook jest wywoływany i jak wygląda żądanie, znajdziesz w sekcji Webhooki inicjujące rozmowę.

Jak to działa

Gdy nadejdzie połączenie Twilio, ElevenAgents wywoła webhook pod wskazanym adresem endpointu, przekazując jako argumenty informacje o połączeniu (caller_id, agent_id, called_number, call_sid, conversation_id)
Twój webhook zwraca dane klienta inicjujące rozmowę, w tym zmienne dynamiczne i nadpisania (przykład poniżej)
Dane są używane do rozpoczęcia rozmowy

System wykorzystuje czas łączenia/wydzwaniania Twilio do równoległego pobrania danych webhooka, zapewniając płynne działanie, w którym:

Użytkownicy słyszą oczekiwany dźwięk łączenia telefonicznego
Równolegle ElevenAgents pobiera potrzebne dane webhooka
Rozmowa rozpoczyna się z pobranymi danymi, gdy połączenie audio zostanie nawiązane

Konfiguracja

Skonfiguruj szczegóły webhooka

Na stronie ustawień ElevenAgents skonfiguruj adres URL webhooka i dodaj sekrety potrzebne do uwierzytelniania.

Kliknij webhook, aby zmienić, które sekrety są wysyłane w nagłówkach.

Włącz pobieranie danych inicjujących rozmowę

Na karcie „Security” na stronie agenta włącz pobieranie danych inicjujących rozmowę dla przychodzących połączeń Twilio i zdefiniuj pola, które można nadpisywać.

Zaimplementuj endpoint webhooka do odbierania danych Twilio

Webhook otrzyma żądanie POST z następującymi parametrami:

Parametr	Typ	Opis
`caller_id`	string	Numer telefonu rozmówcy
`agent_id`	string	ID agenta odbierającego połączenie
`called_number`	string	Numer Twilio, na który zadzwoniono
`call_sid`	string	Unikalny identyfikator połączenia Twilio
`conversation_id`	string	Identyfikator rozmowy ElevenLabs

Zwróć dane klienta inicjujące rozmowę

Twój webhook musi zwrócić odpowiedź JSON zawierającą dane inicjujące dla agenta.

Pole dynamic_variables musi zawierać wszystkie zmienne dynamiczne zdefiniowane dla agenta. Nadpisania są natomiast całkowicie opcjonalne. Więcej informacji o zmiennych dynamicznych i nadpisaniach znajdziesz w dokumentacji zmiennych dynamicznych i nadpisań.

Przykładowa odpowiedź może wyglądać tak:

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "The customer's bank account balance is $100. They are based in San Francisco.",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "Hi, how can I help you today?",
      "language": "en"
    },
    "tts": {
      "voice_id": "new-voice-id"
    },
    "conversation": {
      "text_only": false
    }
  },
  "dynamic_variables": {
    "customer_name": "John Doe",
    "account_status": "premium",
    "last_interaction": "2026-01-15"
  },
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

ElevenAgents użyje zmiennych dynamicznych do uzupełnienia danych inicjujących rozmowę, a rozmowa rozpocznie się płynnie.

Upewnij się, że webhook odpowiada w rozsądnym czasie, aby uniknąć opóźnień w obsłudze połączenia.

Zabezpieczenia

Używaj tylko endpointów HTTPS
Zaimplementuj uwierzytelnianie za pomocą nagłówków żądań
Przechowuj poufne wartości jako sekrety przez menedżer sekretów ElevenLabs
Sprawdzaj parametry przychodzących żądań