Přeskočit na hlavní obsah

Webhooky: Propojte Smartsupp s Make, n8n a vlastními nástroji

Odesílejte real-time události ze Smartsupp na libovolnou URL — nastavte webhooky, vyberte události a propojte se s Make nebo n8n během pár minut.

Webhooky umožňují Smartsupp odesílat upozornění v reálném čase na libovolnou URL — v okamžiku, kdy se otevře konverzace, vytvoří kontakt nebo doručí zpráva, váš systém o tom okamžitě ví. Tento článek vysvětluje, co jsou webhooky, jak je nastavit v nástroji, a jak je propojit s automatizačními platformami Make a n8n.

Rozdělili jsme článek do několika částí:

K čemu jsou webhooky?

Webhook je automatická HTTP zpráva, kterou Smartsupp odesílá na zvolenou URL vždy, kdy nastávne vybraná událost. Místo pollíngování změn vaše nástroje přijímají data okamžitě v momentě, kdy něco nastane.

Typické případy použití zahrnují:

  • Automatizační platformy — spouštějte workflow v Make, n8n nebo podobných nástrojích pro přidávání kontaktů do CRM, posílání upozornění do Slacku nebo zaznamenávání leadů do tabulky

  • Interní systémy — posílejte data o konverzacích a kontaktech do dashboardů, datových skladů nebo ticketovacích systémů v reálném čase

  • Upozornění — upozorněte svůj tým, když je konverzace hodnocena nebo když se nepodaří doručit zprávu

Tip: Webhooky jsou dostupné v plánu Plus a vyšším — Plus zahrnuje 1 webhook, Expert 3 a Ultimate nabídí vlastní limit. Porovnat plány →

Vytvoření webhoku

Nastavení webhoku vyžaduje jen několik kroků v nástroji Smartsupp:

  • 1. Otevřete Nastavení a přejděte do sekce Webhooky.

  • 2. Klikněte na přidání nového webhoku a zadejte URL endpointu — adresu, na kterou bude Smartsupp posílat data událostí.

  • 3. Vyberte události, které chcete přijímat (viz úplný seznam v následující části).

  • 4. Uložte webhook. Od té chvíle jsou vybrané události doručovány jako HTTP POST požadavky s JSON tělem.

Poznámka: Dříve nakonfigurované webhooky fungují normálně dál. Probíhá práce na zpřístupnění všech stávajících webhooků v nové sekci nastavení.

Dostupné události

Smartsupp může upozornit váš endpoint na události ve třech kategoriích. Vyberte pouze ty události, které váš workflow skutečně potřebuje — šetří to endpoint a zamezuje zbytečnému provozu.

Kontakty

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Konverzace

  • 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

Návštěvníci

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Související zdroje: Smartsupp vývojová dokumentace — úplné schématy JSON pro každý typ události.

Otestujte webhook

Před ostrým provozem použijte vestavěný testovací nástroj a ověřte, že je váš endpoint dosažitelný a že je scénář v Make nebo n8n správně nastaven.

V nastavení webhoků klikněte na Odeslat test. Smartsupp odešle ukázkovou datovou sadu na URL vašeho endpointu. Zkontrolujte přijímací službu a ověřte, že data dorazila v očekávaném formátu.

Tip: V Make musí být váš scénář aktivní a naslouchat, než odešlete test. V n8n přepněte uzel Webhook na provozní URL a ujistěte se, že je workflow aktivní.

Doručování, opakování a zabezpečení

Smartsupp je navržen tak, aby doručoval události webhooků spolehlivě, i když je váš endpoint dočasně nedostupný.

  • Formát — všechny události jsou odesílány jako HTTP POST požadavky s JSON tělem popisujícím událost a její data

  • Odpověď — váš endpoint by měl co nejrychleji odpovědět stavovým kódem 2xx; pomalé odpovědi mohou zpoždit další pokusy

  • Opakování — při neúspěšném doručení Smartsupp opakuje pokusy s rostoucími prodlevami až do 3 dnů

  • Automatické deaktivování — endpointy, které opakovaně selhávají, jsou automaticky deaktivovány; můžete je kdykoli znovu aktivovat v nástroji

  • Zabezpečení — každý požadavek webhoku je podepsán, abyste mohli ověřit, že skutečně pochází ze Smartsupp; podrobnosti o ověření podpisu naleznete na docs.smartsupp.com

Poznámka: Pokud je váš endpoint deaktivován kvůli opakovaným selháním, znovu ho aktivujte v Nastavení → Webhooky po odstraenění základního problému. Smartsupp ihned objeví odesílání událostí.

Propojte Smartsupp s Make nebo n8n

Propojení Smartsupp s automatizační platformou vyžaduje čtyři kroky. Postup je stejný pro Make i n8n — liší se pouze spouštěcí uzel.

  • 1. V Make přidejte trigger Webhooky → Vlastní webhook a zkopírujte vygenerovanou URL. V n8n přidejte uzel Webhook a zkopírujte jeho provozní URL.

  • 2. Ve Smartsupp přejděte do Nastavení → Webhooky, vytvořte nový webhook a vložte zkopírovanou URL.

  • 3. Vyberte potřebné události a webhook uložte.

  • 4. Klikněte na Odeslat test, aby Make nebo n8n zachytily datovou strukturu — poté na údajich postavte zbytek svého scénáře nebo workflow.

Tip: V Make aktivujte svůj scénář před odesláním testu — jinak se data webhoku nezachytí. V n8n použijte provozní URL (ne testovací), když nastavujete webhook Smartsupp.

Co dál?

  • Smartsupp REST API — prozkoumejte plné API pro čtení a zápis dat Smartsupp programově.

  • Automatizace — nastavte automatizace založené na pravidlech, které se spouštějí přímo v Smartsupp bez externího nástroje.

  • Přehled integrací — prohliděte si všechny dostupné nativní integrace s CRM, e-commerce platformami a dalšími.

💡 Potřebujete další pomoc? Kontaktujte náš tým podpory — rádi pomůžeme!

Dostali jste odpověď na svou otázku?