Ö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 exempel04. 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 ger04<hex>;encoding=hex.pd_parameterlä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
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.
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.
(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.
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.
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}}):- Telefonnummer: E.164-format (t.ex. +12125551234)
- SIP-URI:er: SIP-format (t.ex. sip:1234567890@example.com)
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).
Referens för API-dokumentation
Äldre konfiguration
Dokumentation för äldre överföringar
Ö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öringentransfer_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äntaragent_message(sträng, krävs): Meddelande till den mänskliga operatör som tar emot samtalet
Format för funktionsanrop:
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.
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.

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.

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:
- Telefonnummer: E.164-format (t.ex. +12125551234)
- SIP-URI:er: SIP-format (t.ex. sip:1234567890@example.com)
- 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.

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)
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).
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 exempel04. 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 ger04<hex>;encoding=hex.pd_parameterlä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.
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öjningW: 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).