Integrace, migrace a klíče API

V části Integrace (/app/integrations) propojujete reactive.chat s nástroji, které váš tým už používá. Integrace platí pro celý pracovní prostor. Nastavovat je mohou vlastníci a administrátoři; administrátor omezený na jednotlivé projekty nemůže.

Tato stránka popisuje, co vám integrace přinášejí a jak je používat. Technické podrobnosti, například podepisování webhooků, najdete v části Technická integrace.

Otevřeně o aktuálním stavu

K dispozici jsou připojení k více než 30 službám. Většina byla testována proti simulovaným protějškům, ale dosud neběžela proti živé službě. Stránka integrací je označuje „Neověřeno proti živé službě“; některé mají označení „Ve vývoji“. Webhooky a Slack toto upozornění nemají. Neověřenou integraci nastavte, vyzkoušejte se skutečnými daty a dejte nám vědět přes Poslat zpětnou vazbu, pokud něco není v pořádku.

Nastavení integrace

1. Otevřete Integrace. Nahoře vidíte, kolik jich je připojených, kolik má chybu nebo je pozastavených a zda selhala doručení.
2. Prohledejte katalog (Hledat integrace, filtr „Vše“ nebo „Nepřipojeno“) a klikněte na Nastavit.
3. Zadejte přihlašovací údaje, které služba vyžaduje, obvykle klíč API nebo token ze svého účtu v dané službě.
4. Připojit a aktivovat ihned ověří spojení a integraci zapne. Pomocí Uložit bez aktivace to necháte na později.

Později můžete integraci Upravit, Pozastavit, Znovu aktivovat nebo Odebrat. Odebrání smaže uložené přihlašovací údaje a nelze ho vrátit zpět. Přihlašovací údaje se ukládají zašifrovaně.

Tlačítko pro přihlášení ke službě existuje pouze pro Google Drive. U všech ostatních zadáváte přihlašovací údaje sami, například u Slacku údaje vlastní aplikace Slack.

Když služba neodpovídá

Každá integrace pracuje přes frontu. Pokud služba neodpovídá, doručení se několikrát opakuje s rostoucími rozestupy; po opakovaných selháních se na chvíli pozastaví („Dočasně pozastaveno: služba opakovaně neodpovídala …“). Událost, která nebyla doručena přibližně do hodiny, se zahodí. Nejnovější neúspěšná doručení vidíte v části Neúspěšná doručení, bez jejich obsahu.

Zpráva v chatu nikdy nečeká na integraci. Pokud služba zamrzne, chat běží dál bez narušení.

Co je k dispozici

Oznámení vašemu týmu

• Slack – každá nová konverzace se zobrazí jako vlákno v kanálu. Odpovíte ve vlákně a návštěvník vidí odpověď v chatu. /rc zobrazuje stav. Uživatelům Slacku přiřazujete operátory.
• Microsoft Teams, Discord – oznámení přes adresu webhooku.
• Telegram – oznámení do chatu přes token bota a ID chatu.
• E-mail – oznámení do týmové schránky.

Automatizace

• Webhooky – reactive.chat odesílá podepsané události na adresu https:// podle vašeho výběru: nová konverzace, každá zpráva, žádost o předání člověku, udělené hodnocení, nový chybový případ. Takto se připojují i Zapier, Make a n8n. Tajný podpisový klíč můžete zobrazit, zkopírovat a vygenerovat znovu; nový klíč platí okamžitě a starý přestane platit.
• Zapier – přes REST hooky rozhraní. Pro Make a n8n zatím není hotová aplikace; použijte webhooky.

Kontext v pultu

Tyto integrace zobrazují v kontextovém sloupci pultu karty o návštěvníkovi, například jeho objednávky nebo kontakt v CRM, některé s akcemi:

• CRM – HubSpot, Pipedrive
• Obchod – Shopify, Shopware 6, WooCommerce
• Platby – Stripe (s omezeným klíčem pro čtení)
• Web – WordPress
• Analytika – Matomo, Plausible, Google Analytics 4
• Chyby – Sentry

Karta označuje údaje založené na nepodepsaném tvrzení návštěvníka. Akce provádíte pomocí Spustit a potvrzení.

Tickety, termíny, telefon

• Zendesk, Freshdesk, Jira, Linear, GitHub – vytváření ticketů nebo úkolů z konverzace či chybového případu.
• Cal.com – zobrazení a rezervace dostupných termínů, také prostřednictvím asistenta AI.
• Twilio – SMS z pultu a cesta odesílání pro kanál SMS.

Zdroje znalostí

• Notion, Confluence – přebírání obsahu do znalostní báze.
• Google Drive – pod znalostní bází, „Soubory a Google Drive“ (viz Znalostní báze a centrum nápovědy).
• KB-Crawler – nastavení procházení vašeho webu.

Kanály

• WhatsApp Business, Facebook Messenger, Instagram Direct – viz Kanály.

Přechod od jiného poskytovatele

V části Migrace (/app/migration) přebíráte data z jiného chatovacího nástroje:

• Intercom a Crisp – přes jejich rozhraní nebo exportní soubor; u Crispu také články nápovědy jako Markdown,
• Tidio – přes exportní soubor,
• Zendesk – přes úplný export JSON a export centra nápovědy.

Postup:

1. Zahájit novou migraci a vybrat cíl (Do kterého projektu?).
2. Připojit a zjistit, co je k dispozici – uvidíte dostupný obsah i vzorek.
3. Co se má přenést? – kontakty, konverzace, články.
4. Spustit migraci. Můžete použít Zastavit nebo Zahodit úlohu.

Co byste měli vědět:

• Importované konverzace se v pultu objeví jako uzavřené.
• Importované kontakty se považují za neověřené.
• Citlivé údaje v textech se maskují.
• Přílohy se přenášejí jako odkaz, ne jako soubor.
• Druhý průchod nevytváří nic duplicitně.
• Vaše přihlašovací údaje ke starému poskytovateli se po průchodu smažou.
• Rozhraní poskytovatelů byla testována bez skutečných účtů u těchto služeb; importy souborů byly testovány od začátku do konce se vzorovými soubory.

Pomocí Vyměnit vkládací kód účet převede existující kód Intercomu nebo Crispu na kód reactive.chat. Příkazy JavaScriptu boot, open, identify a track mají stejné názvy jako v Intercomu.

Klíče API

V části Klíče API (/app/api-keys, vlastníci a administrátoři) vytváříte klíče pro rozhraní REST. Klíč se zobrazí právě jednou; potom reactive.chat ukládá pouze jeho otisk. Ihned si ho proto zkopírujte na bezpečné místo.

Při vytváření vyberete, co klíč smí:

• jen čtení
• čtení a zápis
• jen import zákaznických dat – pro import popsaný v části Zákaznická data v chatu
• čtení + údaje návštěvníků nebo čtení, zápis + údaje návštěvníků – pouze s těmito oprávněními klíč vidí jméno, e-mail a telefon návštěvníků

Seznam zobrazuje název, předponu, kdy a kým byl klíč vytvořen a kdy byl naposledy použit. Odvolat platí okamžitě a nelze to vrátit zpět.

Pomocí klíče můžete reactive.chat připojit i k nástrojům AI, které podporují Model Context Protocol (MCP); stránka ukazuje příklady. Jak rozhraní funguje, popisuje část Technická integrace.