Een webhook stuurt een verzoek naar uw server telkens wanneer er iets gebeurt in Notiondesk, zoals een nieuw contactbericht of een gepubliceerd artikel. Gebruik het om uw CRM, datawarehouse of interne tools up-to-date te houden zonder zelf Notiondesk te hoeven controleren.
Voordat je begint
- U bent de eigenaar van de werkruimte of een beheerder. Andere rollen kunnen de pagina Webhooks niet openen.
- Je server heeft een openbaar adres dat begint met
https://, een domeinnaam gebruikt (geen IP-adres) en POST-verzoeken accepteert.
Een eindpunt toevoegen
- Klik in je Notiondesk dashboard op Instellingen .
- Ga naar Werkruimte , open Ontwikkelaars en vervolgens Webhooks .
- Klik op Eindpunt toevoegen .
- Voer de URL in die de verzoeken moet ontvangen, bijvoorbeeld
https://hooks.acme-support.com/notiondesk.
- Voer een naam in die aangeeft waarvoor het eindpunt bedoeld is, bijvoorbeeld
CRM sync.
- Klik onder Gebeurtenissen op Een gebeurtenis toevoegen en selecteer de gebeurtenissen die dit eindpunt moet ontvangen. Typ iets in het zoekvak om er snel een te vinden.

- Klik op Eindpunt toevoegen .
Eén eindpunt ontvangt gebeurtenissen van uw werkruimte en van elk helpcentrum daarin, dus u hebt er niet één per helpcentrum nodig. U kunt maximaal 10 eindpunten toevoegen.
Kopieer het ondertekeningsgeheim
Direct nadat je het eindpunt hebt toegevoegd, toont Notiondesk zijn ondertekeningsgeheim. Je server gebruikt dit om te controleren of elk verzoek daadwerkelijk van Notiondesk afkomstig is.
- Klik op Kopiëren .
- Bewaar het geheim op een plek waar uw server het kan lezen, bijvoorbeeld als omgevingsvariabele of in een geheimbeheerder.

- Klik op ' Ik heb het opgeslagen' .
Een testgebeurtenis verzenden
- Klik op de eindpuntpagina op 'Testgebeurtenis verzenden' .
- Controleer onder 'Recente leveringen' of de testgebeurtenis een groen vinkje en de responscode
200weergeeft. Dit betekent dat uw server de levering heeft ontvangen.
Klik op een levering om het antwoord van uw server en het verzonden verzoek Notiondesk te bekijken. Als de test mislukt, controleer dan of uw server binnen enkele seconden antwoordt met de code 2xx.
Veelgestelde vragen
Heb ik één eindpunt per helpcentrum nodig?
Nee. Eén eindpunt ontvangt gebeurtenissen van uw werkruimte en van alle bijbehorende helpcentra. Recente leveringen laten zien van welk helpcentrum elke gebeurtenis afkomstig is.
Hoeveel eindpunten kan ik toevoegen?
Maximaal 10 per werkplek.
Wie kan eindpunten toevoegen?
Alleen de eigenaar van de werkruimte en beheerders kunnen eindpunten toevoegen, wijzigen en verwijderen.
Welke URL's kan ik gebruiken?
Een openbaar adres dat begint met https:// en een domeinnaam gebruikt. Adressen op uw privénetwerk en gewone IP-adressen worden geweigerd. Notiondesk volgt geen redirects, dus voer het eindadres in.
Wat als ik het geheim van de handtekening kwijtraak?
Open de eindpuntpagina en klik op 'Draaien' onder 'Ondertekeningsgeheim' . Het nieuwe geheim wordt eenmaal weergegeven en het oude werkt direct niet meer. Werk uw server daarom tegelijkertijd bij.
Kan ik de evenementen later nog wijzigen?
Ja. Open de eindpuntpagina, voeg gebeurtenissen toe of verwijder ze onder Gebeurtenissen en klik vervolgens op Wijzigingen opslaan .