Webhooks #

Webhooks låter Your AI Connector automatiskt meddela dina andra affärsverktyg när något viktigt händer — en ny kontakt skapas, en tid bokas, ett meddelande tas emot. Istället för att manuellt kontrollera efter uppdateringar får dina anslutna system en omedelbar avisering i samma ögonblick som något sker.

Vad är webhooks? #

Se en webhook som ett automatiskt textmeddelande mellan två appar. När något händer i Your AI Connector (som att en ny kontakt registrerar sig) skickar plattformen omedelbart en avisering till ett annat system som du valt. Du anger en webbadress (kallad “webhook-URL”) dit dessa aviseringar ska skickas — denna tillhandahålls vanligtvis av ditt CRM, din automatiseringsplattform eller din utvecklare.

Sidan Webhooks skickar endast data UT från Your AI Connector. De webhooks som ställs in här går åt ett håll, från Your AI Connector till dina andra verktyg. För att hämta in nya leads eller annan data (från ett webbformulär, ditt CRM eller GoHighLevel) har du två alternativ. En automatisering med Webhook-utlösaren ger dig en webbadress som ditt formulär eller verktyg kan skicka data till, och dess steg kan sedan skapa kontakten, skicka ett meddelande med mera. Alternativt gör ditt system ett API-anrop, till exempel åtgärden Skapa en kontakt, med din API-nyckel; se API-åtkomst och Funnels.

Webhooks ingår endast i vissa abonnemang. Om ditt abonnemang inte inkluderar webhooks är sidan Webhooks inte tillgänglig och inga händelser skickas. Allt du tidigare har sparat finns kvar på ditt konto och börjar skickas igen så snart du har ett abonnemang som inkluderar webhooks. Vilka funktioner som ingår i ditt abonnemang listas på din faktureringssida, och din leverantör kan berätta vilket abonnemang du bör byta till.

Vanliga användningsområden inkluderar:

• Synkronisering av nya kontakter till ditt CRM.
• Utlösning av ett arbetsflöde i Zapier, Make eller Pabbly när en tagg läggs till.
• Meddela ditt team i Slack när en människa behöver ta över.
• Uppdatering av ditt kalendersystem när en tid bokas.
• Loggning av konversationssammanfattningar till din databas.

Konfigurera webhooks #

1. Klicka på Inställningar (kugghjulsikonen) i sidofältet till vänster.
2. Under gruppen Integrationer i inställningsmenyn, klicka på Webhooks.

På ett konto där inga webhooks har konfigurerats ännu ser sidan ut så här:

3. Klicka på New webhook längst upp till höger. Ett formulär öppnas direkt på sidan:

4. Fyll i:
   • Endpoint-URL — webbadressen som Your AI Connector ska skicka händelseaviseringar till. Du får denna från ditt externa system (CRM, automatiseringsplattform eller egen server).
   • Namn — en etikett som du känner igen senare (t.ex. “Slack-varningar” eller “CRM-synk”). Endast för din egen referens.

Din webhook-URL måste vara en publikt nåbar https://-adress. Vanliga http://-adresser, localhost eller adresser i privata nätverk samt interna plattformsadresser avvisas när du sparar. För att testa från din egen maskin, använd en publik tunnel (webhook.site eller ngrok) istället för localhost.

5. Under Events, klicka på de händelser du vill att denna webhook ska ta emot — alla 24 listas i The 24 Webhook Events.
6. (Valfritt) Aktivera Retry failed deliveries om du vill att Your AI Connector ska fortsätta försöka vid ett tillfälligt fel — se Retrying Failed Deliveries.
7. Klicka på Create webhook. Den visas i listan under formuläret, och du kan när som helst klicka på Test på dess rad för att skicka en exempelnyttolast till din slutpunkt.

Behörighet krävs. Att lägga till, redigera eller testa webhooks kräver “redigera”-behörighet för Integrationer (teammedlemmar med endast läsbehörighet ser ett meddelande om skrivskydd istället för formuläret).

Signering av en webhook kräver att den redan är sparad — öppna raden för en befintlig webhook för att redigera den, så visas panelen Signeringshemlighet längst ner i redigeringsformuläret. Ett helt nytt, osparat utkast har ännu inget signeringsalternativ — se Signerade nyttolaster nedan.

En webhook för alla dina klientkonton (byråer) #

Om du driver en byrå behöver du inte återskapa samma webhook på varje klientkonto. På byråkontot har webhook-formuläret en extra växlingsknapp: Utlös även för alla klientkonton. Aktivera den så tar denna webhook även emot händelser som sker på alla klientkonton under din byrå – en slutpunkt, hela byrån.

Så här fungerar det:

• user-blocket talar om för dig vilken klient en händelse tillhör. Varje avisering innehåller redan ett user-block som identifierar kontot där händelsen inträffade, så att din automatisering kan dirigera per klient.
• Din webhooks egna inställningar gäller överallt. De händelser du valt, signeringshemligheten och inställningen för att försöka igen används även för leveranser till klientkonton.
• Inga dubbla leveranser. Om ett klientkonto har en egen webhook som pekar på samma URL, används den för det kontots händelser istället – samma händelse anländer aldrig två gånger till en slutpunkt.
• Klienter ser den inte. Webhooken visas inte på klientkontots egen sida för webhooks, och klienter kan inte stänga av den – det är du som hanterar den.
• Tillförlitlighet spåras per klientkonto. Om din slutpunkt fortsätter att misslyckas stängs den av automatiskt för det konto vars leveranser misslyckades (se Webhook-tillförlitlighet), inte för hela byrån på en gång.

Växlingsknappen visas endast för byråkonton. Det går även att ställa in detta via API:et – se fältet apply_to_sub_accounts i Webhooks API.

Tillgängliga utlösande händelser #

Du kan aktivera eller inaktivera var och en av de 24 webhook-händelserna oberoende av varandra. När en händelse utlöses skickar Your AI Connector ett meddelande till din webhook-URL med relevant data. Varje händelse, vad den betyder och den event-kod den placerar i nyttolasten listas tillsammans i The 24 Webhook Events längre ner på denna sida.

Bra att veta: Task Created, Task Updated och Task Completed är fullt valbara och sparas korrekt. Daily Summary Created är också ett nyligen tillagt alternativ. Se Task Completed Webhook nedan för den nyttolastens form.

Taggbaserade webhook-utlösare #

subscribed_to_tags begränsar inte en webhooks händelser till en tagg. Den begränsar bara vilka taggar som genererar ett meddelande om konversationssammanfattning. För att få en förfrågan när en specifik tagg appliceras, ställ in en webhook-URL på den taggen under fliken Taggar i agentredigeraren.

Själva webhook-formuläret har ingen taggväljare, varken när du skapar en ny webhook eller när du redigerar en, så subscribed_to_tags kan endast läsas eller ändras via Webhooks API, eller genom att fråga supporten.

Bra att veta: att redigera en befintlig webhook som har en subscribed_to_tags-lista (döpa om den, ändra dess händelser, växla försök) rensar inte längre den listan — eftersom formuläret inte har någon taggväljare att skicka tillbaka, lämnar sparande från denna sida nu den befintliga listan orörd. (Detta var en verklig bugg före 21 juli 2026: sparande från webhook-formuläret brukade radera listan eftersom den alltid skickade en tom tagglista. Om en webhook förlorade sin subscribed_to_tags-lista före det datumet måste den konfigureras om via API:et.)

Generera sammanfattning för taggade kontakter #

Där en webhook har en subscribed_to_tags-lista kan du aktivera Generate Summary. När det är aktiverat genererar Your AI Connector automatiskt en konversationssammanfattning för kontakten när en av dessa taggar tillämpas, och inkluderar den i webhook-datan — full kontext utan en separat förfrågan.

Testa din webhook #

1. Öppna Inställningar → Integrationer → Webhooks.
2. Klicka på Testa på raden för din webhook.
3. Kontrollera ditt externa system för att bekräfta att det tog emot testdatan.
4. Granska dataformatet för att säkerställa att ditt system kan tolka det korrekt.

För ett fullständigt test från början till slut, skicka ett meddelande som skulle utlösa en av dina konfigurerade händelser (en sändning eller ett inkommande meddelande på en ansluten kanal) och verifiera att webhooken utlöses med den verkliga datan.

Vad som räknas som en lyckad leverans #

Oavsett om du klickar på Test eller om händelsen utlöses på riktigt, skickar vi samma sak:

• En POST-förfrågan (aldrig GET), med brödtexten som JSON och Content-Type: application/json.
• Rubrikerna som listas under Signed Payloads. Signaturrubriker inkluderas endast när du har angett en signeringshemlighet.

Vi betraktar leveransen som lyckad när:

• Din slutpunkt svarar med valfri 2xx-status (200, 201, 204 — allt är okej).
• Den svarar inom 30 sekunder.

Några saker som förvånar folk:

• Svarskroppen ignoreras. Du behöver inte returnera någon specifik JSON. Ett tomt 200-svar räcker.
• Omdirigeringar räknas som ett fel. Vi följer dem inte, så en 301 eller 302 (inklusive en omdirigering för avslutande snedstreck, eller http till https) registreras som en misslyckad leverans. Spara den slutgiltiga URL:en, inte en som omdirigerar.
• Frågesträngar stöds fullt ut. https://your-app.com/hook?token=abc123 skickas exakt som du sparade den, så att placera en token i frågesträngen fungerar lika bra som att placera den i sökvägen.
• Din URL måste vara https:// och offentligt tillgänglig. Adresser som tillhör Your AI Connector:s egen infrastruktur avvisas, men dina egna slutpunkter på Google Cloud Functions, Cloud Run, App Engine, Firebase Hosting eller någon annanstans går bra.
• En brandvägg eller ett skyddslager mot botar framför din slutpunkt kan blockera oss. Det vanligaste fallet är Cloudflare: om din zon har “Bot Fight Mode” eller en hanterad utmaning aktiverad, får vår förfrågan en “Just a moment…”-utmaningssida med en 403 istället för att nå din server — och en server-till-server-förfrågan kan aldrig klara en webbläsarutmaning, så både Test-knappen och verkliga händelser misslyckas på samma sätt. Test-knappen kommer att berätta för dig när detta händer (“Cloudflare is showing a bot challenge to our request”). Åtgärda det i Cloudflare med en Security / WAF-regel som hoppar över utmaningar för din webhook-sökväg (eller för användaragenten Webhook-Delivery/1.0), och klicka sedan på Test igen.
• Om din brandvägg istället behöver en IP-tillåtelselista (till exempel Cloudflares gratisplan, där vanligt “Bot Fight Mode” inte kan hoppas över av en WAF-regel, men en IP Access Rule inställd på “Allow” körs före den), kan vi hjälpa till: varje leverans, oavsett om den kommer från Test-knappen eller en live-händelse, skickas från en fast IPv4-adress (inga intervall, ingen IPv6, ingen rotation). Kontakta supporten så ger vi dig adressen som ska läggas till i tillåtelselistan. Behåll signaturverifiering som din faktiska förtroendekontroll, eftersom den validerar varje nyttolast oavsett var den kom ifrån.
• Testresultatet berättar exakt vad din slutpunkt svarade. Ett misslyckat test visar nu den verkliga orsaken (HTTP-statusen din slutpunkt returnerade, en timeout, eller att vi inte kunde nå adressen alls) istället för ett generiskt fel, och ett test på en sparad webhook skickas signerat när signering är aktiverat, precis som en live-händelse.

Använda n8n, Make eller Zapier (“Test-URL” vs “Produktions-URL”) #

Automationsplattformar ger dig vanligtvis två olika webhook-adresser, vilket ofta skapar förvirring:

• En Test-URL (i n8n innehåller den /webhook-test/). Denna tar endast emot data medan du aktivt bevakar arbetsytan och precis har klickat på Lyssna efter testhändelse (eller Testa arbetsflöde). Den fångar en enskild händelse och slutar sedan lyssna — så att klicka på Testa i Your AI Connector flera gånger i rad fångar bara den första, och endast om lyssningsfönstret är aktivt vid just det ögonblicket. För att testa: klicka på Lyssna efter testhändelse i n8n först, gå sedan tillbaka till Your AI Connector och klicka på Testa en gång.
• En Produktions-URL (i n8n innehåller den /webhook/, ingen -test). Detta är den du ska klistra in i Your AI Connector för live-händelser. Den fungerar bara när ditt arbetsflöde är inställt på Aktivt. Om arbetsflödet inte är aktivt avvisar n8n förfrågan med ett “404 / webhook not registered”-fel, trots att Your AI Connector skickade datan korrekt.

Kort sagt: testa med test-URL:en medan du lyssnar, men för att webbhooken ska fortsätta fungera för riktiga kontakter, spara Produktions-URL:en i Your AI Connector och se till att arbetsflödet är Active.

Dataformat för webhook #

När en webhook utlöses skickar Your AI Connector strukturerad data (JSON) till din webhook-URL. Om du använder en automatiseringsplattform som Zapier eller Make, tolkar den denna data åt dig automatiskt. Om du bygger en egen integration:

{
  "event": "contactCreated",
  "contact": { "id": "<contact-id>", "first_name": "Jane", "...": "..." },
  "campaign": { "id": "<campaign-id>", "name": "AI Receptionist", "status": "Live" },
  "agent": { "id": "<agent-id>", "name": "Front Desk" },
  "user": { "id": "<account-id>", "email": "owner@example.com" }
}

Läs agent, inte campaign. Kampanjer har flyttats till AI-agenter och utskick (se Campaigns Have Moved), så dina kontakter ligger hos en agent och agent talar om för dig vilken som hanterade konversationen. Fältet campaign skickas fortfarande så att äldre mottagare fortsätter fungera, men det är oftast null; det fylls bara i för en kontakt som fortfarande har en länk till en klassisk kampanj. Anta inte att campaign alltid finns där.

agent-blocket anlände den 15 augusti 2026. Det placeras tillsammans med campaign bland händelser kopplade till en konversation — en avslutad chatt, stör ej, återupptagning, arkivering, AI-paus, ett nytt meddelande, en konversationssammanfattning och den webhook du kan ställa in på en tagg — och innehåller den hanterande agentens id och name, eller null när ingen agent är involverad. Det är rent additivt: varje fält du redan tar emot är oförändrat, så en mottagare du byggde före det datumet fortsätter att fungera utan att något behöver uppdateras.

Vissa händelser lägger till sitt eget extra toppnivåblock. Till exempel lägger Appointment Booked, Appointment Cancelled och Appointment Rescheduled till ett appointment-block (se Appointment Booked Webhook), New Message lägger till ett fullständigt message-block med texten (se New Message Webhook), och Deliveries och Reads lägger till ett kort message-block med endast meddelandets ID och status (se Deliveries and Reads Webhook).

Deliveries och Reads talar om vilket meddelande det gäller, men inte vad det innehöll. De innehåller ett message-block med meddelandets id och status — och det id är samma messageId som send message endpoint returnerar, så att du kan matcha en leverans- eller läskvitto med det exakta meddelande du skickade — men inget meddelandeinnehåll. Replies innehåller inget message-block alls. Om du behöver orden som skickades eller togs emot, prenumerera på New Message utöver dessa.

Två saker att veta innan du skriver din mottagare. Det finns inget timestamp-fält och ingen data-omslutare. Varje block ligger på toppnivå i JSON-objektet, som visas ovan.

The 24 Webhook Events #

De 24 webhook-händelserna, med visningsetiketten du kryssar i appen och event-koden som skickas i nyttolasten. event-koden är en kort sträng som inte matchar visningsetiketten, så matcha din mottagare mot koden, inte etiketten:

Två koder till visas aldrig i den listan eftersom du inte prenumererar på dem: contact_tags_updated, skickas av en webhook-URL inställd på en enskild tagg, och summary_generated, skickas när en chattsammanfattning skrivs för en tagg i en webhooks subscribed_to_tags-lista.

Kanal ansluten skickas ännu inte. Den visas i händelselistan, men ingenting skickar den idag. Bygg inte mot den.

Taggbaserade och uppgiftsbaserade aviseringar använder sina egna separata former. Se Contact Tags Updated och Task Completed.

Webhook för skapad kontakt #

Skickas när händelsen Kontakt skapad utlöses (en ny kontakt läggs till manuellt, via import eller via API).

Händelsenamn #

contactCreated

Nyttolastformat #

{
  "event": "contactCreated",
  "contact": {
    "id": "<contact-id>",
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith",
    "human_alerted": false,
    "human_alert_reason": null,
    "is_bot_active": true,
    "ad_referral": null,
    "ad_attribution": null
  },
  "campaign": {
    "id": "<campaign-id>",
    "name": "AI Receptionist",
    "status": "Live"
  },
  "agent": {
    "id": "<agent-id>",
    "name": "Front Desk"
  },
  "user": {
    "id": "<account-id>",
    "email": "owner@example.com",
    "first_name": "Alex",
    "last_name": "Doe"
  }
}

“Test”-exemplet och en verklig händelse ser något annorlunda ut. Testknappen skickar platshållardata (John Doe, ett exempel på kampanjblock). En verklig “Contact Created”-händelse innehåller kontaktens faktiska uppgifter, och vissa fält kan vara tomma beroende på kanal.

Webhook för nytt meddelande #

Denna webhook utlöses varje gång ett meddelande läggs till i en konversation, på vilken kanal som helst. Den täcker båda riktningarna: meddelanden din kontakt skickar till dig, och meddelanden din AI-agent, ditt team eller ett utskick skickar till dem. Det är den enda webhooken som inkluderar meddelandetexten, så det är den du ska använda när du vill spegla konversationer till ett externt system.

Händelsenamn #

new_message

Nyttolastformat #

{
  "event": "new_message",
  "contact": {
    "id": "<contact-id>",
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith",
    "human_alerted": false,
    "human_alert_reason": null,
    "is_bot_active": true,
    "ad_referral": null,
    "ad_attribution": null
  },
  "agent": {
    "id": "<agent-id>",
    "name": "Front Desk"
  },
  "user": {
    "id": "<account-id>",
    "email": "owner@example.com",
    "first_name": "Alex",
    "last_name": "Doe"
  },
  "message": {
    "id": "<message-id>",
    "body": "Hi, are you open on Saturday?",
    "direction": "inbound",
    "status": "received",
    "created_at": "2026-07-30T17:27:06.000Z",
    "channel": "whatsapp_web",
    "media_url": null,
    "media_content_type": null
  }
}

Det finns fortfarande inget campaign-block i denna nyttolast. New Message skickar contact, agent, user och message. Blocket agent lades till den 15 augusti 2026 och talar om för dig vilken agent som hanterar konversationen; om du behöver mer kontext om kontakten, slå upp den via API:et med contact.id.

Spara bilagor snart efter att de har anlänt. Länken media_url slutar fungera 7 dagar efter att meddelandet anlände, på alla kanaler (WhatsApp Business API, WhatsApp Web, Instagram, Messenger, Telegram, chattwidgeten och övriga); själva filen finns kvar. För att få en ny länk senare, anropa Ladda ner en bilaga till ett meddelande med contacts/{contact.id}/messages/{message.id}. Fälten lades till den 13 september 2026.

När media_url är null men brödtexten säger att en fil anlände. Vissa bilagor lagras på ett sätt som saknar direktlänk, och en delad Instagram-reel, ett inlägg eller en omnämnd story är en länk till Instagram, inte en fil, så dessa anländer också som null (brödtexten anger vad som delades). För en fil, anropa Download a message’s attachment med meddelandets ID för att få en länk.

Importerad historik utlöser inte denna webhook. När ett WhatsApp Web-nummer importerar sina tidigare konversationer sparas dessa äldre meddelanden utan att en avisering om nytt meddelande skickas för varje.

Interna AI-poster utlöser inte denna webhook. Utöver riktiga meddelanden sparar plattformen sina egna bokföringsrader i en konversation (AI:ns verktygsanrop och interna tur-poster). Dessa skickas aldrig — du tar endast emot meddelanden som genuint skickats eller tagits emot.

Deliveries and Reads Webhook #

Dessa två händelser rapporterar vad som hände med ett meddelande efter att det lämnade Your AI Connector: Deliveries utlöses när ett meddelande når kontakten (eller misslyckas med att göra det), och Reads utlöses när kontakten öppnar det, på de kanaler som stöder läskvitton.

Båda innehåller ett message-block med ID för det meddelande händelsen gäller, så att du kan matcha uppdateringen med det exakta meddelande du skickade.

Händelsenamn #

delivered och undelivered för Deliveries, read för Reads.

Nyttolastformat #

{
  "event": "delivered",
  "contact": {
    "id": "<contact-id>",
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith",
    "ad_referral": null,
    "ad_attribution": null
  },
  "campaign": {
    "id": "<campaign-id>",
    "name": "AI Receptionist",
    "status": "Live"
  },
  "agent": {
    "id": "<agent-id>",
    "name": "Front Desk"
  },
  "user": {
    "id": "<account-id>",
    "email": "owner@example.com",
    "first_name": "Alex",
    "last_name": "Doe"
  },
  "message": {
    "id": "<message-id>",
    "status": "delivered"
  }
}

Hur man matchar en uppdatering med meddelandet du skickade. Lagra det messageId du får tillbaka när du skickar ett meddelande via API:et. När en Deliveries- eller Reads-notis anländer, sök upp det lagrade ID:t mot message.id i nyttolasten — det är ditt leverans- eller läskvitto för just det meddelandet.

Det finns ingen meddelandetext här. message-blocket innehåller endast ID och status. Prenumerera på New Message om du även behöver innehållet.

message-blocket finns endast när vi vet vilket meddelande det var. Vid sällsynta uppdateringar som vi inte kan koppla till ett lagrat meddelande utelämnas blocket helt istället för att skickas tomt — kontrollera därför att message existerar innan du läser message.id.

En notis per statusändring. Ett enskilt utgående meddelande skapar normalt en delivered-notis och sedan, på kanaler med läskvitton, en read-notis. Ett misslyckat utskick skapar undelivered istället.

Appointment Booked Webhook #

Utlöses när en kontakt bokar en tid. Den utlöses på samma sätt oavsett om AI:n bokade den under en konversation, om du bokade den för hand eller om den kom in via API:et.

Händelsenamn #

booked

Nyttolastformat #

{
  "event": "booked",
  "contact": {
    "id": "<contact-id>",
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith"
  },
  "campaign": {
    "id": "<campaign-id>",
    "name": "AI Receptionist",
    "status": "Live"
  },
  "user": {
    "id": "<account-id>",
    "email": "owner@example.com"
  },
  "appointment": {
    "appointment_id": "<appointment-id>",
    "start_time": "2026-07-20T15:00:00.000Z",
    "end_time": "2026-07-20T15:30:00.000Z",
    "status": "Confirmed",
    "room_name": "Room 1",
    "description": "Discovery call",
    "summary": "30 min intro",
    "google_calendar_event_id": null,
    "external_reference": "crm-booking-1042",
    "event": {
      "id": "<service-id>",
      "event_name": "Intro Call",
      "slot_duration": 30,
      "location": "Zoom",
      "meeting_link": "https://...",
      "event_type": "online"
    }
  }
}

google_calendar_event_id är ofta null i denna webhook, och det är normalt. Google Calendar-händelsen skapas i samma ögonblick som denna avisering går ut, så ID:t är oftast inte klart än. Hämta bokningen igen via dess appointment_id en stund senare om du behöver det. Det förblir null permanent om kontot inte har någon Google Calendar ansluten, så vänta inte på det för evigt.

Knappen “Test” skickar ett exempel på ett appointment-block med påhittade värden, så att du kan bygga mot formen innan en riktig bokning kommer in.

Två fall där denna webhook inte utlöses: möten som importerats från en extern kalender och bokningar som kommer in via Formitable-integrationen.

Appointment Cancelled and Rescheduled Webhooks #

Appointment Cancelled utlöses när en tid avbokas, och Appointment Rescheduled utlöses när den flyttas till en ny start- eller sluttid. Båda utlöses på samma sätt oavsett om AI:n gjorde det under en konversation, du ändrade det i appen, det kom in via API:et eller någon ändrade händelsen i den anslutna Google Kalendern.

Händelsenamn #

appointment_cancelled och appointment_rescheduled

Nyttolastformat #

Brödtexten är densamma som Appointment Booked, med tiden som den är efter ändringen. En avbokning lägger till appointment.cancelation_reason; en ombokning lägger till ett toppnivå-previous-block med de gamla tiderna:

{
  "event": "appointment_rescheduled",
  "contact": { "id": "<contact-id>", "email": "jane@example.com", "phone_number": "+15551234567", "first_name": "Jane", "last_name": "Smith" },
  "campaign": null,
  "agent": { "id": "<agent-id>", "name": "Front desk" },
  "user": { "id": "<account-id>", "email": "owner@example.com" },
  "appointment": {
    "appointment_id": "<appointment-id>",
    "start_time": "2026-07-21T09:00:00.000Z",
    "end_time": "2026-07-21T09:30:00.000Z",
    "status": "Confirmed",
    "room_name": "Room 1",
    "description": "Discovery call",
    "summary": "30 min intro",
    "google_calendar_event_id": "<calendar-event-id>",
    "external_reference": "crm-booking-1042",
    "cancelation_reason": null,
    "event": { "id": "<service-id>", "event_name": "Intro Call", "slot_duration": 30 }
  },
  "previous": {
    "start_time": "2026-07-20T15:00:00.000Z",
    "end_time": "2026-07-20T15:30:00.000Z"
  }
}

En ändring, en händelse. Att avboka en tid skickar endast Appointment Cancelled, även om tiden ändrades vid samma redigering. Att bara redigera titel, anteckningar eller rum skickar ingetdera. Att flytta samma tid två gånger skickar två Appointment Rescheduled-händelser.

Webhook för avslutad chatt #

Utlöses när AI:n beslutar att en konversation har nått sitt slut (en bokning gjord, en lead diskvalificerad, och så vidare).

Händelsenamn #

chat_concluded

Nyttolastformat #

Nyttolasten bär event, hela contact, agent som hanterade chatten och kontot user. Den bär också conversation_cost, vad denna konversation kostade i krediter, så att ett n8n- eller Make-flöde kan logga det utan ett andra anrop:

{
  "event": "chat_concluded",
  "contact": { "id": "abc123", "first_name": "Jane", "channel": "whatsapp" },
  "agent": { "id": "agent_1", "name": "Sales Agent" },
  "user": { "id": "user_1" },
  "conversation_cost": {
    "credits": 7.5,
    "session_id": "sess_9f2",
    "started_at": "2026-09-26T09:14:02.000Z",
    "outcome": "contained"
  }
}

• credits: krediter som debiterats inom denna konversation, återbetalningar avdragna. Det räknas på samma sätt som rapporten för konversationskostnader i API:et.
• outcome: contained (AI:n hanterade det ensam), handed_off (någon från ditt team svarade efter AI:n, eller AI:n larmade en människa) eller no_ai.
• conversation_cost utelämnas när siffran inte kan räknas ut vid det tillfället. Behandla det som valfritt.

Webhook för uppdaterade kontakttaggar #

Utlöses när en tagg appliceras på en kontakt, och den taggen har en webhook-URL konfigurerad på agenten som kontakten är tilldelad till.

Händelsenamn #

contact_tags_updated

När den utlöses #

• En tagg appliceras på en kontakt som har en AI-agent tilldelad.
• Minst en av de applicerade taggarna har en webhook-URL inställd på fliken Taggar i agentens redigeringsläge.

En kontakt som fortfarande har en länk till en klassisk kampanj från tiden före övergången till agenter är ett specialfall: om kampanjens taggar har webhook-URL:er används dessa, annars används agentens.

Om flera taggar med olika webhook-URL:er appliceras i samma uppdatering skickas en förfrågan per URL, där varje förfrågan endast innehåller de taggar som är kopplade till den URL:en.

Att ta bort en tagg skickar aldrig en förfrågan. De flesta använder dessa URL:er för en åtgärd — ta in en deposition, boka en tid, meddela en säljare — så att en tagg som tas bort från en kontakt tidigare kunde köra om den åtgärden. Det går inte längre. En borttagning visas fortfarande i removed_tags när den sker i samma uppdatering som en applicering som går till samma URL, så en automatisering som läser båda arrayerna behåller hela bilden; vad den aldrig kommer att se är en förfrågan som enbart orsakas av en borttagning. (Ändrat 12 augusti 2026. Före det datumet skickade även borttagningar en förfrågan.)

Nyttolastformat #

{
  "event": "contact_tags_updated",
  "contact": {
    "id": "<contact-id>",
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith",
    "human_alerted": false,
    "is_bot_active": true,
    "ad_referral": {
      "ctwa_clid": "ARAbc123...",
      "source_id": "120210000000000",
      "source_type": "ad",
      "source_url": "https://fb.me/xxxx",
      "headline": "Get 20% off today",
      "body": "Message us now to claim your discount",
      "channel": "whatsapp"
    },
    "ad_attribution": null
  },
  "added_tags": ["qualified-lead"],
  "removed_tags": ["new-lead"],
  "agent": {
    "id": "<agent-id>",
    "name": "Front Desk"
  },
  "user": {
    "email": "owner@example.com",
    "first_name": "Alex",
    "last_name": "Doe"
  }
}

Testa en tagg-webhook #

Bredvid fältet för webhook-URL på fliken Taggar finns en Testa-knapp. Den skickar omedelbart en exempelnyttolast till den URL:en, så att du kan bekräfta att din automatisering tar emot den innan du väntar på en riktig konversation.

Testet skickar samma contact_tags_updated-form som visas ovan, med en platshållarkontakt, med taggen du testar i added_tags och en tom removed_tags. Det din automatisering ser i testet är vad den kommer att se i produktion.

Två saker att känna till:

• Spara taggen först. Testet letar upp taggen via dess sparade namn, så en helt ny tagg eller en osparad namnändring kan inte testas än. Knappen förblir gråmarkerad tills namnet på skärmen matchar det sparade.
• Ett misslyckat test räknas inte mot din webhook. Tester bidrar aldrig till den automatiska avstängningen efter upprepade fel som beskrivs i Webhook Reliability.

Om testet misslyckas talar meddelandet om för dig vad din slutpunkt svarade (till exempel en 404 eller 500), vilket oftast räcker för att upptäcka en felaktig URL eller ett arbetsflöde som inte är aktiverat.

Webhook för slutförd uppgift #

Endast för referens. Uppgifts-webhooks (som data) dokumenteras här för utvecklare; händelserna Task Created, Task Updated och Task Completed är valbara i standardlistan för händelser i webhook-formuläret som vilken annan händelse som helst — se Available Trigger Events och The 24 Webhook Events.

Denna nyttolast skickas när en uppgift övergår till ett stadium markerat som ett slutförandestadium. En uppgift som flyttas mellan stadier som inte är slutförandestadier skickar istället taskUpdated-formatet.

Händelsenamn #

taskCompleted

När den utlöses #

• En uppgift uppdateras.
• Dess stage-värde ändrades jämfört med dess tidigare värde.
• Det nya stadiet är konfigurerat som ett slutförandestadium i kontots inställningar för uppgiftsstadier.

Nyttolastformat #

{
  "event": "taskCompleted",
  "contact": {
    "email": "jane@example.com",
    "phone_number": "+15551234567",
    "first_name": "Jane",
    "last_name": "Smith",
    "human_alerted": false,
    "human_alert_reason": null
  },
  "user": {
    "email": "owner@example.com",
    "first_name": "Alex",
    "last_name": "Doe"
  },
  "message": {
    "id": "<task-id>",
    "title": "Follow up with Jane",
    "description": "Confirm pricing and send proposal",
    "type": "follow_up",
    "priority": "high",
    "stage": "<stage-id>",
    "due_date": "2026-01-20T15:00:00Z",
    "source": "ai",
    "source_detail": "<source-detail>",
    "campaign_id": "<campaign-id>",
    "linked_human_alert": "<human-alert-id>",
    "tags": ["qualified-lead"],
    "notes": "Customer requested a callback"
  }
}

Stänga av (eller ta bort) en webhook #

Varje webhook har en på/av-knapp direkt på sin rad. Att stänga av en gör att den slutar ta emot händelser, men behåller allt du konfigurerat — URL:en, händelserna, eventuella signeringshemligheter. Slå på den igen så fortsätter den där den slutade; ingenting som hände medan den var avstängd levereras i efterhand.

Använd den när du vill att leveranser ska göra uppehåll en stund: din slutpunkt byggs om, du felsöker en störande integration eller pausar en automatisering.

Att ta bort en webhook (papperskorgsikonen på dess rad) tar bort den permanent, inklusive dess signeringshemlighet. Om du bara vill att leveranser ska upphöra, stäng av den istället — ta bort är för när du är helt klar med slutpunkten.

Detta är inte samma sak som att en webhook stängs av automatiskt. Om vi inaktiverar din webhook efter upprepade fel (se Webhook-tillförlitlighet), kommer reglaget ovan inte att aktivera den igen. När din slutpunkt har åtgärdats, redigera webhooken och spara den med en ändrad URL (alla URL-ändringar återaktiverar den), eller anropa återaktiveringsslutpunkten via API:et — eller kontakta supporten så aktiverar vi den åt dig.

Signerade nyttolaster (Verifiera att en webhook verkligen kom från oss) #

Vem som helst som får reda på din webhook-URL kan skicka en falsk förfrågan till den. Om du agerar på webhooks automatiskt — uppdaterar fakturering, skapar CRM-poster — låter aktivering av signering dig verifiera att varje förfrågan verkligen kom från oss.

Signering är valfritt och avstängt som standard, och du aktiverar det per webhook från den webhookens redigeringsvy (öppna en sparad webhooks rad).

Aktivera signering #

1. Öppna webhooken (Inställningar → Integrationer → Webhooks → klicka på din webhooks rad).
2. I avsnittet Signeringshemlighet, klicka på Generera.
3. Kopiera hemligheten (den börjar med whsec_) och lagra den i ditt mottagande system. Behandla den som ett lösenord.

Du kan när som helst återvända för att visa, kopiera, rotera eller stänga av hemligheten från samma panel.

Vad vi skickar #

När signering är aktiverad bär varje leverans för den webhooken dessa två extra HTTP-huvuden:

Dessa tre finns med i varje leverans, signerad eller ej:

Hur man verifierar #

Signaturen är en HMAC-SHA256 av strängen <timestamp>.<raw request body>, med din signeringshemlighet som nyckel.

Verifiera mot den råa förfrågningskroppen — de exakta bytes du tog emot. Om ditt ramverk tolkar JSON-koden och serialiserar om den innan kontroll, kan bytes ändras och signaturen kommer inte att matcha.

Node.js-exempel:

const crypto = require("crypto");

function verify(rawBody, headers, secret) {
  const timestamp = headers["x-webhook-timestamp"];
  const signature = headers["x-webhook-signature"]; // "v1=<hex>"

  // Reject anything older than 5 minutes so a captured request can't be replayed later.
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;

  const expected = crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");

  return crypto.timingSafeEqual(Buffer.from(signature.replace("v1=", "")), Buffer.from(expected));
}

Python-exempel:

import hashlib, hmac, time

def verify(raw_body: bytes, headers, secret: str) -> bool:
    timestamp = headers["X-Webhook-Timestamp"]
    signature = headers["X-Webhook-Signature"].replace("v1=", "")

    # Reject anything older than 5 minutes so a captured request can't be replayed later.
    if abs(time.time() - int(timestamp)) > 300:
        return False

    expected = hmac.new(secret.encode(), f"{timestamp}.".encode() + raw_body, hashlib.sha256).hexdigest()

    return hmac.compare_digest(signature, expected)

Jämför signaturer med en tidsäker funktion (timingSafeEqual / compare_digest), inte ==. Det kostar ingenting och undviker en subtil klass av attacker.

Rotera hemligheten #

Klicka på Rotera för att ersätta hemligheten. Växlingen sker omedelbart: nästa leverans signeras endast med den nya hemligheten. Om din slutpunkt är aktiv, acceptera både den gamla och den nya hemligheten i några minuter medan du distribuerar den nya.

Att stänga av signering innebär helt enkelt att signaturhuvuden inte längre skickas.

Försök igen vid misslyckade leveranser #

Som standard görs inga nya försök för en leverans som misslyckas — om ditt system är nere vid det tillfället går händelsen förlorad.

Aktivera Försök igen vid misslyckade leveranser för en webhook (i formuläret för att skapa/redigera) så fortsätter vi försöka:

Det sträcker sig över ungefär 2 timmar och 40 minuter, så en webhook kan överleva ett underhållsfönster eller ett kort avbrott på din sida.

Vad som görs nytt försök för: tillfälliga problem — om din server returnerar ett 5xx-fel, en timeout eller ett anslutningsfel.

Vad som inte gör det: om din slutpunkt avvisar själva förfrågan (vilken 4xx som helst), försöker vi inte igen — att skicka samma förfrågan igen skulle bara leda till samma avvisande.

Vilka händelser görs om: varje händelse, sedan 24 september 2026. Detta omfattar tagg-webhooks (contact_tags_updated), de tre uppgiftshändelserna, daglig sammanfattning, sammanfattnings-webhook, Nytt meddelande, Chatt avslutad, Kontakt pausad, Kontakt återupptagen, Kontakt stör ej, Kontakt avarkiverad, Lågt kreditsaldo, sändningshändelserna samt kontakt- och aktivitetshändelserna: Kontakt skapad, Möte bokat, Människa aviserad, Svar, Lästa, Leveranser, Krediter förbrukade och Krediter påfyllda. Före det datumet skickades Nytt meddelande, Chatt avslutad, Kontakt pausad, Kontakt återupptagen, Kontakt stör ej, Kontakt avarkiverad och sammanfattnings-webhooken en gång oavsett inställning. Varje händelse bär på X-Webhook-Delivery, så en dedupliceringsregel täcker alla.

Aktivera endast försök igen om din slutpunkt är idempotent. Försök igen innebär att samma händelse kan anlända mer än en gång. Använd X-Webhook-Delivery-huvudet för att känna igen en upprepning: det förblir detsamma vid varje försök för en händelse, så att du säkert kan ignorera ett ID som du redan har hanterat.

Försök igen-funktionen interagerar med den automatiska avstängningen efter upprepade fel (se Webhook-tillförlitlighet) på det sätt du förväntar dig: felräknaren räknar en hel leverans, först efter att varje försök har förbrukats — inte varje enskilt försök.

Webhook-tillförlitlighet #

• Your AI Connector skickar webhooks via en säker anslutning (HTTPS). Se till att webbadressen du anger använder HTTPS.
• Om ditt system returnerar ett fel anses leveransen ha misslyckats.
• Övervaka ditt mottagande systems drifttid för att undvika att missa händelser.
• För kritiska arbetsflöden, aktivera Försök igen vid misslyckad leverans och överväg även en reservmekanism.

Webhooks stängs av automatiskt efter upprepade fel. Om din webhook-URL misslyckas upprepade gånger (cirka 5 fel i rad, eller 3 i rad för konfigurationsfel), slutar Your AI Connector automatiskt att skicka händelser till den URL:en. För att återaktivera den när din slutpunkt fungerar igen: redigera webhooken och spara den med en ändrad URL (alla URL-ändringar återaktiverar den), eller använd återaktiveringsslutpunkten via API:et — att spara med samma URL räcker inte. Supporten kan också återaktivera den åt dig.

Felsökning #

Nästa steg #

• GoHighLevel-integration — använd webhooks för att integrera Your AI Connector med GHL.
• API-åtkomst — kombinera webhooks med API:et för kraftfull automatisering.
• Använda taggar för att märka kontakter — ställ in taggar som utlöser dina webhooks.