Webhooks ļauj Smartsupp sūtīt reāllaika paziņojumus uz jebkuru jūsu izvēlētu URL — tiklīdz tiek atvērta saruna, izveidots kontakts vai piegādāta ziņa, jūsu sistēma par to uzzina. Šajā rakstā ir izskaidrots, kas ir webhooks, kā tos iestatīt vadības panelī un kā tos savienot ar tādām automatizācijas platformām kā Make un n8n.
Rakstu esam sadalījuši vairākās sadaļās:
Kam noder webhooks?
Webhook ir automātiska HTTP ziņa, ko Smartsupp nosūta uz jūsu izvēlētu URL ikreiz, kad notiek izvēlētais notikums. Tā vietā, lai periodiski pieprasītu informāciju par izmaiņām, jūsu rīki saņem datus uzreiz, tiklīdz kaut kas notiek.
Tipiski lietošanas piemēri:
Automatizācijas platformas — aktivizējiet darbplūsmas Make, n8n vai līdzīgos rīkos, lai pievienotu kontaktus CRM, publicētu paziņojumus Slack vai reģistrētu potenciālos klientus izklājlapā
Iekšējās sistēmas — nododiet sarunu un kontaktu datus vadības paneļiem, datu noliktavām vai atbalsta pieteikumu sistēmām reāllaikā
Paziņojumi — informējiet komandu, kad sarunas tiek novērtētas vai ziņas piegāde neizdodas
Padoms: Webhooks ir pieejami ar Plus plānu un augstākiem plāniem — Plus ietver 1 webhook, Expert ietver 3, savukārt Ultimate piedāvā pielāgotu limitu. Salīdzināt plānus →
Izveidojiet webhook
Lai iestatītu webhook savā Smartsupp vadības panelī, jāveic tikai dažas darbības:
1. Atveriet Iestatījumus Un pārejiet uz Webhooks Sadaļu.
2. Noklikšķiniet, lai pievienotu jaunu webhook, un ievadiet savu Galapunkta URL — adresi, uz kuru Smartsupp sūtīs notikumu datus.
3. Izvēlieties Notikumus Kurus vēlaties saņemt (pilnu sarakstu skatiet nākamajā sadaļā).
4. Saglabājiet webhook. No šī brīža izvēlētie notikumi tiek piegādāti kā HTTP POST pieprasījumi ar JSON datiem.
Piezīme: Iepriekš konfigurētie webhooks turpina darboties kā parasti. Tiek strādāts pie tā, lai visi esošie webhooks būtu redzami un pārvaldāmi jaunajā vadības paneļa sadaļā.
⚠️ Vai iepriekš esat izveidojuši webhooks? Vecākie webhooks šajā sadaļā vēl nav redzami — tie turpina darboties kā iepriekš. Mēs apvienojam veco un jauno sistēmu, lai visu varētu pārvaldīt vienuviet.
Pieejamie notikumi
Smartsupp var informēt jūsu galapunktu par notikumiem trīs kategorijās. Izvēlieties tikai tos notikumus, kas jūsu darbplūsmai patiešām nepieciešami — tas samazina galapunkta slodzi un novērš lieku datu plūsmu.
Kontakti
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Sarunas
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Apmeklētāji
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Saistītie resursi: Smartsupp izstrādātāja dokumentācija — pilnas JSON datu shēmas katram notikuma veidam.
Pārbaudiet savu webhook
Pirms sākat lietošanu, izmantojiet iebūvēto pārbaudes funkciju, lai pārliecinātos, ka galapunkts ir sasniedzams un Make vai n8n scenārijs ir iestatīts pareizi.
Vadības panelī atveriet webhook iestatījumus un noklikšķiniet uz Nosūtīt testu. Smartsupp nosūtīs datu paraugu uz jūsu galapunkta URL. Pārbaudiet pakalpojumu, kas saņem datus, lai pārliecinātos, ka dati ir saņemti paredzētajā formātā.
Padoms: Make scenārijam pirms testa nosūtīšanas jābūt aktīvam un jāgaida ienākošie dati. n8n pārslēdziet Webhook mezglu uz tā produkcijas URL un pārliecinieties, ka darbplūsma ir aktīva.
Piegāde, atkārtoti mēģinājumi un drošība
Smartsupp ir izstrādāts tā, lai uzticami piegādātu webhook notikumus arī tad, ja jūsu galapunkts īslaicīgi nav pieejams.
Formāts — visi notikumi tiek nosūtīti kā HTTP POST pieprasījumi ar JSON pamatdaļu, kurā aprakstīts notikums un tā dati
Atbilde — galapunktam pēc iespējas ātrāk jāatbild ar 2xx HTTP statusa kodu; lēnas atbildes var aizkavēt atkārtotus mēģinājumus
Atkārtoti mēģinājumi — ja piegāde neizdodas, Smartsupp atkārto mēģinājumus ar arvien ilgākiem intervāliem līdz 3 dienām
Automātiska atspējošana — galapunkti, kuros pastāvīgi rodas kļūmes, tiek automātiski atspējoti; tos jebkurā laikā varat atkal iespējot vadības panelī
Drošība — katrs webhook pieprasījums ir parakstīts, lai jūs varētu pārbaudīt, vai tas patiešām nāk no Smartsupp; skatiet docs.smartsupp.com Lai uzzinātu vairāk par paraksta pārbaudi
Piezīme: Ja galapunkts ir atspējots atkārtotu kļūmju dēļ, atkal iespējojiet to sadaļā Iestatījumi → Webhooks Pēc kļūmes cēloņa novēršanas. Smartsupp nekavējoties atsāks sūtīt notikumus.
Savienojiet Smartsupp ar Make vai n8n
Lai savienotu Smartsupp ar automatizācijas platformu, jāveic četras darbības. Process Make un n8n ir vienāds — atšķiras tikai aktivizētāja mezgls.
1. Platformā Make, pievienojiet Webhooks → Pielāgots webhook Aktivizētāju un nokopējiet ģenerēto URL. Platformā n8n, pievienojiet Webhook Aktivizētāja mezglu un nokopējiet tā produkcijas URL.
2. Smartsupp atveriet Iestatījumi → Webhooks, izveidojiet jaunu webhook un ielīmējiet nokopēto URL.
3. Izvēlieties nepieciešamos notikumus un saglabājiet webhook.
4. Noklikšķiniet uz Nosūtīt testu Lai Make vai n8n uztvertu datu struktūru — pēc tam uz tās pamata izveidojiet pārējo scenāriju vai darbplūsmu.
Padoms: Make aktivizējiet scenāriju pirms testa nosūtīšanas — pretējā gadījumā webhook dati netiks uztverti. n8n izmantojiet Produkcijas URL (nevis testa URL), iestatot Smartsupp webhook.
Kas tālāk?
Smartsupp REST API — izpētiet pilno API, lai programmatiski lasītu un rakstītu Smartsupp datus.
Automatizācijas — iestatiet uz noteikumiem balstītas automatizācijas, kas tiek aktivizētas tieši Smartsupp bez ārēja rīka.
Integrāciju pārskats — skatiet visas pieejamās iebūvētās integrācijas ar CRM, e-komercijas platformām un citiem rīkiem.
💡 Vai nepieciešama papildu palīdzība? Sazinieties ar mūsu Atbalsta komandu — mēs labprāt palīdzēsim!