Notifikationswebhooks

En notifikationswebhook skickar AurionAI-notifikationshändelser till ett annat system, till exempel ett chattverktyg. AurionAI skickar varje händelse som en JSON-kropp till den adress du anger.

Tillgänglighet: Helpdesk- och AI Voice + Helpdesk-profiler. Endast administratörer.

Förutsättningar

• Du har rollen Ägare eller Administratör. Andra användare ser Åtkomst nekad.
• Din organisation använder profilen Helpdesk eller AI Voice + Helpdesk.
• En offentlig HTTPS-adress som accepterar POST-förfrågningar med en JSON-kropp.

Öppna notifikationswebhooks

1. Välj Konfiguration i sidofältet.
2. Öppna kategorin System.
3. Välj Aviseringswebhookar.

Lägg till en webhook

1. Välj Lägg till webhook.
2. I Namn, ange ett namn.
3. I URL, ange adressen. Den måste börja med https://.
4. Valfritt: i Hemlighet (valfritt), ange en hemlighet. AurionAI signerar då varje förfrågan. Lämna fältet tomt för att skicka osignerade förfrågningar.
5. Välj händelser:
   • För att ta emot alla notifikationshändelser, aktivera Prenumerera på alla händelser.
   • Annars, välj händelserna i listan.
6. Välj Skapa.

Meddelandet Webhook skapad visas. En ny webhook är Aktiverad.

Testa webhoken

1. På webhoken, välj Testa.
2. I dialogrutan Skicka en testnyttolast?, välj Skicka test.

AurionAI skickar omedelbart en webhook.test-händelse. Meddelandet Testnyttolasten har skickats eller Det gick inte att skicka testnyttolasten visas.

Verifiera signaturen

När webhoken har en hemlighet innehåller varje förfrågan två extra huvuden:

• X-Webhook-Timestamp: tidpunkten för förfrågan, i sekunder sedan den 1 januari 1970 (UTC).
• X-Webhook-Signature: sha256= följt av signaturen.

För att kontrollera en förfrågan, beräkna en HMAC-SHA256 av tidsstämpeln, en punkt och den råa kroppen, med din hemlighet. Skriv resultatet i hexadecimalt format. Det måste vara lika med delen efter sha256=.

Redigera, inaktivera eller ta bort en webhook

• För att ändra en webhook, välj Redigera webhook, ändra fälten och välj Spara. Lämna hemligheten tom för att behålla den, eller välj Ta bort hemlighet för att skicka osignerade förfrågningar.
• För att pausa leveranser ett tag, öppna Redigera webhook och ställ omkopplaren till Inaktiverad. Spara sedan.
• För att ta bort en webhook, välj Ta bort. I dialogrutan Ta bort den här webhooken?, välj Ta bort webhook. Detta tar även bort leveranshistoriken och hemligheten. Det går inte att ångra detta.
• För att se tidigare leveranser, välj Historik på webhoken. Varje rad visar Levererad, Misslyckad eller Överhoppad, med orsaken till ett misslyckande.

Resultat

AurionAI skickar varje vald händelse när den inträffar. Om din adress inte svarar, eller svarar med en 5xx-status, försöker AurionAI igen omedelbart, upp till totalt tre försök. Ett 4xx-svar är slutgiltigt: AurionAI försöker inte igen.

Om något går fel

• URL:en måste börja med https://. Börja adressen med https://.
• Slutpunkter för molnmetadata blockeras alltid. eller ett meddelande om att en IP-adress finns i ett blockerat intervall. AurionAI skickar inte webhooks till privata eller interna adresser. Använd en offentlig adress.
• Ett meddelande säger att DNS-upplösning misslyckades. Värdnamnet finns inte, eller saknar DNS-post. Kontrollera adressen.
• Välj minst en händelse, eller välj ”Prenumerera på alla händelser”. Välj minst en händelse, eller aktivera Prenumerera på alla händelser.
• Det gick inte att skicka testnyttolasten Läs orsaken, HTTP-statusen och antalet försök i meddelandet. Kontrollera att din mottagare är online och svarar med en 2xx-status.
• Den här webhooken är inaktiverad Aktivera webhoken först. Om du väljer Skicka ändå, registrerar AurionAI endast ett överhoppat försök.
• En leverans visar Överhoppad. Webhoken var inaktiverad, eller adressen klarade inte säkerhetskontrollen innan sändning. Läs orsaken i historiken.
• Det gick inte att läsa in webhooks eller Det gick inte att läsa in aviseringshändelser Välj Försök igen.

Relaterade artiklar

• Utvecklar-API: användning och webhooks
• API-nycklar
• Få hjälp