Zapier, Make of n8n koppelen met webhooks

Wat het doet

• Tijdens en na het gesprek: Twilper verstuurt een JSON-bericht bij de gebeurtenissen die je kiest.
• Gebeurtenissen: conversation.created, message.created, lead.captured, conversation.resolved, call.completed, call.missed, call.summary en appointment.booked.
• Elk bericht is ondertekend, zodat je kunt controleren dat het van Twilper komt.

Wat je nodig hebt

• Een account bij Zapier, Make of n8n.
• Een https-URL om berichten op te vangen.

Stap 1: maak een ontvanger

• Zapier: maak een Zap met de trigger "Webhooks by Zapier" → "Catch Hook" en kopieer de URL.
• Make: maak een scenario met "Webhooks" → "Custom webhook" en kopieer het adres.
• n8n: voeg een "Webhook"-node toe en kopieer de productie-URL.

Stap 2: voeg de webhook toe in Twilper

1. 1

   Stap 1: Open de wizard

   Ga naar "Integraties" en klik op de kaart "Zapier · Make · n8n" op "Instellen".

   

2. 2

   Stap 2: Plak de URL en kies gebeurtenissen

   Plak de URL bij "Webhook-URL (https)", geef eventueel een "Omschrijving (optioneel)" en vink onder "Gebeurtenissen" aan wat je wilt ontvangen. Klik op "Webhook opslaan".

   

Stap 3: test en bouw verder

1. 1

   Stap 1: Stuur een test

   Klik bij je webhook of op de kaart op "Test". Zapier, Make of n8n ziet dan een voorbeeldbericht met alle velden.

2. 2

   Stap 2: Bouw de vervolgstappen

   Koppel in Zapier, Make of n8n de velden aan je volgende stap en zet de automatisering aan.

Regels en instellingen

• Mislukte afleveringen worden automatisch opnieuw geprobeerd: tot 6 pogingen, na 1 minuut, 5 minuten, 30 minuten, 2 uur en 6 uur.
• In het "Afleverlog" zie je per bericht of het aankwam.
• Onder "Handtekening controleren in je eigen systeem" staat hoe je de HMAC-handtekening controleert.
• Webhooks versturen klantgegevens; ze werken alleen met een getekende DPA.

Testen

• Gebruik "Test" en kijk daarna in het "Afleverlog" of het antwoord 2xx was.

Veelvoorkomende problemen

• De test geeft geen 2xx: staat je Zap of scenario aan, en klopt de URL? Zapier en Make tonen een test pas als de trigger luistert.
• Dubbele berichten: bij een herhaalpoging kan een bericht twee keer aankomen. Gebruik het id in het bericht om dubbel werk te voorkomen.
• De oude pagina "Webhooks" in het menu werkt nog, maar de nieuwe webhooks onder Integraties hebben meer gebeurtenissen, herhaalpogingen en een afleverlog.