Hoppa till huvudinnehåll

Webhooks — koppla Smartsupp till Make, n8n och dina egna verktyg

Konfigurera webhooks direkt i instrumentpanelen och få realtidsaviseringar om konversationer, kontakter och besökare i Make, n8n eller ditt eget system.

Med webhooks kan Smartsupp skicka realtidsaviseringar till valfri URL — i samma ögonblick som en konversation öppnas, en kontakt skapas eller ett meddelande levereras vet ditt system om det. Den här artikeln förklarar vad webhooks är, hur du konfigurerar dem i instrumentpanelen och hur du kopplar dem till automatiseringsplattformar som Make och n8n.

Vi har delat upp artikeln i några avsnitt:

Vad är webhooks bra för?

En webhook är ett automatiskt HTTP-meddelande som Smartsupp skickar till en URL du väljer varje gång en vald händelse inträffar. Istället för att fråga efter ändringar får dina verktyg data i samma ögonblick som något händer.

Typiska användningsfall:

  • Automatiseringsplattformar — utlös arbetsflöden i Make, n8n eller liknande verktyg: lägg till kontakter i ett CRM, skicka aviseringar till Slack eller logga leads i ett kalkylblad

  • Interna system — mata in konversations- och kontaktdata i realtid till instrumentpaneler, datalager eller ärendesystem

  • Aviseringar — varna ditt team när konversationer betygsätts eller när meddelandeleverans misslyckas

Tips: Webhooks är tillgängliga från Plus-planen och uppåt — Plus inkluderar 1 webhook, Expert 3 och Ultimate erbjuder en anpassad gräns. Jämför planer →


Skapa en webhook

Det tar bara några steg att konfigurera en webhook i Smartsupp-instrumentpanelen:

  • 1. Öppna Settings och gå till avsnittet Webhooks.

  • 2. Klicka för att lägga till en ny webhook och ange din endpoint-URL — adressen dit Smartsupp skickar händelsedata.

  • 3. Välj de händelser du vill ta emot (hela listan finns 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-innehåll.

Obs: Tidigare konfigurerade webhooks fortsätter att fungera som vanligt. Vi arbetar med att göra alla befintliga webhooks synliga och hanterbara från den nya instrumentpanelssektionen.


Tillgängliga händelser

Smartsupp kan meddela din endpoint om händelser i tre kategorier. Välj bara de händelser som ditt arbetsflöde faktiskt behöver — det håller din endpoint lätt och undviker onödig trafik.

Kontakter

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Konversationer

  • conversation.opened

  • conversation.closed

  • conversation.closed_by_contact

  • conversation.rated

  • conversation.agent_assigned

  • conversation.agent_unassigned

  • conversation.agent_joined

  • conversation.agent_left

  • conversation.agent_replied

  • conversation.bot_replied

  • conversation.contact_replied

  • conversation.message_delivered

  • conversation.message_delivery_failed

Besökare

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Relaterade resurser: Smartsupps utvecklardokumentation — fullständiga JSON-payload-scheman för varje händelsetyp.


Testa din webhook

Innan du går live, använd den inbyggda testfunktionen för att verifiera att din endpoint kan nås och att ditt Make- eller n8n-scenario är korrekt konfigurerat.

Klicka på Send test i webhook-inställningarna i instrumentpanelen. Smartsupp skickar en exempel-payload till din endpoint-URL. Kontrollera i den mottagande tjänsten att datan 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 Webhook-noden till dess produktions-URL och ser till att arbetsflödet är aktivt.


Leverans, omförsök och säkerhet

Smartsupp är byggt för att leverera webhook-händelser tillförlitligt, även när din endpoint tillfälligt inte kan nås.

  • Format — alla händelser skickas som HTTP POST-förfrågningar med en JSON-body som beskriver händelsen och dess data

  • Svar — din endpoint bör svara med en 2xx HTTP-statuskod så snabbt som möjligt; långsamma svar kan fördröja omförsök

  • Omförsök — om leveransen misslyckas försöker Smartsupp igen med ökande intervall i upp till 3 dagar

  • Automatisk inaktivering — endpoints som misslyckas ihållande inaktiveras automatiskt; du kan när som helst aktivera dem igen i instrumentpanelen

  • Säkerhet — varje webhook-förfrågan är signerad så att du kan verifiera att den verkligen kommer från Smartsupp; se docs.smartsupp.com för detaljer om signaturverifiering

Obs: Om din endpoint inaktiveras på grund av upprepade fel aktiverar du den igen i Settings → Webhooks när du har åtgärdat problemet. Smartsupp återupptar sändningen av händelser direkt.


Koppla Smartsupp till Make eller n8n

Att koppla Smartsupp till en automatiseringsplattform tar fyra steg. Processen är densamma för Make och n8n — endast trigger-noden skiljer sig.

  • 1. I Make lägger du till en Webhooks → Custom webhook-trigger och kopierar den genererade URL:en. I n8n lägger du till en Webhook-triggernod och kopierar dess produktions-URL.

  • 2. I Smartsupp går du till Settings → 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å Send test så att Make eller n8n fångar datastrukturen — bygg sedan resten av ditt scenario ovanpå den.

Tips: I Make aktiverar du ditt scenario innan du skickar testet — annars fångas inte webhook-datan. I n8n använder du produktions-URL:en (inte test-URL:en) när du konfigurerar Smartsupp-webhooken.


Vad händer nu?

  • Smartsupp REST API — utforska hela API:et för programmatisk läsning och skrivning av Smartsupp-data.

  • Automatiseringar — konfigurera regelbaserade automatiseringar som utlöses direkt i Smartsupp utan externt verktyg.

  • Integrationsöversikt — 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 gärna till!

Fick du svar på din fråga?