Webhooks

Actualizat la octombrie 2026

Un webhook este forma cea mai simplă de conectare: un mesaj HTTP către o adresă pe care o stabilești tu. Slack, Discord și Microsoft Teams preiau astfel de mesaje direct ca postare de canal; sistemele proprii pot face cu ele orice doresc.

Utilizări tipice: adresa de suport anunță cereri noi în canalul echipei. Confirmarea comenzii declanșează sistemul de gestiune a mărfurilor. Alarma de server a unui client apare în Discord.

Configurarea unui endpoint

1. Deschide Setări → Integrări → Webhooks și activează Activează Webhooks.
2. Alege Adaugă endpoint și introdu un Nume și URL-ul.
3. Alege la Șablon predefinit Slack, Discord, Microsoft Teams sau Generic JSON. Șablonul completează Șablon payload (JSON) cu o structură de bază potrivită, pe care o poți ajusta liber.
4. Testează trimite un mesaj de probă cu date de exemplu. La Slack și ceilalți îl vezi imediat în canal.

URL-ul îl obții de la serviciul respectiv:

• Slack: la api.slack.com/apps creezi o aplicație cu Incoming Webhooks; URL-ul generat este endpointul.
• Discord: setările canalului → Integrări → Webhooks.
• Teams: în canal, prin aplicația Workflows, cu șablonul pentru postare la primirea unei cereri webhook.
• Sisteme proprii: orice adresă care acceptă JSON prin HTTP-POST sau PUT.

Sunt posibile mai multe endpointuri, fiecare se poate dezactiva separat: canalul de suport și scriptul propriu pot coexista.

Declanșarea prin regulă

Trimiterea se face exclusiv prin automatizare: acțiunea Trimite webhook într-o regulă, cu endpointul ales de tine drept țintă.

Ce anume se trimite stă în șablonul payload al endpointului. În el inserezi variabile între acolade duble, care sunt completate la trimitere cu datele mesajului declanșator: {{subject}}, {{from}}, {{from_name}}, {{to}}, {{cc}}, {{date}}, {{preview}} (începutul textului), {{tags}}, {{mailbox}}, {{account_id}} și {{rule_name}}. Referință variabile de sub șablon explică fiecare variabilă în parte. Un mesaj Slack pentru canalul de suport arată de exemplu așa:

{ "text": "Cerere nouă de la {{from_name}}: {{subject}}" }

Pentru servere proprii

• Semnătură: dacă introduci un Secret HMAC (opțional), fiecare cerere conține antetul X-YouniqMail-Signature: sha256=… cu o semnătură HMAC-SHA256 a conținutului. Serverul tău verifică astfel că mesajul vine de la tine.
• Reîncercări: la erori de server (5xx) și probleme de rețea, YouniqMail încearcă din nou de până la trei ori, cu pauze de 1, 2 și 4 secunde. Refuzurile (4xx) nu se repetă. Timeoutul îl setezi per endpoint, cel mult 30 de secunde.
• Metodă: POST este implicit, PUT doar dacă endpointul tău o cere. Redirecționările nu sunt urmate.

Bine de știut

• Mesajul merge la endpointul pe care îl indici. Verifică URL-ul cu atenție, pentru că oricine îl cunoaște poate scrie în canal. Tratează URL-urile webhook ca pe niște parole.
• Conținutul îl stabilești tu: se transmite ce se află în șablon. Cine include doar subiectul și expeditorul, transmite mai departe doar atât.
• Funcție Pro: webhooks aparțin de volumul Pro.