Hoe kunt u webhooks gebruiken om de status van uw verzonden of ontvangen fax te controleren?

Met webhooks ontvangt u realtime updates over uw verzonden en ontvangen faxen, rechtstreeks van Fax.Plus. Door webhooks te configureren kunt u de bewaking van uw faxverzendingen automatiseren en statusupdates integreren in uw bestaande systemen.

Webhooks configureren

1. Open het paneel Webhooks:
   • Log in op uw Fax.Plus-account.
   • Ga naar de sectie Integraties onder Instellingen.
   • Zoek Webhooks en klik op Beheren.
2. Voeg een endpoint toe:
   • Klik op Endpoint toevoegen en voer de absolute URL in op uw server die de gebeurtenissen zal ontvangen.
   • Kies welke gebeurtenissen u wilt ontvangen. Abonneer u op alle gebeurtenissen, of kies alleen de gebeurtenissen die u nodig hebt uit
     de gebeurtenissencatalogus.
   • Optioneel: filter op faxnummer. Koppel een of meer van uw faxnummers om alleen gebeurtenissen te ontvangen voor
     die nummers.

3. Statusupdates ontvangen

   • Zodra de configuratie is voltooid, stuurt Fax.Plus een webhook naar de door u opgegeven URL telkens wanneer de status van een fax
     verandert.
   • De payload van de webhook bevat belangrijke gegevens zoals de fax-ID, de status, het tijdstip en
     de gegevens van de ontvanger.

   Opmerking: Als hook.id niet gelijk is aan data.id, wordt opnieuw geprobeerd de fax te verzenden. Als hook.id gelijk is aan data.id, betekent dit dat de fax voor de eerste keer wordt verzonden

4. Handtekening verifiëren
   • Voor elk aangemaakt endpoint wordt automatisch een ondertekeningsgeheim gegenereerd waarmee u elk binnenkomend verzoek kunt valideren. Lees meer over het verifiëren van webhook-handtekeningen.
5. (Optioneel) Verifieer de IP-adressen van herkomst:
   • U kunt controleren of de webhooks die u ontvangt afkomstig zijn van ons overzicht van geautoriseerde IP-adressen:
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

Probleemoplossing en monitoring

• Logboeken en observeerbaarheid: in het webhookspaneel ziet u elke gebeurtenis en of deze succesvol is bezorgd of niet.
• Nieuwe pogingen: als de bezorging mislukt, worden webhooks automatisch opnieuw verzonden.
• Opnieuw afspelen: u kunt ook handmatig nieuwe pogingen starten vanuit het paneel, of eerdere gebeurtenissen opnieuw afspelen binnen een gekozen tijdvenster.