Hantera webhooks

Webhooks skickar händelser från Klang till din egen server. Använd dem för att uppdatera ett CRM, posta till ett chattverktyg eller sätta igång en process när ett möte är färdigbehandlat.

Webhooks är personliga. Varje webhook tillhör en användare och tar endast emot händelser för innehåll som den användaren har tillgång till.

Skapa en webhook

1. Öppna Inställningar → Utvecklare → Webhooks
2. Klicka på Skapa webhook

3. Ange den URL som ska ta emot händelserna. Det måste vara en offentlig HTTPS-slutpunkt
4. Valfritt: Lägg till en Beskrivning så att du kan känna igen webhooken senare
5. Välj vilka händelser du vill prenumerera på. Alla tre är markerade som standard
6. Klicka på Skapa

Klang visar signeringshemligheten en gång efter att den skapats. Kopiera den och förvara den på ett säkert ställe. Du kommer att använda den för att verifiera att inkommande förfrågningar kommer från Klang.

Tillgängliga händelser

• conversation.ready: transkriptionen och AI-analysen är klar och redo att hämta
• conversation.failed: bearbetningen misslyckades för ett möte eller en fil
• conversation.deleted: ett möte eller en fil har tagits bort

Varje händelsepayload innehåller ett händelse-ID, händelsetypen och en referens till konversationen. För det fullständiga payload-schemat, signaturrubrikformatet och exempelkod för verifiering, se webhook-dokumentationen.

Övervaka leveranser

Klicka på en webhook för att öppna dess detaljsida.

Detaljsidan visar:

• Status och URL längst upp, med en knapp för att pausa leveranser
• Signeringshemlighet: klicka på Visa för att visa eller Kopiera för att kopiera den
• Statistik för 24 timmar: antal levererade, felfrekvens, genomsnittlig svarstid och aktivitet
• Senaste leveranser: en rad per leveransförsök. Klicka på en rad för att se förfrågans innehåll och din servers svar

Klang försöker igen med misslyckade leveranser upp till sex gånger med fördröjning. En webhook pausas automatiskt efter 25 på varandra följande misslyckanden. Åtgärda din slutpunkt och aktivera sedan Ta emot händelser igen.

Skicka en testhändelse

Så här kontrollerar du att din slutpunkt fungerar:

1. Öppna webhook-detaljsidan
2. Klicka på Skicka testhändelse i det övre högra hörnet
3. Om din webhook prenumererar på fler än en händelse, välj vilken händelse som ska skickas
4. Se den nya raden visas under Senaste leveranser

Testhändelser är markerade med en TEST-tagg och använder händelse-ID:n med prefixet evt_test_. Payload-schemat matchar en riktig händelse så att du kan verifiera din hanterare från början till slut.

Pausa eller ta bort en webhook

På webhook-detaljsidan:

• För att pausa, stäng av Ta emot händelser. Klang slutar skicka händelser men behåller webhooken och dess historik
• För att ta bort, klicka på Redigera och sedan Ta bort webhook längst ned i dialogrutan

Du kan också pausa eller ta bort via menyn … i webhook-listan.

Nästa steg

• Läs webhook-dokumentationen för payload-scheman och signaturverifiering
• Hantera dina integrationer för att skicka händelser via inbyggda tjänster som Slack istället
• Bygg ett flöde om du vill transformera innehåll innan det lämnar Klang