Automatiseringar och webhooks

Automatiseringar skickar händelser från dina chattar till de andra verktyg ditt företag använder. När en konversation startar, en besökare skickar ett meddelande, AI:n svarar eller en chatt avslutas skickar Pingu informationen till en URL du väljer.

Peka den mot Zapier, Make eller n8n för att koppla Pingu till tusentals appar utan kod, eller mot ditt eget API för att bygga exakt det flöde du behöver.

Konfigurera en webhook

Skaffa en webhook-URL. Skapa en webhook-trigger i verktyget som ska ta emot händelserna, till exempel Catch Hook i Zapier, en anpassad webhook i Make eller en Webhook-nod i n8n, och kopiera dess URL. Du kan också använda en https://-adress i ditt eget system.
Öppna Automatiseringar i instrumentpanelen och välj Lägg till webhook.
Klistra in URL:en, lägg till en beskrivning och välj vilka händelser som ska skickas.
Välj Spara.
Välj Skicka testhändelse. Leveranshistoriken visar om ditt system tog emot den, med svarskod och tid.

Händelser du kan skicka

Händelse	När den skickas
`conversation.started`	En besökare startar en ny chatt
`message.received`	En besökare skickar ett meddelande
`message.ai_replied`	AI:n svarar besökaren
`conversation.ended`	En chatt stängs

Kontrollera signaturen

Varje webhook har en egen signeringsnyckel. Pingu signerar varje förfrågan i ett huvud, så att ditt system kan kontrollera att händelsen verkligen kommer från Pingu:

X-Pingu-Signature: t=1760000000,v1=<HMAC-SHA256 of "<t>.<body>">

Det är valfritt att kontrollera signaturen, men rekommenderat för dina egna API:er.

Pålitlig leverans

Om ditt system inte svarar försöker Pingu igen efter 1 minut, 5 minuter, 30 minuter, 2 timmar och 6 timmar. En webhook som fortsätter att misslyckas i 3 dagar stängs av automatiskt, och du kan aktivera den igen med ett klick.

Vanliga problem

Testhändelsen misslyckas. Kontrollera att URL:en är rätt, börjar med https:// och att det mottagande verktyget är igång och lyssnar efter förfrågningar.

Min webhook stängdes av. Den misslyckades 3 dagar i rad. Åtgärda det mottagande systemet och aktivera sedan webhooken igen under Automatiseringar.