Hoppa till navigering

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:

  1. En HTTP-slutpunkt att anropa.
  2. En beskrivning av vad den gör, så att AI:n vet när den ska användas.
  3. 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.

FältBeskrivning
NamnVerktygsnamnet som AI:n ser, till exempel check_order_status
BeskrivningNär och varför verktyget ska användas
MetodGET, POST, PUT, PATCH eller DELETE
URLDin HTTP-slutpunkt
Svarstimeout (sekunder)Hur länge vi ska vänta på din server: 5–120 sekunder, standardvärdet är 20
Tilldela till agenterReceptionist, Assistentagent eller båda
Inaktivera avbrottFörhindra att uppringaren avbryter medan verktyget körs
BegärandehuvudenValfria headers som skickas med varje begäran. Typ är Värde eller Hemlighet. En Hemlighet lagras krypterat och visas aldrig igen. En header från ElevenAgents kan visa Miljövariabel eller Variabel, med en notering om att den är inställd i agentplattformen.
SökvägsparametrarVisas när URL:en innehåller platshållare inom klammerparenteser, till exempel /orders/{order_id}. Redigera URL:en för att lägga till eller ta bort en.
BrödtextparametrarParametrar som skickas som en JSON-begärandetext och visas för POST, PUT och PATCH. De kan vara objekt och listor.
FrågeparametrarParametrar som skickas som URL-frågesträngar. Var och en är ett enskilt värde.

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 som filter[name] kan inte anropas direkt.
  • Typ: string, number, integer eller boolean. Brödtextparametrar kan också vara object eller array.
  • 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 object grupperar 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 samtalet
  • phones: array, där varje objekt är ett objekt med två fält:
    • number: sträng, från samtalet
    • label: sträng, fast värde mobile
  • source: objekt med ett fält, channel: sträng, fast värde phone

följande begärandetext:

{
"name": "Jane Doe",
"phones": [{ "number": "+15551234567", "label": "mobile" }],
"source": { "channel": "phone" }
}

Användningsområden

ScenarioBeskrivningMetod
CRM-sökningHämta kundinformation från ditt systemGET
LagerkontrollKontrollera produkttillgänglighet i realtidGET
Insamling av leadsSkicka uppgifter om uppringaren till ditt marknadsföringssystemPOST
Skapa ärendeSkapa ett supportärende under samtaletPOST
PrisoffertBeräkna en anpassad offert utifrån uppringarens behovPOST

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: Authorization instä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.