Een webhook stuurt een gebeurtenis uit LeadForge meteen door naar een adres van jou, bijvoorbeeld van je CRM, Zapier of Make. Komt er een nieuwe lead bij of stuurt een prospect een bericht op LinkedIn, dan krijgt je systeem meteen een ondertekend JSON-bericht. Je hoeft dan niet steeds zelf de API te bevragen.
Een adres toevoegen
De link Webhooks staat op Instellingen alleen voor een eigenaar of beheerder van de werkruimte.
Vul het adres van je ontvanger in
Bij Adres van je ontvanger vul je het volledige adres in, beginnend met https://. Bij Zapier of Make is dat het adres van de webhooktrigger.Kies de gebeurtenissen
Vink onder Welke gebeurtenissen? minstens één gebeurtenis aan. Wat elke gebeurtenis betekent staat in Gebeurtenissen.Klik op Adres toevoegen
Het adres staat daarna onder Je adressen, met de stand Aan.Kopieer het geheim
Boven aan het scherm staat het geheim van het nieuwe adres. Klik op Kopiëren en zet het in je ontvanger. Daarmee controleert je ontvanger de handtekening.(Optioneel)Stuur een testaflevering
Klik bij het adres op Test. Het scherm meldt of de testaflevering is aangekomen. Zie Testaflevering.
Regels voor het adres
Voldoet het adres niet, dan zie je een van deze meldingen:
| Regel | Melding |
|---|---|
| Hoogstens 5 adressen per werkruimte | Het formulier verdwijnt en het scherm zegt: Je hebt al 5 adressen. Verwijder er eerst een om een nieuw adres toe te voegen. |
| Een geldig adres | Dit is geen geldig adres. Begin met https:// |
| Het adres begint met https:// | Gebruik een adres dat met https:// begint. |
| Hoogstens 2000 tekens | Dit adres is te lang. |
| Een openbare website | Dit adres kan niet: gevolgd door de reden hieronder. |
| Minstens één gebeurtenis | Kies minstens één gebeurtenis. |
De redenen waarom een adres geen openbare website is:
- alleen een website op de gewone poort: het adres heeft een andere poort dan 443 of 80.
- geen inloggegevens in het adres: het adres bevat een gebruikersnaam of wachtwoord.
- dit adres is geen openbare website: het adres wijst naar localhost, een eigen netwerk of een ander niet-openbaar adres.
- de website ... is niet bereikbaar: de naam van de website is niet te vinden.
Het geheim
Elk adres krijgt een eigen geheim: whsec_ gevolgd door 48 tekens. Na het toevoegen staat het één keer op het scherm, met de tekst: Kopieer het nu: het is hierna niet meer te zien. Je ontvanger controleert er de handtekening mee.
Let op
Je adressen
Onder Je adressen staat per adres welke gebeurtenissen het volgt en of het aan of uit staat. Per adres kun je:
- Test: een testaflevering sturen. Dit kan alleen als het adres aan staat.
- Uitzetten of Aanzetten: tijdelijk niets meer of weer wel afleveren.
- Verwijderen: het adres en zijn geheim weghalen. Er gaat daarna niets meer naartoe.
Na 20 mislukte afleveringen op rij zet LeadForge een adres zelf uit. Zie Aflevering en herhalen.
Laatste afleveringen
Onder Laatste afleveringen staan de 20 laatste afleveringen van je werkruimte, met wanneer, de gebeurtenis, het adres en de uitkomst. Een testaflevering staat er met (test) achter de gebeurtenis.
| Uitkomst | Betekenis |
|---|---|
| Aangekomen, met de status | Je ontvanger antwoordde met een status in de 200-reeks. |
| Mislukt | Ook na de laatste poging niet aangekomen. Eronder staat de fout en, bij meer dan één poging, het aantal pogingen. |
| Bezig | De aflevering loopt nog. |
Problemen oplossen
- Ik zie Webhooks niet op Instellingen. Je bent geen eigenaar of beheerder van de werkruimte. Vraag iemand met die rol.
- Er komt niets aan. Kijk onder Laatste afleveringen naar de fout. Staat het adres op Uit, zet het dan weer aan.
- De fout noemt een doorverwijzing. LeadForge volgt geen doorverwijzing. Geef het eindadres op.
- Ik kan geen adres meer toevoegen. Je hebt er al 5. Verwijder er eerst een.
Verder lezen
- Gebeurtenissen De vijf gebeurtenissen en de data die bij elke gebeurtenis meekomt.
- Handtekening controleren Controleren dat een aflevering echt van LeadForge komt met X-LeadForge-Signature.
- Aflevering en herhalen Pogingen, wat als gelukt telt, doorverwijzingen, automatisch uitzetten en de testaflevering.