Webhooks
Ge din receptionist egna verktyg som anropar dina HTTP-slutpunkter.
Integrationen Webhook-verktyg gör dina HTTP-slutpunkter till verktyg som din receptionist eller affärsassistent kan anropa under samtal. AI:n avgör utifrån samtalet när slutpunkten ska anropas.
Så fungerar webhook-verktyg
När du skapar ett webhook-verktyg definierar du:
- En HTTP-slutpunkt att anropa.
- En beskrivning av vad den gör, så att AI:n vet när den ska användas.
- Parametrar som AI:n ska samla in från samtalet.
När samtalet matchar verktygets syfte samlar receptionisten in parametrarna, anropar slutpunkten och använder svaret för att fortsätta samtalet.
Skapa ett webhook-verktyg
Gå till Integrationer, välj Lägg till integration och välj Webhook-verktyg. Konfigurera fälten nedan och välj Aktivera. Du kan lägga till flera webhook-verktyg.
Parametrar
Varje parameter har:
- Nyckel: fältnamnet. Använd bokstäver, siffror, understreck, bindestreck,
@och enkla punkter. Hakparenteser är inte tillåtna, så ett API som förväntar sig nycklar somfilter[name]kan inte anropas direkt. - Typ:
string,number,integerellerboolean. Brödtextparametrar kan också varaobjectellerarray. - Värde: Från samtalet, ifyllt av AI:n, eller ett Fast värde, som skickas med varje begäran.
- Beskrivning: vilket värde AI:n ska extrahera från samtalet.
- Obligatorisk: om AI:n måste samla in det innan anropet.
Använd integer för heltal som antal, ID:n och flaggor med 0/1. Ett fast number skickas
med decimaltecken, så 1 kommer fram som 1.0, vilket vissa API:er avvisar.
En parameter som är konfigurerad i ElevenAgents för att hämta sitt värde från en variabel visas som skrivskyddad, med en notering om att den är inställd i agentplattformen. Den skickas enligt konfigurationen där.
Objekt och listor
Många API:er förväntar sig att relaterade fält grupperas tillsammans, till exempel en kontakt med en lista över telefonnummer. Brödtextparametrar kan skicka detta:
- Ett
objectgrupperar fält. Välj Lägg till fält för att lägga till varje fält; varje fält har sin egen nyckel, typ och värde. - En
arrayär en lista. Under Varje objekt väljer du typen för objekten i listan. En lista med objekt låter AI:n skicka flera poster med samma struktur, till exempel en per telefonnummer.
Fält kan nästlas upp till fem nivåer. Ett objekt eller en lista kommer alltid från samtalet, men ett fält i ett objekt kan ha ett Fast värde, till exempel en etikett eller ett ID som aldrig ändras.
Till exempel skickar dessa brödtextparametrar:
name: sträng, från samtaletphones: array, där varje objekt är ett objekt med två fält:number: sträng, från samtaletlabel: sträng, fast värdemobile
source: objekt med ett fält,channel: sträng, fast värdephone
följande begärandetext:
Användningsområden
Exempel
Ett VVS-företag skapar ett webhook-verktyg:
- Namn:
check_service_area - Beskrivning: “Kontrollera om vi erbjuder service i uppringarens postnummer och vilken nästa lediga tid är.”
- URL:
https://api.mybusiness.com/check-area - Metod: POST
- Begärandehuvuden:
Authorizationinställt på företagets API-nyckel, som en Hemlighet - Brödtextparametrar:
zip_code(sträng, obligatorisk),service_type(sträng, obligatorisk)
När en uppringare frågar om service i sitt område samlar receptionisten in postnumret, anropar webhooken och berättar resultatet.
Webhook-verktyg är tillgängliga i alla abonnemang.