Administrer webhooks

Webhooks sender hændelser fra Klang til jeres egen server. Brug dem til at opdatere et CRM, poste i et chatværktøj eller sætte en hvilken som helst proces i gang, når et møde er færdigbehandlet.

Webhooks er personlige. Hver webhook hører til én bruger og modtager kun hændelser for det indhold, den bruger har adgang til.

Opret en webhook

1. Åbn Indstillinger → Udviklere → Webhooks
2. Klik på Opret webhook

3. Skriv den URL, der skal modtage hændelserne. Den skal være et offentligt HTTPS-endpoint
4. Valgfrit: Tilføj en Beskrivelse, så du kan genkende webhooken senere
5. Vælg hvilke hændelser du vil abonnere på. Alle tre er valgt som standard
6. Klik på Opret

Klang viser signeringsnøglen én gang efter oprettelsen. Kopiér den, og gem den et sikkert sted. Du skal bruge den til at bekræfte, at indgående kald kommer fra Klang.

Tilgængelige hændelser

• conversation.ready: transskriptionen og AI-analysen er færdige og klar til at blive hentet
• conversation.failed: behandlingen af et møde eller en fil mislykkedes
• conversation.deleted: et møde eller en fil blev slettet

Hver hændelse indeholder et hændelses-id, hændelsestypen og en reference til samtalen. Det fulde skema, formatet på signaturheaderen og eksempler på verifikationskode finder du i webhook-dokumentationen.

Følg leveringerne

Klik på en webhook for at åbne dens detaljeside.

Detaljesiden viser:

• Status og URL øverst med en kontakt til at sætte leveringer på pause
• Signeringsnøgle: klik på Vis for at afsløre den eller på Kopiér for at kopiere den
• Statistik for 24 timer: antal leverede, fejlrate, gennemsnitlig svartid og aktivitet
• Seneste leveringer: én række pr. leveringsforsøg. Klik på en række for at se selve kaldet og din servers svar

Klang prøver mislykkede leveringer igen op til seks gange med stigende ventetid. En webhook sættes automatisk på pause efter 25 fejl i træk. Ret dit endpoint, og slå Modtager hændelser til igen.

Send en testhændelse

Sådan tjekker du, at dit endpoint virker:

1. Åbn webhookens detaljeside
2. Klik på Send testhændelse i øverste højre hjørne
3. Abonnerer din webhook på mere end én hændelse, skal du vælge, hvilken der skal sendes
4. Se den nye række dukke op under Seneste leveringer

Testhændelser er markeret med mærket TEST og bruger hændelses-id’er med præfikset evt_test_. Skemaet svarer til en rigtig hændelse, så du kan teste din handler hele vejen igennem.

Sæt en webhook på pause, eller slet den

På webhookens detaljeside:

• Vil du sætte den på pause, skal du slå Modtager hændelser fra. Klang holder op med at sende hændelser, men beholder webhooken og dens historik
• Vil du slette den, skal du klikke på Rediger og derefter på Slet webhook nederst i dialogen

Du kan også sætte på pause eller slette fra menuen … på listen over webhooks.

Næste skridt

• Læs webhook-dokumentationen for skemaer og verifikation af signaturer
• Administrér jeres integrationer, hvis I hellere vil sende hændelser gennem indbyggede tjenester som Slack
• Byg et flow, hvis I vil bearbejde indholdet, inden det forlader Klang