Notifikations-webhooks
En notifikations-webhook sender AurionAI-notifikationshændelser til et andet system, for eksempel et chatværktøj. AurionAI sender hver hændelse som en JSON-body til den adresse, du angiver.
Tilgængelighed: Helpdesk- og AI Voice + Helpdesk-profiler. Kun administratorer.
Forudsætninger
- Du har rollen Ejer eller Administrator. Andre brugere ser Adgang nægtet.
- Din organisation bruger profilen Helpdesk eller AI Voice + Helpdesk.
- En offentlig HTTPS-adresse, der accepterer POST-anmodninger med en JSON-body.
Åbn notifikations-webhooks
- Vælg Konfiguration i sidebjælken.
- Åbn kategorien System.
- Vælg Notifikations-webhooks.
Tilføj en webhook
- Vælg Tilføj webhook.
- Skriv et navn i Navn.
- Skriv adressen i URL. Den skal starte med
https://. - Valgfrit: skriv en hemmelighed i Hemmelighed (valgfrit). AurionAI signerer derefter hver anmodning. Lad feltet være tomt for at sende usignerede anmodninger.
- Vælg hændelserne:
- For at modtage alle notifikationshændelser skal du aktivere Abonnér på alle hændelser.
- Ellers skal du vælge hændelserne på listen.
- Vælg Opret.
Beskeden Webhook oprettet vises. En ny webhook er Aktiveret.
Test webhookken
- Vælg Test på webhookken.
- I dialogen Send en testpayload? skal du vælge Send testen.
AurionAI sender straks en webhook.test-hændelse. Beskeden Testpayload sendt eller Afsendelse af testpayload mislykkedes vises.
Bekræft signaturen
Når webhookken har en hemmelighed, har hver anmodning to ekstra headere:
X-Webhook-Timestamp: tidspunktet for anmodningen i sekunder siden 1. januar 1970 (UTC).X-Webhook-Signature:sha256=efterfulgt af signaturen.
For at kontrollere en anmodning skal du beregne en HMAC-SHA256 af tidsstemplet, et punktum og den rå body med din hemmelighed. Skriv resultatet i hexadecimal. Det skal være lig med den del, der kommer efter sha256=.
Rediger, deaktiver eller slet en webhook
- For at ændre en webhook skal du vælge Rediger webhook, ændre felterne og vælge Gem. Lad hemmeligheden være tom for at beholde den, eller vælg Fjern hemmelighed for at sende usignerede anmodninger.
- For at stoppe leveringer i en periode skal du åbne Rediger webhook og skifte kontakten til Deaktiveret. Gem derefter.
- For at fjerne en webhook skal du vælge Slet. I dialogen Slet denne webhook? skal du vælge Slet webhook. Dette fjerner også leveringshistorikken og hemmeligheden. Dette kan ikke fortrydes.
- For at se tidligere leveringer skal du vælge Historik på webhookken. Hver linje viser Leveret, Mislykket eller Sprunget over med årsagen til en fejl.
Resultat
AurionAI sender hver valgt hændelse, når den indtræffer. Hvis din adresse ikke svarer eller svarer med en 5xx-status, forsøger AurionAI igen med det samme – op til tre forsøg i alt. Et 4xx-svar er endeligt: AurionAI forsøger ikke igen.
Hvis noget går galt
- URL'en skal begynde med https://. Start adressen med
https://. - Slutpunkter for cloud-metadata blokeres altid. eller en besked om, at en IP-adresse er i et blokeret interval. AurionAI sender ikke webhooks til private eller interne adresser. Brug en offentlig adresse.
- En besked siger, at DNS-opløsning mislykkedes. Værtsnavnet eksisterer ikke, eller det har ingen DNS-post. Kontrollér adressen.
- Vælg mindst én hændelse, eller vælg “Abonnér på alle hændelser”. Vælg mindst én hændelse, eller aktivér Abonnér på alle hændelser.
- Afsendelse af testpayload mislykkedes Læs årsagen, HTTP-statussen og antallet af forsøg i beskeden. Kontrollér, at din modtager er online og svarer med en 2xx-status.
- Denne webhook er deaktiveret Aktivér webhookken først. Hvis du vælger Send alligevel, registrerer AurionAI kun et sprunget forsøg.
- En levering viser Sprunget over. Webhookken var deaktiveret, eller adressen bestod ikke sikkerhedstjekket inden afsendelse. Læs årsagen i historikken.
- Kunne ikke indlæse webhooks eller Kunne ikke indlæse notifikationshændelser Vælg Prøv igen.
Relaterede artikler
Sidder du stadig fast? Send en anmodning eller .