Leads doorsturen met webhooks
Met een webhook gaan nieuwe leads, klachten en reservaties meteen naar je CRM, Zapier, Make of eigen software, ondertekend en met automatische nieuwe pogingen.
Met een webhook stuurt Chat on Page elke nieuwe lead, klacht of reservatie meteen naar een adres dat jij kiest. Handig voor Zapier, Make, een CRM zonder kant-en-klare koppeling of je eigen software.
Een webhook maken
- Ga in het menu naar Verbindingen → Webhooks.
- Klik op Nieuwe webhook.
- Vul in:
- Naam: zodat je later weet waarvoor hij dient.
- URL: het adres dat je van je CRM, Zapier of Make krijgt.
- Events: wat je wilt doorsturen.
- Bij Toegang tot alle bots kies je alle bots, of zet je het uit en kies je bij Bots een selectie.
- Klik op Aanmaken. Je ziet nu het geheim van de webhook. Kopieer het.
- Klik bij de webhook op Testen om een eerste bericht te sturen.
Welke events?
- Nieuwe lead: een bezoeker vraagt om gecontacteerd te worden.
- Opvolging van een lead gewijzigd
- Nieuwe klacht of bugmelding
- Nieuwe reservatie, Reservatie gewijzigd en Reservatie geannuleerd
Elk event komt als JSON met een POST. Welke velden erin staan, lees je in de API-documentatie.
De handtekening controleren
Elk bericht heeft een handtekening in de header X-ChatOnPage-Signature. Controleer die met het geheim, dan weet je zeker dat het bericht van Chat on Page komt. Je vindt het geheim terug via Geheim. Daar maak je ook een Nieuw geheim aan. Vervang het dan ook bij de ontvanger, want vanaf dat moment worden berichten met het nieuwe geheim ondertekend.
Als een levering mislukt
- Antwoordt de ontvanger niet met een 2xx-code, dan probeert Chat on Page het opnieuw: na 1 minuut, 5 minuten, 30 minuten, 2 uur, 6 uur en 12 uur.
- Via Leveringen zie je de laatste berichten en het antwoord van de ontvanger.
- Lukt het bij 5 events na elkaar niet, dan wordt de webhook Uitgeschakeld. Dat gebeurt ook meteen als de ontvanger antwoordt met 410 (Gone).
- Je krijgt dan een mail "Webhook ... is uitgeschakeld".
- Werkt de ontvanger weer? Klik op Aanzetten en daarna op Mislukte opnieuw versturen. Dat stuurt de mislukte events van de voorbije 7 dagen opnieuw.
Goed om te weten
- Enkel de beheerder van het account (rol Beheerder) ziet en beheert webhooks.
- Met Pauzeren zet je een webhook tijdelijk stil.
- Leads blijven altijd in het portaal staan, ook als een webhook faalt. Zie Leads.
- Webhooks die software via de API aanmaakte, staan ook in de lijst. Zie API.
- Gebruik je Slack, Teams, HubSpot, Pipedrive of een helpdesk? Dan zijn de koppelingen van een bot eenvoudiger.