Webhook-urile permit Smartsupp să trimită notificări în timp real către orice URL ales de dvs. — în momentul în care se deschide o conversație, se creează un contact sau se livrează un mesaj, sistemul dvs. află imediat. Acest articol explică ce sunt webhook-urile, cum le configurați în panoul de control și cum le conectați la platforme de automatizare precum Make și n8n.

Am împărțit articolul în câteva secțiuni:

La ce sunt bune webhook-urile?

Un webhook este un mesaj HTTP automat pe care Smartsupp îl trimite către un URL ales de dvs. ori de câte ori are loc un eveniment selectat. În loc să interogați după schimbări, instrumentele dvs. primesc datele în momentul în care se întâmplă ceva.

Cazuri de utilizare tipice:

Platforme de automatizare — declanșați fluxuri de lucru în Make, n8n sau instrumente similare: adăugarea contactelor într-un CRM, notificări în Slack, înregistrarea lead-urilor într-un tabel
Sisteme interne — transmiteți date despre conversații și contacte în timp real către dashboard-uri, depozite de date sau sisteme de tichete
Notificări — alertați echipa când o conversație este evaluată sau când livrarea unui mesaj eșuează

Sfat: Webhook-urile sunt disponibile de la planul Plus în sus — Plus include 1 webhook, Expert 3, iar Ultimate oferă o limită personalizată. Comparați planurile →

Creați un webhook

Configurarea unui webhook durează doar câțiva pași în panoul de control Smartsupp:

1. Deschideți Settings și mergeți la secțiunea Webhooks.
2. Faceți clic pentru a adăuga un webhook nou și introduceți endpoint URL — adresa la care Smartsupp va trimite datele evenimentelor.
3. Selectați evenimentele pe care doriți să le primiți (lista completă în secțiunea următoare).
4. Salvați webhook-ul. Din acel moment, evenimentele selectate sunt livrate ca cereri HTTP POST cu conținut JSON.

Notă: Webhook-urile configurate anterior continuă să funcționeze normal. Lucrăm ca toate webhook-urile existente să devină vizibile și gestionabile din noua secțiune a panoului.

Evenimente disponibile

Smartsupp poate notifica endpoint-ul dvs. despre evenimente din trei categorii. Selectați doar evenimentele de care fluxul dvs. de lucru are cu adevărat nevoie — astfel endpoint-ul rămâne suplu și evitați traficul inutil.

Contacte

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Conversații

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

Vizitatori

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Resurse conexe: Documentația pentru dezvoltatori Smartsupp — scheme JSON complete ale payload-ului pentru fiecare tip de eveniment.

Testați webhook-ul

Înainte de lansare, folosiți funcția de test integrată pentru a verifica dacă endpoint-ul este accesibil și dacă scenariul dvs. din Make sau n8n este configurat corect.

Din setările webhook-ului din panou, faceți clic pe Send test. Smartsupp va trimite un payload de exemplu către endpoint URL-ul dvs. Verificați în serviciul receptor că datele au sosit în formatul așteptat.

Sfat: În Make, scenariul trebuie să fie activ și să asculte înainte de a trimite testul. În n8n, comutați nodul Webhook pe URL-ul de producție și asigurați-vă că fluxul de lucru este activ.

Livrare, reîncercări și securitate

Smartsupp este conceput să livreze evenimentele webhook în mod fiabil, chiar și atunci când endpoint-ul dvs. este temporar indisponibil.

Format — toate evenimentele sunt trimise ca cereri HTTP POST cu un corp JSON care descrie evenimentul și datele sale
Răspuns — endpoint-ul dvs. ar trebui să răspundă cu un cod de stare HTTP 2xx cât mai repede posibil; răspunsurile lente pot întârzia reîncercările
Reîncercări — dacă livrarea eșuează, Smartsupp reîncearcă la intervale crescătoare timp de până la 3 zile
Dezactivare automată — endpoint-urile care eșuează persistent sunt dezactivate automat; le puteți reactiva în panou oricând
Securitate — fiecare cerere webhook este semnată, astfel încât să puteți verifica dacă provine cu adevărat de la Smartsupp; consultați docs.smartsupp.com pentru detaliile verificării semnăturii

Notă: Dacă endpoint-ul dvs. este dezactivat din cauza erorilor repetate, reactivați-l în Settings → Webhooks după remedierea problemei. Smartsupp reia imediat trimiterea evenimentelor.

Conectați Smartsupp la Make sau n8n

Conectarea Smartsupp la o platformă de automatizare durează patru pași. Procesul este același pentru Make și n8n — diferă doar nodul de trigger.

1. În Make, adăugați un trigger Webhooks → Custom webhook și copiați URL-ul generat. În n8n, adăugați un nod trigger Webhook și copiați URL-ul său de producție.
2. În Smartsupp, mergeți la Settings → Webhooks, creați un webhook nou și lipiți URL-ul copiat.
3. Selectați evenimentele necesare și salvați webhook-ul.
4. Faceți clic pe Send test pentru ca Make sau n8n să capteze structura datelor — apoi construiți restul scenariului pe ea.

Sfat: În Make, activați scenariul înainte de a trimite testul — altfel datele webhook-ului nu vor fi captate. În n8n, folosiți URL-ul de producție (nu cel de test) când configurați webhook-ul Smartsupp.

Ce urmează?

Smartsupp REST API — explorați API-ul complet pentru citirea și scrierea programatică a datelor Smartsupp.
Automatizări — configurați automatizări bazate pe reguli care se declanșează direct în Smartsupp fără instrument extern.
Prezentare generală a integrărilor — vedeți toate integrările native disponibile cu CRM-uri, platforme de e-commerce și altele.

💡 Aveți nevoie de mai mult ajutor? Contactați echipa noastră de suport — vă ajutăm cu plăcere!

Webhook-uri — conectați Smartsupp la Make, n8n și propriile instrumente