Webhooker

Oppdatert oktober 2026

En webhook er den enkleste formen for tilkobling: en HTTP-melding til en adresse du bestemmer. Slack, Discord og Microsoft Teams tar imot slike meldinger direkte som et kanalinnlegg; egne systemer kan gjøre med dem hva de vil.

Typiske bruksområder: Supportadressen melder nye henvendelser i teamkanalen. Ordrebekreftelsen setter i gang varelagersystemet. En kundes serveralarm dukker opp i Discord.

Sette opp et endepunkt

1. Åpne Innstillinger → Integrasjoner → Webhooks og slå på Aktiver webhooker.
2. Velg Legg til endepunkt og skriv inn et Navn og URL-en.
3. Velg Slack, Discord, Microsoft Teams eller Generic JSON under Nyttelastmal. Malen fyller Nyttelastmal (JSON) med et passende grunnskjelett som du kan tilpasse fritt.
4. Test sender en prøvemelding med eksempeldata. Hos Slack og lignende ser du den med det samme i kanalen.

URL-en får du hos den aktuelle tjenesten:

• Slack: opprett en app med Incoming Webhooks under api.slack.com/apps; den genererte URL-en er endepunktet.
• Discord: kanalinnstillinger → Integrasjoner → Webhooker.
• Teams: i kanalen via Workflows-appen med malen for å poste når en webhook-forespørsel mottas.
• Egne systemer: enhver adresse som tar imot JSON med HTTP-POST eller PUT.

Flere endepunkter er mulig, og hvert av dem kan slås av for seg: supportkanalen og det egne skriptet kan bestå side om side.

Utløse via regel

Sendingen skjer utelukkende via automatiseringen: handlingen Send webhook i en regel, med endepunktet du velger som mål.

Hva som sendes, står i endepunktets nyttelastmal. Der setter du inn variabler i doble krøllparenteser, som fylles med data fra den utløsende e-posten når det sendes: {{subject}}, {{from}}, {{from_name}}, {{to}}, {{cc}}, {{date}}, {{preview}} (begynnelsen av teksten), {{tags}}, {{mailbox}}, {{account_id}} og {{rule_name}}. Variabelreferanse under malen forklarer hver enkelt. En Slack-melding for supportkanalen ser omtrent slik ut:

{ "text": "Ny henvendelse fra {{from_name}}: {{subject}}" }

For egne servere

• Signatur: Legger du inn en HMAC-hemmelighet (valgfritt), inneholder hver forespørsel headeren X-YouniqMail-Signature: sha256=… med en HMAC-SHA256-signatur av innholdet. Serveren din kontrollerer med den at meldingen kommer fra deg.
• Gjentakelser: Ved serverfeil (5xx) og nettverksproblemer prøver YouniqMail på nytt opptil tre ganger, med pauser på 1, 2 og 4 sekunder. Avvisninger (4xx) gjentas ikke. Tidsavbruddet stiller du inn per endepunkt, høyst 30 sekunder.
• Metode: POST er standard, PUT bare når endepunktet ditt krever det. Videresendinger følges ikke.

Greit å vite

• Meldingen går til endepunktet du angir. Kontroller URL-en nøye, for alle som kjenner den, kan skrive i kanalen. Behandle webhook-URL-er som passord.
• Innholdet bestemmer du: Det som overføres, er det som står i malen. Den som bare setter inn emne og avsender, gir også bare fra seg det.
• Pro-funksjon: Webhooker hører til Pro-omfanget.