Webhookar

Uppdaterad oktober 2026

En webhook är den enklaste formen av anslutning: ett HTTP-meddelande till en adress som du bestämmer. Slack, Discord och Microsoft Teams tar emot sådana meddelanden direkt som kanalinlägg; egna system kan göra vad de vill med dem.

Typiska användningar: supportadressen rapporterar nya förfrågningar i teamkanalen. Orderbekräftelsen sätter i gång affärssystemet. En kunds serverlarm dyker upp i Discord.

Ställa in en slutpunkt

1. Öppna Inställningar → Integrationer → Webhooks och slå på Aktivera webhookar.
2. Välj Lägg till slutpunkt och ange ett Namn och en URL.
3. Välj Slack, Discord, Microsoft Teams eller Generic JSON under Nyttolastmall. Mallen fyller Nyttolastmall (JSON) med ett passande grundskelett som du kan anpassa fritt.
4. Testa skickar ett provmeddelande med exempeldata. Hos Slack och liknande ser du det genast i kanalen.

URL:en får du hos respektive tjänst:

• Slack: lägg upp en app med Incoming Webhooks på api.slack.com/apps; den skapade URL:en är slutpunkten.
• Discord: kanalinställningar → Integrationer → Webhooks.
• Teams: i kanalen via appen Workflows med mallen för att publicera när en webhook-begäran tas emot.
• Egna system: varje adress som tar emot JSON via HTTP-POST eller PUT.

Flera slutpunkter är möjliga, och var och en går att stänga av för sig: supportkanalen och det egna skriptet kan finnas sida vid sida.

Utlösa via regel

Skickandet sker uteslutande via automatiseringen: åtgärden Skicka webhook i en regel, med slutpunkten du väljer som mål.

Exakt vad som skickas står i slutpunktens nyttolastmall. Där sätter du in variabler inom dubbla klammerparenteser, som fylls med den utlösande e-postens data när det skickas: {{subject}}, {{from}}, {{from_name}}, {{to}}, {{cc}}, {{date}}, {{preview}} (början av texten), {{tags}}, {{mailbox}}, {{account_id}} och {{rule_name}}. Variabelreferens under mallen förklarar var och en av dem. En Slack-rapport för supportkanalen ser ungefär ut så här:

{ "text": "Ny förfrågan från {{from_name}}: {{subject}}" }

För egna servrar

• Signatur: fyller du i en HMAC-hemlighet (valfri) innehåller varje begäran huvudet X-YouniqMail-Signature: sha256=… med en HMAC-SHA256-signatur av innehållet. Din server kontrollerar därmed att meddelandet kommer från dig.
• Upprepningar: vid serverfel (5xx) och nätverksproblem försöker YouniqMail upp till tre gånger till, med pauser på 1, 2 och 4 sekunder. Avvisningar (4xx) upprepas inte. Tidsgränsen ställer du in per slutpunkt, högst 30 sekunder.
• Metod: POST är standard, PUT bara om din slutpunkt kräver det. Omdirigeringar följs inte.

Bra att veta

• Meddelandet går till den slutpunkt du anger. Kontrollera URL:en omsorgsfullt, för alla som känner till den kan skriva i kanalen. Behandla webhook-URL:er som lösenord.
• Innehållet bestämmer du: överfört blir det som står i mallen. Den som bara sätter in ämne och avsändare lämnar också bara ut det.
• Pro-funktion: webhookar hör till Pro-omfånget.