Pāriet uz galveno saturu

Webhooki — savienojiet Smartsupp ar Make, n8n un saviem rīkiem

Iestatiet webhookus tieši vadības panelī un saņemiet reāllaika paziņojumus par sarunām, kontaktiem un apmeklētājiem Make, n8n vai savā sistēmā.

Webhooki ļauj Smartsupp sūtīt reāllaika paziņojumus uz jūsu izvēlētu URL — brīdī, kad tiek atvērta saruna, izveidots kontakts vai piegādāta ziņa, jūsu sistēma to uzzina. Šajā rakstā paskaidrots, kas ir webhooki, kā tos iestatīt vadības panelī un kā savienot ar automatizācijas platformām, piemēram, Make un n8n.

Rakstu esam sadalījuši vairākās sadaļās:

Kam noder webhooki?

Webhooks ir automātiska HTTP ziņa, ko Smartsupp nosūta uz jūsu izvēlētu URL ikreiz, kad notiek izvēlēts notikums. Tā vietā, lai pastāvīgi pārbaudītu izmaiņas, jūsu rīki saņem datus brīdī, kad kaut kas notiek.

Tipiski lietošanas gadījumi:

  • Automatizācijas platformas — palaidiet darbplūsmas Make, n8n vai līdzīgos rīkos: kontaktu pievienošana CRM, paziņojumi Slack, potenciālo klientu reģistrēšana tabulā

  • Iekšējās sistēmas — reāllaikā nododiet sarunu un kontaktu datus vadības paneļiem, datu noliktavām vai pieteikumu sistēmām

  • Paziņojumi — brīdiniet komandu, kad saruna tiek novērtēta vai ziņas piegāde neizdodas

Padoms: Webhooki ir pieejami no Plus plāna un augstāk — Plus ietver 1 webhooku, Expert 3, bet Ultimate piedāvā pielāgotu limitu. Salīdziniet plānus →

Izveidojiet webhooku

Webhooka iestatīšana Smartsupp vadības panelī aizņem tikai dažus soļus:

  • 1. Atveriet Settings un dodieties uz sadaļu Webhooks.

  • 2. Noklikšķiniet, lai pievienotu jaunu webhooku, un ievadiet savu endpoint URL — adresi, uz kuru Smartsupp sūtīs notikumu datus.

  • 3. Izvēlieties notikumus, kurus vēlaties saņemt (pilns saraksts nākamajā sadaļā).

  • 4. Saglabājiet webhooku. No šī brīža izvēlētie notikumi tiek piegādāti kā HTTP POST pieprasījumi ar JSON saturu.

Piezīme: Iepriekš iestatītie webhooki turpina darboties kā ierasts. Strādājam pie tā, lai visi esošie webhooki būtu redzami un pārvaldāmi jaunajā vadības paneļa sadaļā.

Pieejamie notikumi

Smartsupp var paziņot jūsu endpointam par notikumiem trīs kategorijās. Izvēlieties tikai tos notikumus, kas jūsu darbplūsmai patiešām nepieciešami — tā endpoints paliek viegls un izvairās no liekas datplūsmas.

Kontakti

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Sarunas

  • 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

Apmeklētāji

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Saistītie resursi: Smartsupp izstrādātāju dokumentācija — pilnas JSON payload shēmas katram notikuma tipam.

Pārbaudiet savu webhooku

Pirms palaišanas izmantojiet iebūvēto testa funkciju, lai pārliecinātos, ka endpoints ir sasniedzams un jūsu Make vai n8n scenārijs ir iestatīts pareizi.

Vadības paneļa webhooka iestatījumos noklikšķiniet Send test. Smartsupp nosūtīs parauga payload uz jūsu endpoint URL. Pārbaudiet saņēmējā servisā, ka dati pienāca gaidītajā formātā.

Padoms: Make scenārijam jābūt aktīvam un jāklausās pirms testa sūtīšanas. n8n pārslēdziet Webhook mezglu uz production URL un pārliecinieties, ka darbplūsma ir aktīva.

Piegāde, atkārtojumi un drošība

Smartsupp ir veidots, lai droši piegādātu webhook notikumus pat tad, kad jūsu endpoints īslaicīgi nav pieejams.

  • Formāts — visi notikumi tiek sūtīti kā HTTP POST pieprasījumi ar JSON saturu, kas apraksta notikumu un tā datus

  • Atbilde — jūsu endpointam pēc iespējas ātrāk jāatbild ar 2xx HTTP statusa kodu; lēnas atbildes var aizkavēt atkārtojumus

  • Atkārtojumi — ja piegāde neizdodas, Smartsupp mēģina vēlreiz ar pieaugošiem intervāliem līdz 3 dienām

  • Automātiska atslēgšana — endpointi, kas pastāvīgi neizdodas, tiek automātiski atslēgti; tos jebkurā brīdī varat atkal ieslēgt vadības panelī

  • Drošība — katrs webhook pieprasījums ir parakstīts, lai varētu pārliecināties, ka tas tiešām nāk no Smartsupp; skatiet docs.smartsupp.com paraksta pārbaudes detaļas

Piezīme: Ja jūsu endpoints tiek atslēgts atkārtotu kļūdu dēļ, pēc problēmas novēršanas atkal ieslēdziet to sadaļā Settings → Webhooks. Smartsupp nekavējoties atsāks notikumu sūtīšanu.

Savienojiet Smartsupp ar Make vai n8n

Smartsupp savienošana ar automatizācijas platformu aizņem četrus soļus. Process Make un n8n ir vienāds — atšķiras tikai trigger mezgls.

  • 1. Make pievienojiet Webhooks → Custom webhook trigeri un nokopējiet izveidoto URL. n8n pievienojiet Webhook trigera mezglu un nokopējiet tā production URL.

  • 2. Smartsupp dodieties uz Settings → Webhooks, izveidojiet jaunu webhooku un ielīmējiet nokopēto URL.

  • 3. Izvēlieties nepieciešamos notikumus un saglabājiet webhooku.

  • 4. Noklikšķiniet Send test, lai Make vai n8n notvertu datu struktūru — tad uz tās izveidojiet pārējo scenāriju.

Padoms: Make aktivizējiet scenāriju pirms testa sūtīšanas — citādi webhook dati netiks notverti. n8n izmantojiet production URL (nevis testa), iestatot Smartsupp webhooku.

Kas tālāk?

  • Smartsupp REST API — iepazīstiet pilno API programmatiskai Smartsupp datu lasīšanai un rakstīšanai.

  • Automatizācijas — iestatiet uz noteikumiem balstītas automatizācijas, kas tiek palaistas tieši Smartsupp bez ārēja rīka.

  • Integrāciju pārskats — apskatiet visas pieejamās integrācijas ar CRM, e-komercijas platformām un citu.

💡 Vajadzīga papildu palīdzība? Sazinieties ar mūsu atbalsta komandu — labprāt palīdzēsim!

Vai saņēmāt atbildi uz savu jautājumu?