Skicka händelser till ditt eget system med webhooks

En webhook låter IDup ringa en av dina webbadresser i samma ögonblick som något händer, till exempel när en faktura betalas. Varje leverans signeras och upprepas om ditt system inte svarar.

Lägg till en endpunkt

1. Öppna Webhooks flik och tryck Lägg till endpunkt.
2. Ange en Namn och URL. Den måste vara offentligt nåbar. Adresser inom ett privat nätverk avvisas av säkerhetsskäl.
3. Kryssa för Händelser du vill.
4. Valfritt: välj en API-nyckel. Slutpunkten tar då endast emot händelser som denna nyckel får läsa.
5. Press Spara. IDup visar Din signeringshemlighet en gång. Förvara den säkert.

Händelser

• Faktura skapad, Faktura betald, Betalning mottagen
• Ny kund, Ny kontakt, Ny lead, Nytt ärende
• Offert accepterad — en offert som en kund accepterade

Varje leverans har tre rubriker: händelsenamn, ett leveransnummer och signaturen. En omförsök behåller samma leveransnummer, så ditt system kan känna igen dubbletter.

Kontrollera signaturen

Ditt system bör beräkna en HMAC-SHA256 över tiden och det råa innehållet med din hemlighet, jämföra det med signaturen och vägra en tid äldre än 5 minuter. Tryck Verifiera signatur och exempel för färdig kod.

Testa, pausa och förnya

• Skicka test skickar ett testevenemang och visar HTTP-koden och tiden det tog.
• Paus stoppar leveranser; Aktivera startar dem igen.
• Hemlig rulle skapar en ny hemlighet. Den gamla slutar fungera omedelbart.
• Radera tar bort slutpunkten. Dess logg sparas.

Försök och loggen

Din adress måste svara med en 2xx-kod inom 5 sekunder. Omdirigeringar följs inte. Om det misslyckas försöker IDup igen efter 1 minut, 5 minuter, 30 minuter, 2 timmar och 12 timmar. Efter sjätte försöket markeras leveransen Gett upp.

Loggen visar varje försök med händelse, slutpunkt, försök, HTTP-kod, varaktighet och början av svaret. Status är Väntar, Levererad, Misslyckades eller Gett upp. Använd Skicka igen för att skicka en leverans igen.