Webhooks
En webhook er den enkleste form for tilkobling: en HTTP-besked til en adresse, som du fastlægger. Slack, Discord og Microsoft Teams tager imod sådanne beskeder direkte som et indlæg i kanalen, og egne systemer kan stille op med dem, hvad de vil.
Typiske anvendelser: Supportadressen melder nye henvendelser i teamkanalen. Ordrebekræftelsen sætter varestyringssystemet i gang. En kundes serveralarm dukker op i Discord.
Opret et slutpunkt
Sektion kaldt “Opret et slutpunkt”- Åbn Indstillinger → Integrationer → Webhooks, og slå Aktivér webhooks til.
- Vælg Tilføj slutpunkt, og indtast et Navn og en URL.
- Vælg Slack, Discord, Microsoft Teams eller Generic JSON under Nyttelastskabelon. Skabelonen fylder Nyttelastskabelon (JSON) med et passende grundskelet, som du frit kan tilpasse.
- Test sender en prøvebesked med eksempeldata. Hos Slack og co. ser du den med det samme i kanalen.
Adressen (URL) får du hos den pågældende tjeneste:
- Slack: Opret en app med Incoming Webhooks under
api.slack.com/apps; den genererede URL er slutpunktet. - Discord: kanalindstillinger → Integrationer → Webhooks.
- Teams: i kanalen via appen Workflows med skabelonen til at sende en besked ved en webhook-anmodning.
- Egne systemer: enhver adresse, der tager imod JSON via HTTP-POST eller PUT.
Flere slutpunkter er mulige, og hvert kan slås fra for sig: Supportkanalen og dit eget script kan bestå side om side.
Udløs via regel
Sektion kaldt “Udløs via regel”Der sendes udelukkende via automatiseringen: handlingen Send webhook i en regel, med det slutpunkt du vælger som mål.
Hvad der præcis sendes, står i slutpunktets nyttelastskabelon. Her
indsætter du variabler i dobbelte krøllede parenteser, som ved
afsendelsen fyldes med data fra den udløsende mail: {{subject}},
{{from}}, {{from_name}}, {{to}}, {{cc}}, {{date}},
{{preview}} (begyndelsen af teksten), {{tags}}, {{mailbox}},
{{account_id}} og {{rule_name}}. Variabelreference under
skabelonen forklarer hver enkelt. En Slack-meddelelse til
supportkanalen ser for eksempel sådan ud:
{ "text": "Ny henvendelse fra {{from_name}}: {{subject}}" }Til egne servere
Sektion kaldt “Til egne servere”- Signatur: Udfylder du en HMAC-hemmelighed (valgfrit),
indeholder hver anmodning headeren
X-YouniqMail-Signature: sha256=…med en HMAC-SHA256-signatur af indholdet. Din server kontrollerer dermed, at beskeden kommer fra dig. - Gentagelser: Ved serverfejl (5xx) og netværksproblemer prøver YouniqMail igen op til tre gange, med pauser på 1, 2 og 4 sekunder. Afvisninger (4xx) gentages ikke. Timeoutet indstiller du pr. slutpunkt, højst 30 sekunder.
- Metode: POST er standard, PUT kun hvis dit slutpunkt kræver det. Omdirigeringer følges ikke.
Godt at vide
Sektion kaldt “Godt at vide”- Beskeden går til det slutpunkt, du angiver. Tjek adressen omhyggeligt, for enhver, der kender den, kan skrive i kanalen. Behandl webhookadresser som adgangskoder.
- Indholdet bestemmer du: Der overføres det, der står i skabelonen. Bruger du kun emne og afsender, giver du også kun dem videre.
- Pro-funktion: Webhooks hører til Pro-omfanget.