Ga naar inhoud
AurionAI

Notificatie webhooks

3 min leestijdDoor Emmanuel Yazbeck

Een notificatie-webhook stuurt AurionAI-notificatiegebeurtenissen naar een ander systeem, bijvoorbeeld een chattool. AurionAI verstuurt elke gebeurtenis als een JSON-body naar het adres dat u invoert.

Beschikbaarheid: Helpdesk- en AI Voice + Helpdesk-profielen. Alleen beheerders.

Vereisten

  • U heeft de rol Eigenaar of Beheerder. Andere gebruikers zien Toegang geweigerd.
  • Uw organisatie gebruikt het profiel Helpdesk of AI Voice + Helpdesk.
  • Een openbaar HTTPS-adres dat POST-verzoeken met een JSON-body accepteert.

De notificatie-webhooks openen

  1. Selecteer in de zijbalk Configuratie.
  2. Open de categorie Systeem.
  3. Selecteer Meldings-webhooks.

De pagina Notificatie-webhooks met de lijst van webhooks.

Een webhook toevoegen

  1. Selecteer Webhook toevoegen.
  2. Typ bij Naam een naam.
  3. Typ bij URL het adres. Het moet beginnen met https://.
  4. Optioneel: typ bij Geheim (optioneel) een geheim. AurionAI ondertekent dan elk verzoek. Laat dit leeg om niet-ondertekende verzoeken te versturen.
  5. Kies de gebeurtenissen:
    • Om elke notificatiegebeurtenis te ontvangen, schakelt u Op alle gebeurtenissen abonneren in.
    • Selecteer anders de gebeurtenissen in de lijst.
  6. Selecteer Aanmaken.

Het bericht Webhook aangemaakt verschijnt. Een nieuwe webhook is Ingeschakeld.

De webhook testen

  1. Selecteer op de webhook Testen.
  2. Selecteer in het dialoogvenster Testpayload versturen? de optie Test versturen.

AurionAI verstuurt onmiddellijk een webhook.test-gebeurtenis. Het bericht Testpayload succesvol verzonden of Verzenden van testpayload mislukt verschijnt.

De handtekening verifiëren

Wanneer de webhook een geheim heeft, bevat elk verzoek twee extra headers:

  • X-Webhook-Timestamp: het tijdstip van het verzoek, in seconden sinds 1 januari 1970 (UTC).
  • X-Webhook-Signature: sha256= gevolgd door de handtekening.

Om een verzoek te controleren, berekent u een HMAC-SHA256 van het tijdstempel, een punt en de onbewerkte body, met uw geheim. Schrijf het resultaat in hexadecimaal. Dit moet gelijk zijn aan het deel na sha256=.

Een webhook bewerken, uitschakelen of verwijderen

  • Om een webhook te wijzigen, selecteert u Webhook bewerken, past u de velden aan en selecteert u Opslaan. Laat het geheim leeg om het te behouden, of selecteer Geheim verwijderen om niet-ondertekende verzoeken te versturen.
  • Om leveringen tijdelijk te stoppen, opent u Webhook bewerken en zet u de schakelaar op Uitgeschakeld. Sla daarna op.
  • Om een webhook te verwijderen, selecteert u Verwijderen. Selecteer in het dialoogvenster Deze webhook verwijderen? de optie Webhook verwijderen. Hiermee worden ook de leveringsgeschiedenis en het geheim verwijderd. Dit kan niet ongedaan worden gemaakt.
  • Om eerdere leveringen te bekijken, selecteert u Geschiedenis op de webhook. Elke regel toont Afgeleverd, Mislukt of Overgeslagen, met de reden van een fout.

Resultaat

AurionAI verstuurt elke geselecteerde gebeurtenis wanneer deze plaatsvindt. Als uw adres niet antwoordt, of antwoordt met een 5xx-status, probeert AurionAI het onmiddellijk opnieuw, tot maximaal drie pogingen in totaal. Een 4xx-antwoord is definitief: AurionAI probeert het niet opnieuw.

Als er iets misgaat

  • De URL moet beginnen met https://. Begin het adres met https://.
  • Cloud-metadata-eindpunten worden altijd geblokkeerd. of een melding dat een IP-adres zich in een geblokkeerd bereik bevindt. AurionAI verstuurt geen webhooks naar privé- of interne adressen. Gebruik een openbaar adres.
  • Een melding geeft aan dat DNS-omzetting is mislukt. De hostnaam bestaat niet, of heeft geen DNS-record. Controleer het adres.
  • Selecteer minstens één gebeurtenis of kies “Op alle gebeurtenissen abonneren”. Selecteer ten minste één gebeurtenis, of schakel Op alle gebeurtenissen abonneren in.
  • Verzenden van testpayload mislukt Lees de reden, de HTTP-status en het aantal pogingen in de melding. Controleer of uw ontvanger online is en antwoordt met een 2xx-status.
  • Deze webhook is uitgeschakeld Schakel de webhook eerst in. Als u Toch versturen selecteert, registreert AurionAI alleen een overgeslagen poging.
  • Een levering toont Overgeslagen. De webhook was uitgeschakeld, of het adres heeft de veiligheidscontrole niet doorstaan vóór verzending. Lees de reden in de geschiedenis.
  • Kan webhooks niet laden of Kan meldingsgebeurtenissen niet laden Selecteer Opnieuw proberen.

Gerelateerde artikelen

Komt u er nog niet uit? Dien een aanvraag in of .