Med webhooks kan Smartsupp skicka aviseringar i realtid till valfri URL — så snart en konversation öppnas, en kontakt skapas eller ett meddelande levereras får ditt system veta det. Den här artikeln förklarar vad webhooks är, hur du konfigurerar dem i din instrumentpanel och hur du ansluter dem till automatiseringsplattformar som Make och n8n.
Vi har delat upp artikeln i några avsnitt:
Vad kan webhooks användas till?
En webhook är ett automatiskt HTTP-meddelande som Smartsupp skickar till en URL som du väljer när en vald händelse inträffar. I stället för att regelbundet fråga efter ändringar får dina verktyg data skickade till sig så snart något händer.
Vanliga användningsområden är:
Automatiseringsplattformar — starta arbetsflöden i Make, n8n eller liknande verktyg för att lägga till kontakter i ett CRM, skicka aviseringar till Slack eller registrera leads i ett kalkylblad
Interna system — skicka konversations- och kontaktdata till instrumentpaneler, datalager eller ärendehanteringssystem i realtid
Aviseringar — meddela ditt team när konversationer får betyg eller när meddelandeleveransen misslyckas
Tips: Webhooks är tillgängliga med paketet Plus eller ett högre paket — Plus innehåller 1 webhook, Expert innehåller 3 och Ultimate erbjuder en anpassad gräns. Jämför paket →
Skapa en webhook
Det krävs bara några få steg för att konfigurera en webhook i din Smartsupp-instrumentpanel:
1. Öppna Inställningar och gå till avsnittet Webhooks .
2. Klicka för att lägga till en ny webhook och ange din URL för slutpunkten — adressen dit Smartsupp ska skicka händelsedata.
3. Välj de händelser du vill ta emot (se hela listan i nästa avsnitt).
4. Spara webhooken. Från och med då levereras de valda händelserna som HTTP POST-förfrågningar med JSON-nyttolaster.
Obs: Tidigare konfigurerade webhooks fortsätter att fungera som vanligt. Arbete pågår för att göra alla befintliga webhooks synliga och möjliga att hantera från det nya avsnittet i instrumentpanelen.
⚠️ Har du skapat webhooks tidigare? Äldre webhooks visas inte i det här avsnittet ännu — de fortsätter att fungera som tidigare. Vi slår ihop det gamla och det nya systemet så att allt kan hanteras på ett ställe.
Tillgängliga händelser
Smartsupp kan meddela din slutpunkt om händelser i tre kategorier. Välj bara de händelser som ditt arbetsflöde faktiskt behöver — det håller belastningen på slutpunkten nere och undviker onödig trafik.
Kontakter
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Konversationer
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Besökare
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Relaterade resurser: Smartsupps utvecklardokumentation — fullständiga scheman för JSON-nyttolaster för varje händelsetyp.
Testa din webhook
Använd den inbyggda testfunktionen innan du tar webhooken i drift för att kontrollera att din slutpunkt är nåbar och att ditt scenario i Make eller n8n är korrekt konfigurerat.
I inställningarna för din webhook i instrumentpanelen klickar du på Skicka test. Smartsupp skickar en exempelnyttolast till din slutpunkts URL. Kontrollera din mottagande tjänst för att bekräfta att data kom fram i förväntat format.
Tips: I Make måste ditt scenario vara aktivt och lyssna innan du skickar testet. I n8n byter du till Webhook-nodens produktions-URL och ser till att arbetsflödet är aktivt.
Leverans, återförsök och säkerhet
Smartsupp är utformat för att leverera webhook-händelser tillförlitligt, även när din slutpunkt tillfälligt är otillgänglig.
Format — alla händelser skickas som HTTP POST-förfrågningar med en JSON-kropp som beskriver händelsen och dess data
Svar — din slutpunkt bör svara med en HTTP-statuskod i 2xx-serien så snabbt som möjligt; långsamma svar kan fördröja återförsök
Återförsök — om leveransen misslyckas gör Smartsupp nya försök med allt längre intervall i upp till 3 dagar
Automatisk inaktivering — slutpunkter där fel fortsätter att uppstå inaktiveras automatiskt; du kan när som helst aktivera dem igen i instrumentpanelen
Säkerhet — varje webhook-förfrågan signeras så att du kan verifiera att den verkligen kommer från Smartsupp; se docs.smartsupp.com för detaljer om signaturverifieringen
Obs: Om din slutpunkt inaktiveras på grund av upprepade fel kan du aktivera den igen i Inställningar → Webhooks efter att du har åtgärdat det bakomliggande problemet. Smartsupp börjar omedelbart skicka händelser igen.
Anslut Smartsupp till Make eller n8n
Det krävs fyra steg för att ansluta Smartsupp till en automatiseringsplattform. Processen är densamma för Make och n8n — bara utlösarnoden skiljer sig åt.
1. I Make, lägg till en utlösare av typen Webhooks → Anpassad webhook och kopiera den genererade URL:en. I n8n, lägg till en utlösarnod av typen Webhook och kopiera dess produktions-URL.
2. I Smartsupp går du till Inställningar → Webhooks, skapar en ny webhook och klistrar in den kopierade URL:en.
3. Välj de händelser du behöver och spara webhooken.
4. Klicka på Skicka test så att Make eller n8n fångar upp datastrukturen — bygg sedan resten av ditt scenario eller arbetsflöde utifrån den.
Tips: I Make aktiverar du ditt scenario innan du skickar testet — annars fångas inte data från webhooken upp. I n8n använder du produktions-URL:en (inte test-URL:en) när du konfigurerar Smartsupp-webhooken.
Vad är nästa steg?
Smartsupp REST API — utforska hela API:et för att läsa och skriva Smartsupp-data programmatiskt.
Automatiseringar — konfigurera regelbaserade automatiseringar som utlöses direkt i Smartsupp utan ett externt verktyg.
Översikt över integrationer — se alla tillgängliga inbyggda integrationer med CRM-system, e-handelsplattformar och mer.
💡 Behöver du mer hjälp? Kontakta vårt supportteam — vi hjälper dig gärna!