Webhooks beheren

Webhooks sturen gebeurtenissen vanuit Klang naar je eigen server. Gebruik ze om een CRM bij te werken, een chatbericht te plaatsen of een proces te starten zodra een vergadering is verwerkt.

Webhooks zijn persoonlijk. Elke webhook hoort bij één gebruiker en ontvangt alleen gebeurtenissen voor inhoud waartoe die gebruiker toegang heeft.

Een webhook maken

1. Open Instellingen → Ontwikkelaars → Webhooks.
2. Klik op Webhook maken.

3. Voer de URL in die de gebeurtenissen moet ontvangen. Dit moet een openbaar HTTPS-endpoint zijn.
4. Optioneel: voeg een Beschrijving toe om de webhook later te herkennen.
5. Selecteer de gebeurtenissen waarop je je wilt abonneren. Standaard zijn ze alle drie geselecteerd.
6. Klik op Maken.

Open na het maken de detailpagina van de webhook. Klik bij Ondertekeningsgeheim op Tonen om het zichtbaar te maken of op Kopiëren om het te kopiëren. Bewaar het veilig; hiermee controleer je of inkomende verzoeken van Klang afkomstig zijn.

Beschikbare gebeurtenissen

• conversation.ready: het transcript en de AI-analyse zijn klaar om op te halen.
• conversation.failed: de verwerking van een vergadering of bestand is mislukt.
• conversation.deleted: een vergadering of bestand is verwijderd.

Elke payload bevat een gebeurtenis-ID, het gebeurtenistype en een verwijzing naar het gesprek. Raadpleeg de webhookdocumentatie voor het volledige payloadschema, de indeling van de handtekeningheader en voorbeeldcode voor verificatie.

Bezorgingen controleren

Klik op een webhook om de detailpagina te openen.

De detailpagina toont:

• Status en URL bovenaan, met een schakelaar om bezorging te pauzeren.
• Ondertekeningsgeheim — Klik op Tonen om het zichtbaar te maken of op Kopiëren om het te kopiëren.
• Statistieken van 24 uur — Aantal bezorgingen, foutpercentage, gemiddelde reactietijd en activiteit.
• Laatste bezorgingen — Eén rij per bezorgpoging. Klik op een rij om de aanvraagbody en het antwoord van je server te bekijken.

Klang probeert mislukte bezorgingen maximaal zes keer opnieuw, met steeds langere tussenpozen. Na 25 opeenvolgende fouten wordt een webhook automatisch gepauzeerd. Herstel je endpoint en schakel daarna Gebeurtenissen ontvangen weer in.

Een testgebeurtenis sturen

1. Open de detailpagina van de webhook.
2. Klik rechtsboven op Testgebeurtenis versturen.
3. Kies een gebeurtenis als de webhook op meerdere gebeurtenissen is geabonneerd.
4. Controleer de nieuwe rij onder Laatste bezorgingen.

Testgebeurtenissen hebben het label TEST en een gebeurtenis-ID die begint met evt_test_. Het payloadschema is hetzelfde als bij een echte gebeurtenis, zodat je de volledige afhandeling kunt controleren.

Een webhook pauzeren of verwijderen

Op de detailpagina:

• Schakel Gebeurtenissen ontvangen uit om te pauzeren. Klang stopt met verzenden, maar bewaart de webhook en geschiedenis.
• Klik op Bewerken en daarna onderaan op Webhook verwijderen om de webhook te verwijderen.

Je kunt een webhook ook pauzeren of verwijderen via het menu … in de webhooklijst.

Volgende stappen

• Lees de webhookdocumentatie voor payloadschema’s en verificatie van handtekeningen.
• Beheer je integraties om gebeurtenissen via ingebouwde diensten zoals Slack te sturen.
• Maak een flow om inhoud te verwerken voordat deze Klang verlaat.