Direct la conținutul principal

Webhook-uri: conectați Smartsupp la Make, n8n și instrumentele dvs.

Notificări despre evenimente în timp real de la Smartsupp către orice URL — configurați webhook-uri, alegeți evenimente și conectați-vă la Make sau n8n în câteva minute.

Scris de Michal Jindra

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. este informat. Acest articol explică ce sunt webhook-urile, cum să le configurați în panoul de control și cum să le conectați la platforme de automatizare precum Make și n8n.

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

La ce sunt utile 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ă verifice periodic dacă există modificări, instrumentele dvs. primesc datele imediat ce se întâmplă ceva.

Printre cazurile de utilizare obișnuite se numără:

  • Platforme de automatizare — declanșați fluxuri de lucru în Make, n8n sau instrumente similare pentru a adăuga contacte într-un CRM, a publica notificări în Slack sau a înregistra lead-uri într-o foaie de calcul

  • Sisteme interne — transmiteți date despre conversații și contacte către panouri de control, depozite de date sau sisteme de gestionare a tichetelor în timp real

  • Notificări — alertați echipa dvs. când conversațiile sunt evaluate sau când livrarea mesajelor eșuează

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

Creați un webhook

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

  • 1. Deschideți Setări și accesați secțiunea Webhook-uri .

  • 2. Faceți clic pentru a adăuga un webhook nou și introduceți URL-ul endpoint-ului dvs. — adresa la care Smartsupp va trimite datele despre evenimente.

  • 3. Selectați evenimentele pe care doriți să le primiți (consultați lista completă în secțiunea următoare).

  • 4. Salvați webhook-ul. Din acel moment, evenimentele selectate sunt livrate sub formă de cereri HTTP POST cu date în format JSON.

Notă: Webhook-urile configurate anterior continuă să funcționeze normal. Lucrăm pentru ca toate webhook-urile existente să fie vizibile și să poată fi gestionate din noua secțiune a panoului de control.

⚠️ Ați creat webhook-uri în trecut? Webhook-urile mai vechi nu apar încă în această secțiune — ele continuă să funcționeze ca înainte. Unificăm sistemul vechi cu cel nou, astfel încât totul să poată fi gestionat într-un singur loc.

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, reduceți sarcina asupra endpoint-ului ș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ție Smartsupp pentru dezvoltatori — scheme complete ale datelor JSON pentru fiecare tip de eveniment.

Testați webhook-ul dvs.

Înainte de a începe utilizarea în producție, folosiți funcționalitatea de testare integrată pentru a verifica dacă endpoint-ul dvs. este accesibil și dacă scenariul dvs. din Make sau n8n este configurat corect.

Din setările webhook-ului din panoul de control, faceți clic pe Trimiteți testul. Smartsupp va trimite un set de date de exemplu către URL-ul endpoint-ului dvs. Verificați serviciul care primește datele pentru a confirma că acestea au ajuns în formatul așteptat.

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

Livrare, reîncercări și securitate

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

  • Format — toate evenimentele sunt trimise sub formă de 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 din ce în ce mai mari, timp de până la 3 zile

  • Dezactivare automată — endpoint-urile care eșuează în mod persistent sunt dezactivate automat; le puteți reactiva oricând în panoul de control

  • Securitate — fiecare cerere webhook este semnată, astfel încât să puteți verifica dacă provine într-adevăr de la Smartsupp; consultați docs.smartsupp.com pentru detalii despre verificarea semnăturii

Notă: Dacă endpoint-ul dvs. este dezactivat din cauza unor eșecuri repetate, reactivați-l în Setări → Webhook-uri după ce remediați problema care le-a cauzat. Smartsupp va relua imediat trimiterea evenimentelor.

Conectați Smartsupp la Make sau n8n

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

  • 1. În Make, adăugați un declanșator Webhook-uri → Webhook personalizat și copiați URL-ul generat. În n8n, adăugați un nod de declanșare Webhook și copiați URL-ul său de producție.

  • 2. În Smartsupp, accesați Setări → Webhook-uri, creați un webhook nou și lipiți URL-ul copiat.

  • 3. Selectați evenimentele de care aveți nevoie și salvați webhook-ul.

  • 4. Faceți clic pe Trimiteți testul pentru ca Make sau n8n să preia structura datelor — apoi construiți restul scenariului sau al fluxului de lucru pe baza acesteia.

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

Ce urmează?

  • Smartsupp REST API — explorați întregul API pentru a citi și scrie date Smartsupp în mod programatic.

  • Automatizări — configurați automatizări bazate pe reguli care se declanșează direct în Smartsupp, fără un instrument extern.

  • Prezentare generală a integrărilor — consultați toate integrările native disponibile cu CRM-uri, platforme de comerț electronic și multe altele.

💡 Aveți nevoie de ajutor suplimentar? Contactați Echipa noastră de asistență — vă ajutăm cu plăcere!

Articole similare
Ați primit răspuns la întrebare?