Doorverbinden naar nummer
Verbind gesprekken door naar externe telefoonnummers of SIP-URI’s op basis van gedefinieerde voorwaarden.
Overzicht
Met de systeemtool transfer_to_number kan een ElevenLabs-agent het lopende gesprek doorverbinden naar een opgegeven telefoonnummer of SIP-URI wanneer aan bepaalde voorwaarden is voldaan. Zo kunnen agents complexe problemen, specifieke verzoeken of situaties die menselijke tussenkomst vereisen, overdragen aan een live operator.
Deze functie ondersteunt doorverbinden via telefoonnummers. Wanneer de tool wordt geactiveerd, kan de agent de gebruiker een bericht geven tijdens het wachten en een afzonderlijk bericht met een samenvatting van de situatie voor de menselijke operator die het gesprek ontvangt.
De systeemtool transfer_to_number is alleen beschikbaar voor telefoongesprekken en niet in de
chatwidget.
Doorverbindingsregels
-
Een doorverbindingsregel geeft aan wanneer de agent moet doorverbinden en hoe elke telefoonprovider de doorverbinding uitvoert.
-
Elke regel heeft één voorwaarde en één configuratie per provider.
-
De tool kan worden geconfigureerd met meerdere doorverbindingsregels.
-
Tijdens een gesprek ziet de agent alleen de regels voor de provider waarop het gesprek actief is.
-
Voorwaarde: gewone tekst die dynamische variabelen ondersteunt en beschrijft wanneer deze doorverbindingsmethode moet worden gebruikt, bijvoorbeeld “Beller vraagt naar facturering”
-
Providerconfiguratie is een lijst met maximaal één item per provider. Als een regel geen item voor een provider heeft, bestaat deze niet voor gesprekken via die provider.
Doorverbindingstypen
- Conferentie: Standaardgedrag waarbij de bestemming wordt gebeld en de beller en menselijke operator in een conferentieruimte worden geplaatst
- SIP REFER: Gebruikt het SIP REFER-protocol om gesprekken rechtstreeks naar de bestemming door te verbinden. Werkt met zowel telefoonnummers als SIP-URI’s, maar is alleen beschikbaar wanneer tijdens het gesprek het SIP-protocol wordt gebruikt en vereist dat je SIP Trunk doorverbinden via SIP REFER toestaat
Doorverbindingsstrategieën
- Koud: Verbindt het gesprek rechtstreeks door zonder een samenvatting van de situatie voor de menselijke operator die het gesprek ontvangt.
- Warm: Verbindt het gesprek door met een samenvatting van de situatie voor de menselijke operator die het gesprek ontvangt.
Beschikbare doorverbindingsopties per provider
SIP
- Koude conferentie: (
sip_cold_conference_transfer) De ontvanger wordt zonder aankondiging aan het gesprek toegevoegd- Ondersteunt alleen telefoonnummers
- SIP REFER: (
sip_cold_refer_transfer) Het gesprek wordt zonder aankondiging via SIP REFER aan de bestemming overgedragen- Ondersteunt zowel telefoonnummers als SIP-URI’s
- Aangepaste SIP-headers, statische of dynamische variabelen
- UUI (User-to-User Information) om context mee te sturen, zoals een CRM-ID
- Beltoon afspelen (standaard ingeschakeld): de beller hoort een beltoon terwijl de doorverbinding wordt voltooid. Schakel dit uit om stilte te laten horen.
Twilio
- Koud: (
twilio_cold_blind_transfer) De ontvanger wordt zonder aankondiging aan het gesprek toegevoegd- Ondersteunt alleen telefoonnummers
- Cijfers na het kiezen: DTMF-tonen die worden verzonden nadat het gesprek is verbonden
- Warm: (
twilio_warm_conference_transfer) De ontvanger hoort de samenvatting van de agent en wordt daarna verbonden- Ondersteunt alleen telefoonnummers
- Cijfers na het kiezen: DTMF-tonen die worden verzonden nadat het gesprek is verbonden
Exotel
- Koud: (
exotel_warm_transfer) De ontvanger wordt zonder aankondiging aan het gesprek toegevoegd- Ondersteunt alleen telefoonnummers
- Warm: (
twilio_warm_conference_transfer) De ontvanger hoort de samenvatting van de agent en wordt daarna verbonden- Ondersteunt alleen telefoonnummers
Aanvullende configuratie in detail
Cijfers na het kiezen
- DTMF-tonen die worden verzonden nadat het gesprek is verbonden, bijvoorbeeld
w1W234 - Elke
wis een pauze van 0,5 s - Elke
Wis een pauze van 1 s
Aangepaste SIP-headers
Extra SIP-headers die met de doorverbinding worden verzonden, zodat het ontvangende systeem (PBX, contactcenter) je gegevens ontvangt, bijvoorbeeld X-Customer-ID: 12345.
- Waar: alleen SIP trunk, SIP REFER.
- Limieten:
- Maximaal 20 headers per doorverbinding.
- Naam: maximaal 64 tekens. Alleen letters, cijfers en enkele koppeltekens
Systeemheaders X-Conversation-ID en X-Caller-ID worden automatisch opgenomen door ElevenLabs en
overschrijven aangepaste headers met dezelfde namen (hoofdletterongevoelig).
UUI (User-to-User Information)
Configureer UUI per doorverbindingsregel met het object uui:
data: De te verzenden payload als platte tekst. ElevenLabs codeert deze hexadecimaal en voegt;encoding=hextoe. Kan statische tekst zijn of dynamische variabelen bevatten. Maximaal 256 bytes (UTF-8), afgedwongen nadat dynamische variabelen zijn vervangen — voor gewone ASCII zijn dat 256 tekens, minder voor tekens van meerdere bytes.protocol_discriminator: Eén hexadecimaal octet, bijvoorbeeld04. Neem dit op voor platforms die het eerste octet van de payload verwijderen; laat het weg voor platforms die de payload ongewijzigd doorgeven.protocol_discriminator_mode:prefix(standaard) plaatst het octet ervoor, wat04<hex>;encoding=hexoplevert.pd_parametervoegt het toe als afzonderlijke parameter, wat<hex>;pd=04;encoding=hexoplevert.
Talkdesk geeft de waarde ongewijzigd door, dus laat de protocol discriminator weg. Genesys Cloud
verwijdert het eerste octet van de payload, tenzij er een discriminator aanwezig is, dus neem een
protocol_discriminator op. Zie Genesys UUI-gegevensindelingen
.
De limiet van 256 bytes geldt nadat dynamische variabelen zijn vervangen. Geef identifiers of korte codes door, zoals een account-ID, en geen vrije tekst zoals een volledige gesprekssamenvatting; die overschrijdt de limiet en wordt niet opgenomen in de doorverbinding.
Er is geen configuratie vereist om UUI te ontvangen bij inkomende SIP-gesprekken. Wanneer een inkomende INVITE een User-to-User-header bevat, wordt de waarde ervan aan de agent beschikbaar gesteld als de dynamische variabelen {{sip_uui_raw}} en {{sip_uui_data}}. Zie de SIP-referentie.
Doorverbinden naar een mens inschakelen
Voeg de doorverbindingstool toe
Schakel doorverbinden naar een mens in door de systeemtool transfer_to_number te selecteren in de configuratie van je agent op het tabblad Agent. Kies “Doorverbinden naar mens” wanneer je een tool toevoegt.
Toolbeschrijving configureren (optioneel)
Je kunt een aangepaste beschrijving opgeven om het LLM te sturen wanneer een doorverbinding moet worden geactiveerd. Als je dit leeg laat, wordt een standaardbeschrijving gebruikt met de doorverbindingsregels voor de telefonieprovider van het huidige gesprek.
(Alleen verouderde configuraties) Overschakelen naar doorverbindingsregels per provider
Sla deze stap over, tenzij de tool nog verouderde doorverbindingen gebruikt. Selecteer onder Regels voor doorverbinden naar een mens Per provider. Met regels per provider kun je configureren hoe elke doorverbinding werkt voor elke telefonieprovider die je agent gebruikt (Twilio, SIP trunk, Exotel), en krijg je alle nieuwe doorverbindingsopties.
Je verouderde doorverbindingen worden bij het overschakelen omgezet in gelijkwaardige regels per provider. Er verandert niets aan het gedrag van bestaande gesprekken totdat je de regels bewerkt.
Een tool gebruikt óf verouderde doorverbindingen óf regels per provider, nooit beide. De verouderde configuratie past één doorverbindingstype toe voor elke provider en krijgt geen nieuwe providers of doorverbindingsopties.
Voeg een regel en de bijbehorende voorwaarde toe
Klik op Regel toevoegen en vul de Voorwaarde in: een natuurlijke beschrijving van wanneer de agent deze doorverbinding moet gebruiken (bijvoorbeeld “Gebruiker vraagt expliciet om met een mens te spreken” of “Gebruiker moet gevoelige accountgegevens bijwerken”). De voorwaarde kan dynamische variabelen bevatten.
Het LLM gebruikt deze voorwaarden samen met de toolbeschrijving om te bepalen wanneer en waarnaar moet worden doorverbonden. Wanneer de agent een bestemming kiest die niet bestaat en er slechts één is geconfigureerd, wordt die gebruikt; bij meerdere bestemmingen wordt de doorverbinding geweigerd en krijgt de agent de geldige opties te zien.
Voeg een configuratie toe voor elke telefonieprovider
Voeg onder Providerconfiguratie één item toe voor elke telefonieprovider waarop de agent gesprekken kan ontvangen. Een nieuwe regel begint met de providers van de telefoonnummers die aan de agent zijn toegewezen. Klik op + om er meer toe te voegen.
Elke provider kan één keer per regel worden geconfigureerd.
Stel vervolgens de bestemming in:
- Bestemmingstype: Telefoonnummer of SIP-URI. Alleen SIP REFER kan doorverbinden naar een SIP-URI. Elk ander doorverbindingstype gebruikt een telefoonnummer.
- Telefoonnummer / SIP-URI: het doel in de juiste indeling, rechtstreeks ingevoerd of als dynamische variabele (bijvoorbeeld
{{phone_number}}):- Telefoonnummers: E.164-indeling (bijv. +12125551234)
- SIP-URI’s: SIP-indeling (bijv. sip:1234567890@example.com)
Een regel bestaat alleen voor gesprekken waarvan de provider een configuratie heeft. Als een gesprek via een SIP trunk-nummer loopt en de regel alleen een Twilio-configuratie heeft, kan de agent die doorverbinding niet aanbieden tijdens het gesprek.
SIP REFER-doorverbindingen vereisen het SIP-protocol tijdens het gesprek en je SIP Trunk moet doorverbinden via SIP REFER toestaan.
Twee regels kunnen niet naar dezelfde bestemming verwijzen bij dezelfde provider, omdat de agent ze dan niet van elkaar kan onderscheiden. Je kunt de voorwaarde altijd aanpassen om beide gevallen op te nemen.
API-implementatie
Je kunt de systeemtool transfer_to_number configureren wanneer je via de API een agent maakt of bijwerkt (Agent maken, Agent bijwerken). Met de tool kun je berichten opgeven voor zowel de client (gebruiker die wordt doorverbonden) als de agent (menselijke operator die het gesprek ontvangt).
Verouderde configuratie
Documentatie over verouderde overdrachten
Overdrachttypen
Het systeem ondersteunt drie typen overdrachten:
- Conferentieoverdracht: Standaardgedrag waarbij de bestemming wordt gebeld en de deelnemer aan een conferentieruimte wordt toegevoegd. Vervolgens wordt de AI-agent verwijderd, zodat alleen de beller en de overgedragen deelnemer overblijven. Bij gebruik van de native Twilio integration wordt een warm-overdrachtsbericht (
agent_message) ondersteund dat aan de menselijke operator wordt voorgelezen. - Blinde overdracht: Draagt het gesprek rechtstreeks over naar de bestemming zonder een warm-overdrachtsbericht voor de menselijke operator. Behoudt de oorspronkelijke beller-ID. Alleen beschikbaar wanneer het telefoonnummer van de agent is geïmporteerd via de native Twilio integration.
- SIP REFER-overdracht: Gebruikt het SIP REFER-protocol om gesprekken rechtstreeks naar de bestemming over te dragen. Werkt met zowel telefoonnummers als SIP-URI’s, maar is alleen beschikbaar wanneer tijdens het gesprek het SIP-protocol wordt gebruikt en vereist dat je SIP Trunk overdracht via SIP REFER toestaat. Ondersteunt geen warm-overdrachtsberichten.
Warm-overdrachtsberichten (agent_message) zijn alleen beschikbaar wanneer het telefoonnummer van de agent
is geïmporteerd via de native Twilio
integration. Op SIP gebaseerde
overdrachten ondersteunen geen warm-overdrachtsberichten.
Blinde overdrachten zijn alleen beschikbaar wanneer het telefoonnummer van de agent is geïmporteerd via de native
Twilio integration en
moeten momenteel worden geconfigureerd via de JSON-editor in de UI. Selecteer “Edit as JSON” in de configuratie van de overdrachtstool
en stel "transfer_type": "blind" in voor de gewenste overdrachtsregel.
Doel: Gesprekken naadloos doorverbinden met menselijke medewerkers wanneer AI-ondersteuning niet toereikend is.
Triggervoorwaarden: De LLM moet deze tool aanroepen wanneer:
- Er complexe kwesties zijn die menselijk oordeel vereisen
- De gebruiker expliciet om menselijke hulp vraagt
- De AI voor het specifieke verzoek de grenzen van zijn mogelijkheden bereikt
- Escalatieprotocollen worden geactiveerd
Parameters:
reason(string, optioneel): De reden voor de doorverbindingtransfer_number(string, vereist): Het telefoonnummer waarnaar wordt doorverbonden (moet overeenkomen met geconfigureerde nummers)client_message(string, vereist): Bericht dat aan de klant wordt voorgelezen tijdens het wachten op de doorverbindingagent_message(string, vereist): Bericht voor de menselijke medewerker die het gesprek ontvangt
Indeling van de functieaanroep:
Implementatie: Configureer telefoonnummers en voorwaarden voor doorverbinden. Definieer berichten voor zowel de klant als de menselijke medewerker die het gesprek ontvangt. Werkt met zowel Twilio als SIP trunking.
Nummers waarnaar kan worden overgedragen
Overdracht naar een medewerker ondersteunt overdracht naar externe telefoonnummers met zowel SIP trunking als Twilio-telefoonnummers.
Overdracht naar een medewerker inschakelen
Overdracht naar een medewerker wordt geconfigureerd met de systeemtool transfer_to_number.
Voeg de overdrachtstool toe
Schakel overdracht naar een medewerker in door de systeemtool transfer_to_number te selecteren in de configuratie van je agent op het tabblad Agent. Kies “Transfer to Human” wanneer je een tool toevoegt.

Toolbeschrijving configureren (optioneel)
Je kunt een aangepaste beschrijving opgeven om het LLM te helpen bepalen wanneer een overdracht moet worden gestart. Als je dit leeg laat, wordt een standaardbeschrijving gebruikt die de gedefinieerde overdrachtsregels omvat.

Overdrachtsregels definiëren
Configureer de specifieke regels voor overdracht naar telefoonnummers of SIP-URI’s. Geef voor elke regel het volgende op:
- Overdrachtstype: Kies tussen de overdrachtsmethoden Conferentie (standaard), Blind of SIP REFER
- Nummer type: Selecteer Telefoon voor gewone telefoonnummers of SIP URI voor SIP-adressen
- Telefoonnummer/SIP URI: De doelbestemming in de juiste indeling:
- Telefoonnummers: E.164-indeling (bijv. +12125551234)
- SIP-URI’s: SIP-indeling (bijv. sip:1234567890@example.com)
- Voorwaarde: Een beschrijving in natuurlijke taal van de omstandigheden waaronder de overdracht moet plaatsvinden (bijv. “Gebruiker vraagt expliciet om met een medewerker te spreken”, “Gebruiker moet gevoelige accountinformatie bijwerken”).
Het LLM gebruikt deze voorwaarden samen met de toolbeschrijving om te bepalen wanneer en naar welke bestemming moet worden overgedragen.
SIP REFER-overdrachten vereisen het SIP-protocol tijdens het gesprek en je SIP Trunk moet overdracht via SIP REFER toestaan. Alleen SIP REFER ondersteunt overdracht naar een SIP URI.
Blinde overdrachten zijn alleen beschikbaar wanneer het telefoonnummer van de agent is geïmporteerd via de native Twilio integration en moeten via de JSON-editor worden geconfigureerd. De oorspronkelijke beller-ID blijft behouden, maar er wordt geen warm-overdrachtsbericht naar de menselijke operator gestuurd.

Zorg dat bestemmingen de juiste indeling hebben:
- Telefoonnummers: E.164-indeling en gekoppeld aan een correct geconfigureerd account
- SIP-URI’s: Geldige SIP-indeling (sip:user@domain of sips:user@domain)
Aangepaste SIP REFER-headers configureren (optioneel)
Wanneer je SIP REFER-overdrachten gebruikt, kun je aangepaste SIP-headers opnemen om aanvullende informatie door te geven aan het ontvangende systeem.
Geef voor elke aangepaste header het volgende op:
- Headernaam: De naam van de SIP-header (bijv.
X-Customer-ID,X-Priority) - Headerwaarde: De headerwaarde, die statische tekst kan zijn of dynamische variabelen kan bevatten
Aangepaste SIP REFER-headers worden alleen opgenomen bij SIP REFER-overdrachten. Conferentieoverdrachten ondersteunen geen aangepaste headers.
Systeemheaders X-Conversation-ID en X-Caller-ID worden automatisch door ElevenLabs toegevoegd en overschrijven alle aangepaste headers met dezelfde namen (niet hoofdlettergevoelig).
User-to-User Information (UUI) configureren (optioneel)
SIP REFER-overdrachten kunnen User-to-User Information (UUI) bevatten: een kleine payload die aan het ontvangende platform (bijvoorbeeld Talkdesk of Genesys Cloud) wordt geleverd in de parameter User-to-User van de header Refer-To. UUI wordt alleen verzonden bij SIP REFER-overdrachten naar een SIP URI-bestemming; bestemmingen met telefoonnummers (tel:) bevatten dit niet.
Configureer UUI per overdrachtsregel met het object uui:
data: De te verzenden payload als platte tekst. ElevenLabs codeert deze hexadecimaal en voegt;encoding=hextoe. Kan statische tekst zijn of dynamische variabelen bevatten. Maximaal 256 bytes (UTF-8), afgedwongen nadat dynamische variabelen zijn vervangen — voor gewone ASCII zijn dat 256 tekens, minder voor tekens van meerdere bytes.protocol_discriminator: Eén hexadecimaal octet, bijvoorbeeld04. Neem dit op voor platforms die het eerste octet van de payload verwijderen; laat het weg voor platforms die de payload ongewijzigd doorgeven.protocol_discriminator_mode:prefix(standaard) voegt het octet vooraf toe, wat resulteert in04<hex>;encoding=hex.pd_parametervoegt dit toe als aparte parameter, wat resulteert in<hex>;pd=04;encoding=hex.
Talkdesk geeft de waarde ongewijzigd door, dus laat de protocol discriminator weg. Genesys Cloud verwijdert het eerste octet van de payload, tenzij er een discriminator aanwezig is, dus neem een protocol_discriminator op. Zie Genesys UUI data formats.
De limiet van 256 bytes geldt nadat dynamische variabelen zijn vervangen. Geef identifiers of korte codes door, zoals een account-ID, en geen vrije tekst zoals een volledige gesprekssamenvatting, want die overschrijdt de limiet en wordt uit de overdracht verwijderd.
Voor het ontvangen van UUI bij inkomende SIP-gesprekken is geen configuratie vereist. Wanneer een inkomende INVITE een header User-to-User bevat, wordt de waarde ervan beschikbaar gesteld aan de agent als de dynamische variabelen {{sip_uui_raw}} en {{sip_uui_data}}. Zie de SIP-referentie.
Nabeltonen configureren (optioneel)
Nabeltonen zijn DTMF-tonen die worden doorgegeven nadat de telefoon verbinding heeft gemaakt met de overdrachtsbestemming. Dit is handig voor het automatisch invoeren van extensies of navigeren door IVR-menu’s (Interactive Voice Response).
Voor elke overdrachtsregel kun je een tekenreeks post_dial_digits opgeven die het volgende bevat:
- Cijfers (
0-9): Standaard DTMF-tonen w: Vertraging van 0,5 secondeW: Vertraging van 1 seconde*en#: Speciale DTMF-tonen
ww1234 wacht bijvoorbeeld 1 seconde nadat het gesprek verbinding heeft gemaakt en kiest vervolgens extensie 1234.
Nabeltonen zijn alleen beschikbaar wanneer het telefoonnummer van de agent (het nummer dat de overdracht start) is geïmporteerd via de native Twilio integration. Het bestemmingsnummer kan elk telefoonnummer zijn.
Nabeltonen worden alleen ondersteund voor de overdrachtstypen conferentie en blind. SIP REFER-overdrachten ondersteunen geen nabeltonen.
API-implementatie
Je kunt de systeemtool transfer_to_number configureren wanneer je een agent maakt of bijwerkt via de API (Agent maken, Agent bijwerken). Met de tool kun je berichten opgeven voor zowel de client (gebruiker die wordt overgedragen) als de agent (menselijke operator die het gesprek ontvangt).