Hoppa till navigering

Överför till nummer

Överför samtal till externa telefonnummer eller SIP-URI:er baserat på definierade villkor.

Översikt

Systemverktyget transfer_to_number låter en ElevenLabs-agent överföra det pågående samtalet till ett angivet telefonnummer eller en SIP-URI när vissa villkor uppfylls. Det gör att agenter kan lämna över komplexa ärenden, specifika förfrågningar eller situationer som kräver mänsklig hjälp till en liveoperatör.

Funktionen har stöd för överföringar via telefonnummer. När den aktiveras kan agenten ge användaren ett meddelande medan de väntar och ett separat meddelande som sammanfattar situationen för den mänskliga operatör som tar emot samtalet.

Systemverktyget transfer_to_number är endast tillgängligt för telefonsamtal och inte i chattwidgeten.

Regler för överföring

  • En överföringsregel anger när agenten ska överföra och hur varje telefonileverantör genomför överföringen.

  • Varje regel har ett villkor och en konfiguration per leverantör.

  • Verktyget kan konfigureras med flera överföringsregler.

  • Under ett samtal ser agenten endast reglerna för den leverantör som samtalet körs via.

  • Villkor: Oformaterad text med stöd för dynamiska variabler som beskriver när den här överföringsmetoden ska användas, till exempel “Uppringaren frågar om fakturering”

  • Leverantörskonfiguration är en lista med högst en post per leverantör. Om en regel saknar en post för en leverantör finns den inte för den leverantörens samtal.

Överföringstyper

  • Konferens: Standardbeteendet som ringer upp destinationen och placerar uppringaren och den mänskliga operatören i ett konferensrum
  • SIP REFER: Använder SIP REFER-protokollet för att överföra samtal direkt till destinationen. Fungerar med både telefonnummer och SIP-URI:er, men är endast tillgängligt när SIP-protokollet används under samtalet och kräver att din SIP Trunk tillåter överföring via SIP REFER

Överföringsstrategier

  • Kall: Överför samtalet direkt utan en sammanfattning av situationen till den mänskliga operatör som tar emot samtalet.
  • Varm: Överför samtalet med en sammanfattning av situationen för den mänskliga operatör som tar emot samtalet.

Tillgängliga överföringsalternativ per leverantör

SIP

  • Kall konferens: (sip_cold_conference_transfer) Mottagaren läggs till i samtalet utan något meddelande
    • Har endast stöd för telefonnummer
  • SIP REFER: (sip_cold_refer_transfer) Samtalet överlämnas till destinationen via SIP REFER utan något meddelande
    • Har stöd för både telefonnummer och SIP-URI:er
    • Anpassade SIP-rubriker, statiska eller dynamiska variabler
    • UUI (User-to-User Information) för att överföra kontext, till exempel ett CRM-ID
    • Spela upp ringsignal (aktiverat som standard): uppringaren hör en ringsignal medan överföringen slutförs. Stäng av det så hör de tystnad.

Twilio

  • Kall: (twilio_cold_blind_transfer) Mottagaren läggs till i samtalet utan något meddelande
    • Har endast stöd för telefonnummer
    • Siffror efter uppringning: DTMF-toner som skickas när samtalet ansluts
  • Varm: (twilio_warm_conference_transfer) Mottagaren hör agentens sammanfattning och ansluts sedan
    • Har endast stöd för telefonnummer
    • Siffror efter uppringning: DTMF-toner som skickas när samtalet ansluts

Exotel

  • Kall: (exotel_warm_transfer) Mottagaren läggs till i samtalet utan något meddelande
    • Har endast stöd för telefonnummer
  • Varm: (twilio_warm_conference_transfer) Mottagaren hör agentens sammanfattning och ansluts sedan
    • Har endast stöd för telefonnummer

Ytterligare konfiguration i detalj

Siffror efter uppringning

  • DTMF-toner som skickas när samtalet ansluts, till exempel w1W234
  • Varje w är en paus på 0,5 s
  • Varje W är en paus på 1 s

Anpassade SIP-rubriker

Extra SIP-rubriker som skickas med överföringen, så att det mottagande systemet (PBX, kontaktcenter) får dina data, till exempel X-Customer-ID: 12345.

  • Var: Endast SIP trunk och SIP REFER.
  • Begränsningar:
    • Högst 20 rubriker per överföring.
    • Namn: upp till 64 tecken. Endast bokstäver, siffror och enstaka bindestreck

Systemrubrikerna X-Conversation-ID och X-Caller-ID inkluderas automatiskt av ElevenLabs och åsidosätter alla anpassade rubriker med samma namn (skiftlägesokänsligt).

UUI (User-to-User Information)

Konfigurera UUI per överföringsregel med objektet uui:

  • data: Nyttolasten som ska skickas, som klartext. ElevenLabs hexkodar den och lägger till ;encoding=hex. Kan vara statisk text eller innehålla dynamiska variabler. Högst 256 byte (UTF-8), vilket tillämpas efter att dynamiska variabler har ersatts — för vanlig ASCII är det 256 tecken, färre för flerbytetecken.
  • protocol_discriminator: En enda hexoktet, till exempel 04. Ange den för plattformar som tar bort nyttolastens första oktet. Utelämna den för plattformar som skickar vidare nyttolasten.
  • protocol_discriminator_mode: prefix (standard) lägger till okteten först och ger 04<hex>;encoding=hex. pd_parameter lägger till den som en separat parameter och ger <hex>;pd=04;encoding=hex.

Talkdesk skickar vidare värdet oförändrat, så utelämna protokolldiskriminatorn. Genesys Cloud tar bort nyttolastens första oktet om ingen diskriminator finns, så inkludera en protocol_discriminator. Se Genesys UUI-dataformat.

Gränsen på 256 byte gäller efter att dynamiska variabler har ersatts. Skicka identifierare eller korta koder, till exempel ett konto-ID, inte fritext som en fullständig samtalssammanfattning, eftersom den överskrider gränsen och tas bort från överföringen.

För att ta emot UUI på inkommande SIP-samtal krävs ingen konfiguration. När en inkommande INVITE innehåller en User-to-User-rubrik exponeras dess värde för agenten som de dynamiska variablerna {{sip_uui_raw}} och {{sip_uui_data}}. Se SIP-referensen.

Aktivera överföring till människa

1

Lägg till överföringsverktyget

Aktivera överföring till människa genom att välja systemverktyget transfer_to_number i agentens konfiguration på fliken Agent. Välj “Överför till människa” när du lägger till ett verktyg.

2

Konfigurera verktygsbeskrivning (valfritt)

Du kan ange en anpassad beskrivning som vägleder LLM:en om när den ska utlösa en överföring. Om fältet lämnas tomt används en standardbeskrivning som listar överföringsreglerna för den aktuella telefonileverantören för samtalet.

3

(Endast äldre konfigurationer) Byt till överföringsregler per leverantör

Hoppa över det här steget om verktyget inte fortfarande använder äldre överföringar. Under Regler för överföring till människa väljer du Per leverantör. Regler per leverantör låter dig konfigurera hur varje överföring fungerar hos varje telefonileverantör som agenten använder (Twilio, SIP trunk, Exotel), och ger tillgång till alla nya överföringsalternativ.

Dina äldre överföringar omvandlas till motsvarande regler per leverantör när du byter. Inget förändras i hur befintliga samtal fungerar förrän du redigerar reglerna.

Ett verktyg använder antingen äldre överföringar eller regler per leverantör, aldrig båda. Den äldre konfigurationen tillämpar en överföringstyp hos alla leverantörer och får inte nya leverantörer eller överföringsalternativ.

4

Lägg till en regel och dess villkor

Klicka på Lägg till regel och fyll i Villkor: en beskrivning på naturligt språk av när agenten ska använda den här överföringen (till exempel “Användaren ber uttryckligen om att få prata med en människa” eller “Användaren behöver uppdatera känslig kontoinformation”). Villkoret kan innehålla dynamiska variabler.

LLM:en använder dessa villkor tillsammans med verktygsbeskrivningen för att avgöra när och vart överföringen ska ske. När agenten väljer en destination som inte finns och endast en destination är konfigurerad används den. Om det finns flera avvisas överföringen och agenten får information om de giltiga alternativen.

5

Lägg till en konfiguration för varje telefonileverantör

Under Leverantörskonfiguration lägger du till en post för varje telefonileverantör som agenten kan ta emot samtal via. En ny regel börjar med leverantörerna för de telefonnummer som är tilldelade agenten. Klicka på + för att lägga till fler.

Varje leverantör kan konfigureras en gång per regel.

Ange sedan destinationen:

  • Destinationstyp: Telefonnummer eller SIP-URI. Endast SIP REFER kan överföra till en SIP-URI. Alla andra överföringstyper använder ett telefonnummer.
  • Telefonnummer / SIP-URI: målet i lämpligt format, angivet direkt eller som en dynamisk variabel (till exempel {{phone_number}}):

En regel finns endast för samtal vars leverantör har en konfiguration för den. Om ett samtal körs på ett SIP trunk-nummer och regeln endast har en Twilio-konfiguration kan agenten inte erbjuda den överföringen i samtalet.

SIP REFER-överföringar kräver SIP-protokollet under samtalet och din SIP Trunk måste tillåta överföring via SIP REFER.

Två regler kan inte peka på samma destination hos samma leverantör, eftersom agenten inte kan skilja dem åt. Du kan alltid ändra villkoret så att det omfattar båda fallen.

API-implementering

Du kan konfigurera systemverktyget transfer_to_number när du skapar eller uppdaterar en agent via API:et (Skapa agent, Uppdatera agent). Verktyget låter dig ange meddelanden för både klienten (användaren som överförs) och agenten (den mänskliga operatör som tar emot samtalet).

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
billing_destination = {"type": "phone", "destination": "+15551234567"}
human_destination = {"type": "phone", "destination": "+15559876543"}
# Each rule lists one config per telephony provider. A call only sees the rules
# that have a config for its provider (twilio, sip_trunk or exotel).
transfer_rules = [
{
"condition": "When the user asks for billing support.",
"provider_configs": [
{
"type": "twilio",
"config": {
"type": "twilio_warm_conference_transfer",
"transfer_destination": billing_destination,
# Wait 1s, then dial extension 1234 (Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
},
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_conference_transfer",
"transfer_destination": billing_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_warm_transfer",
"transfer_destination": billing_destination,
},
},
],
},
{
"condition": "When the user asks to speak to a human.",
"provider_configs": [
{
"type": "twilio",
"config": {
# Preserves caller ID, no warm transfer message
"type": "twilio_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
{
"type": "exotel",
"config": {
"type": "exotel_cold_blind_transfer",
"transfer_destination": human_destination,
},
},
],
},
{
"condition": "When the user requests to file a formal complaint.",
"provider_configs": [
{
"type": "sip_trunk",
"config": {
"type": "sip_cold_refer_transfer",
"transfer_destination": {"type": "sip_uri", "destination": "sip:support@example.com"},
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# "dynamic" takes the dynamic variable's name, without {{ }}
{"type": "dynamic", "key": "X-Customer-ID", "value": "customer_id"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
},
],
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
# Still required, and must be empty when transfer_rules is set
"transfers": [],
"transfer_rules": transfer_rules,
},
}
},
},
),
),
)

Referens för API-dokumentation

Äldre konfiguration

Överföringstyper

Systemet stöder tre typer av överföringar:

  • Konferensöverföring: Standardbeteendet som ringer upp destinationen och lägger till deltagaren i ett konferensrum, och sedan tar bort AI-agenten så att endast uppringaren och den överförda deltagaren återstår. Vid användning av den inbyggda Twilio-integrationen stöds ett meddelande för varm överföring (agent_message) som läses upp för den mänskliga operatören.
  • Blind överföring: Överför samtalet direkt till destinationen utan ett meddelande för varm överföring till den mänskliga operatören. Det ursprungliga nummerpresentations-ID:t bevaras. Endast tillgängligt när agentens telefonnummer har importerats via den inbyggda Twilio-integrationen.
  • SIP REFER-överföring: Använder SIP REFER-protokollet för att överföra samtal direkt till destinationen. Fungerar med både telefonnummer och SIP-URI:er, men är endast tillgängligt när SIP-protokollet används under samtalet och kräver att din SIP Trunk tillåter överföring via SIP REFER. Stöder inte meddelanden för varm överföring.

Meddelanden för varm överföring (agent_message) är endast tillgängliga när agentens telefonnummer har importerats via den inbyggda Twilio- integrationen. SIP-baserade överföringar stöder inte meddelanden för varm överföring.

Blinda överföringar är endast tillgängliga när agentens telefonnummer har importerats via den inbyggda Twilio-integrationen och måste för närvarande konfigureras via JSON-redigeraren i gränssnittet. Välj “Redigera som JSON” i överförings- verktygets konfiguration och ange "transfer_type": "blind" för den önskade överföringsregeln.

Syfte: Överlämna sömlöst samtal till mänskliga operatörer när AI-hjälp inte räcker till.

Utlösande villkor: LLM:en ska anropa det här verktyget när:

  • Komplexa problem kräver mänskligt omdöme
  • Användaren uttryckligen ber om mänsklig hjälp
  • AI:n når gränsen för vad den kan göra för den specifika förfrågan
  • Eskaleringsprotokoll utlöses

Parametrar:

  • reason (sträng, valfritt): Anledningen till överföringen
  • transfer_number (sträng, krävs): Telefonnummer att överföra till (måste matcha konfigurerade nummer)
  • client_message (sträng, krävs): Meddelande som läses upp för kunden medan överföringen väntar
  • agent_message (sträng, krävs): Meddelande till den mänskliga operatör som tar emot samtalet

Format för funktionsanrop:

{
"type": "function",
"function": {
"name": "transfer_to_number",
"arguments": "{\"reason\": \"Complex billing issue\", \"transfer_number\": \"+15551234567\", \"client_message\": \"I'm transferring you to a billing specialist who can help with your account.\", \"agent_message\": \"Customer has a complex billing dispute about order #12345 from last month.\"}"
}
}

Implementering: Konfigurera telefonnummer och villkor för överföring. Definiera meddelanden för både kunden och den mänskliga operatör som tar emot samtalet. Fungerar med både Twilio och SIP trunking.

Nummer som går att överföra till

Överföring till en person stöder överföring till externa telefonnummer med både SIP-trunking och Twilio-telefonnummer.

Aktivera överföring till en person

Överföring till en person konfigureras med systemverktyget transfer_to_number.

1

Lägg till överföringsverktyget

Aktivera överföring till en person genom att välja systemverktyget transfer_to_number i agentens konfiguration på fliken Agent. Välj “Överför till person” när du lägger till ett verktyg.

Lägg till verktyg för överföring till person
Välj verktyget 'Överför till person'
2

Konfigurera verktygsbeskrivning (valfritt)

Du kan ange en anpassad beskrivning som vägleder LLM:en om när en överföring ska utlösas. Om fältet lämnas tomt används en standardbeskrivning som omfattar de definierade överföringsreglerna.

Beskrivning av verktyg för överföring till person
Konfigurera överföringsverktygets beskrivning
3

Definiera överföringsregler

Konfigurera de specifika reglerna för överföring till telefonnummer eller SIP-URI:er. Ange följande för varje regel:

  • Överföringstyp: Välj mellan överföringsmetoderna konferens (standard), blind eller SIP REFER
  • Nummertyp: Välj Telefon för vanliga telefonnummer eller SIP URI för SIP-adresser
  • Telefonnummer/SIP URI: Måldestinationen i lämpligt format:
  • Villkor: En beskrivning på naturligt språk av omständigheterna då överföringen ska ske (t.ex. “Användaren ber uttryckligen om att få prata med en person”, “Användaren behöver uppdatera känslig kontoinformation”).

LLM:en använder dessa villkor tillsammans med verktygsbeskrivningen för att avgöra när och till vilken destination samtalet ska överföras.

SIP REFER-överföringar kräver SIP-protokollet under samtalet och att din SIP Trunk tillåter överföring via SIP REFER. Endast SIP REFER stöder överföring till en SIP-URI.

Blinda överföringar är endast tillgängliga när agentens telefonnummer har importerats via den inbyggda Twilio-integrationen och måste konfigureras via JSON-redigeraren. Det ursprungliga nummerpresentations-ID:t bevaras, men inget meddelande för varm överföring skickas till den mänskliga operatören.

Konfiguration av regler för överföring till person
Definiera överföringsregler med telefonnummer och villkor

Se till att destinationerna är korrekt formaterade:

  • Telefonnummer: E.164-format och kopplade till ett korrekt konfigurerat konto
  • SIP-URI:er: Giltigt SIP-format (sip:user@domain eller sips:user@domain)
4

Konfigurera anpassade SIP REFER-rubriker (valfritt)

När du använder SIP REFER-överföringar kan du inkludera anpassade SIP-rubriker för att skicka ytterligare information till det mottagande systemet.

Ange följande för varje anpassad rubrik:

  • Rubriknamn: Namnet på SIP-rubriken (t.ex. X-Customer-ID, X-Priority)
  • Rubrikvärde: Rubrikvärdet, som kan vara statisk text eller innehålla dynamiska variabler

Anpassade SIP REFER-rubriker inkluderas endast vid SIP REFER-överföringar. Konferensöverföringar stöder inte anpassade rubriker.

Systemrubrikerna X-Conversation-ID och X-Caller-ID inkluderas automatiskt av ElevenLabs och åsidosätter alla anpassade rubriker med samma namn (skiftlägesokänsligt).

5

Konfigurera användar-till-användar-information (UUI) (valfritt)

SIP REFER-överföringar kan bära användar-till-användar-information (UUI), en liten nyttolast som levereras till den mottagande plattformen (till exempel Talkdesk eller Genesys Cloud) i parametern User-to-User i rubriken Refer-To. UUI skickas endast vid SIP REFER-överföringar till en SIP-URI-destination; destinationer med telefonnummer (tel:) bär inte med sig den.

Konfigurera UUI per överföringsregel med objektet uui:

  • data: Nyttolasten som ska skickas, som klartext. ElevenLabs hex-kodar den och lägger till ;encoding=hex. Kan vara statisk text eller innehålla dynamiska variabler. Högst 256 byte (UTF-8), vilket kontrolleras efter att dynamiska variabler har ersatts — för vanlig ASCII motsvarar det 256 tecken, färre för tecken med flera byte.
  • protocol_discriminator: En enda hexadecimalt oktett, till exempel 04. Inkludera den för plattformar som tar bort den första oktetten i nyttolasten; utelämna den för plattformar som skickar nyttolasten vidare.
  • protocol_discriminator_mode: prefix (standard) lägger till oktetten först och ger 04<hex>;encoding=hex. pd_parameter lägger till den som en separat parameter och ger <hex>;pd=04;encoding=hex.

Talkdesk skickar värdet vidare utan ändringar, så utelämna protokolldiskriminatorn. Genesys Cloud tar bort nyttolastens första oktett om ingen diskriminator finns, så inkludera en protocol_discriminator. Se Genesys UUI-dataformat.

Gränsen på 256 byte gäller efter att dynamiska variabler har ersatts. Skicka identifierare eller korta koder, till exempel ett konto-ID, inte fritext som en fullständig samtalssammanfattning, eftersom den överskrider gränsen och tas bort från överföringen.

Ingen konfiguration krävs för att ta emot UUI vid inkommande SIP-samtal. När en inkommande INVITE innehåller en User-to-User-rubrik exponeras dess värde för agenten som de dynamiska variablerna {{sip_uui_raw}} och {{sip_uui_data}}. Se SIP-referensen.

6

Konfigurera siffror efter uppringning (valfritt)

Siffror efter uppringning är DTMF-toner som vidarebefordras efter att telefonen har anslutits till överföringsdestinationen. Det är användbart för att ange anknytningsnummer eller automatiskt navigera i IVR-menyer (Interactive Voice Response).

För varje överföringsregel kan du ange en post_dial_digits-sträng som innehåller:

  • Siffror (0-9): Vanliga DTMF-toner
  • w: 0,5 sekunders fördröjning
  • W: 1 sekunds fördröjning
  • * och #: Särskilda DTMF-toner

Till exempel väntar ww1234 i 1 sekund efter att samtalet ansluts och slår sedan anknytningsnummer 1234.

Siffror efter uppringning är endast tillgängliga när agentens telefonnummer (numret som initierar överföringen) har importerats via den inbyggda Twilio-integrationen. Destinationsnumret kan vara vilket telefonnummer som helst.

Siffror efter uppringning stöds endast för överföringstyperna konferens och blind. SIP REFER-överföringar stöder inte siffror efter uppringning.

API-implementering

Du kan konfigurera systemverktyget transfer_to_number när du skapar eller uppdaterar en agent via API:et (Skapa agent, Uppdatera agent). Verktyget låter dig ange meddelanden för både klienten (användaren som överförs) och agenten (den mänskliga operatören som tar emot samtalet).

from elevenlabs import AgentConfig, ConversationalConfig, ElevenLabs
elevenlabs = ElevenLabs(api_key="YOUR_API_KEY")
# Define transfer rules
transfer_rules = [
{
"transfer_destination": {"type": "phone", "phone_number": "+15551234567"},
"condition": "When the user asks for billing support.",
"transfer_type": "conference",
# Wait 1s, then dial extension 1234 (native Twilio only)
"post_dial_digits": {"type": "static", "value": "ww1234"},
},
{
"transfer_destination": {"type": "phone", "phone_number": "+15559876543"},
"condition": "When the user asks to speak to a human.",
# Native Twilio integration only, preserves caller ID, no warm transfer message
"transfer_type": "blind",
},
{
"transfer_destination": {"type": "sip_uri", "sip_uri": "sip:support@example.com"},
"condition": "When the user requests to file a formal complaint.",
"transfer_type": "sip_refer",
"custom_sip_headers": [
{"type": "static", "key": "X-Department", "value": "complaints"},
{"type": "static", "key": "X-Priority", "value": "high"},
# Use "dynamic" to read the value from a dynamic variable
{"type": "dynamic", "key": "X-Customer-ID", "value": "{{customer_id}}"},
],
"uui": {
"data": "account_id={{customer_id}}",
"protocol_discriminator": "04", # Genesys Cloud; omit for Talkdesk
"protocol_discriminator_mode": "prefix", # or "pd_parameter"
},
},
]
response = elevenlabs.conversational_ai.agents.create(
conversation_config=ConversationalConfig(
agent=AgentConfig(
first_message="Hi, how can I help you today?",
prompt={
"prompt": "You are a helpful assistant.",
"built_in_tools": {
"transfer_to_number": {
"type": "system",
"name": "transfer_to_number",
# Optional custom description
"description": "Transfer the user to a human operator based on their request.",
"params": {
"system_tool_type": "transfer_to_number",
"transfers": transfer_rules,
},
}
},
},
),
),
)
# Note: When the LLM decides to call this tool, it needs to provide:
# - transfer_number: The phone number to transfer to (must match one defined in rules).
# - client_message: Message read to the user during transfer.
# - agent_message: Message read to the human operator receiving the call (native Twilio integration only, not used for blind transfers or SIP).