Integracje i kanały (technicznie)

Kanały przenoszą wiadomości z innych usług do tego samego panelu co czat na stronie; integracje wysyłają zdarzenia do innych usług albo pobierają stamtąd wiedzę. Ta strona opisuje technikę. Jak obsługiwać je w koncie, opisuje Podręcznik.

Stan: kanały i większość integracji są sprawdzone na odtworzonych odpowiedziach dostawców, ale jeszcze nie na każdym prawdziwym koncie. Podpisany webhook jest gotowy (z opisanym tam ograniczeniem); przy wszystkich innych dostawcach po włączeniu sprawdź log integracji. Traktuj je jako Beta.

Wspólne reguły

• Adresy zwrotne mają postać https://reactive.chat/kanal/<kanal>/<SITE_KEY>. Klucz witryny znajdziesz w koncie w sekcji Projekt → Instalacja.
• Każde wejście sprawdza podpis dostawcy. Bez sekretu dostawcy nic nie jest przyjmowane.
• Dane dostępowe są przechowywane w postaci zaszyfrowanej i oddzielnie od pozostałej konfiguracji.
• Odpowiedzi twojego zespołu trafiają do dostawcy przez kolejkę wychodzącą; zawieszona platforma nie wstrzymuje żadnego czatu.
• Długość wiadomości: wiadomości przychodzące dłuższe niż limit planu są skracane i oznaczane [...] (Limity).
• Załączniki z kanałów (e-mail, zdjęcia z Telegrama) przechodzą tę samą kontrolę co w widżecie (typ, rozmiar, limit). Odrzucone widnieją w tekście jako „[Nie przyjęto załącznika: …]”, w domyślnym języku projektu (de, en, pl, w innym przypadku po angielsku).

WhatsApp, Messenger, Instagram

Konfigurowane w koncie w sekcji Integracje. Potrzebujesz własnej aplikacji w Meta Developer Dashboard; twoje wiadomości nie przechodzą przez nasze konto.

• Callback URL: https://reactive.chat/kanal/whatsapp/SITE_KEY, …/kanal/messenger/SITE_KEY lub …/kanal/instagram/SITE_KEY
• Verify Token: długi losowy ciąg znaków, który wpisujesz identycznie w Meta i u nas (porównanie w stałym czasie).
• App Secret: nim sprawdzamy podpis każdego wywołania zwrotnego. Bez App Secret wejście niczego nie przyjmuje.
• Access Token: nim wysyłamy w twoim imieniu.

Reguły platform, przez które dostarczenia po cichu się nie udają:

• WhatsApp: przez 24 godziny od ostatniej wiadomości klienta możesz odpowiadać swobodnie, potem tylko zatwierdzonym szablonem (typ UTILITY, dokładnie jeden symbol zastępczy {{1}}). Wpisz jego nazwę w konfiguracji; poza tym oknem nie wysyłamy swobodnych wiadomości.
• Instagram: klient musi napisać pierwszy.
• Messenger: z Message Tags pozostał tylko HUMAN_AGENT; inne odrzucamy.

Meta oczekuje odpowiedzi na wywołanie zwrotne w ciągu pięciu sekund; nasze wejście tylko przyjmuje i kolejkuje.

Telegram, SMS, e-mail

Te kanały są przypisane do projektu i konfigurowane w sekcji Projekt → Kanały.

• Telegram: własny bot. Przy zapisaniu tokenu bota sami rejestrujemy adres zwrotny https://reactive.chat/kanal/telegram/SITE_KEY przez setWebhook, z losowym secret_token, który musi przynieść każde wywołanie zwrotne. Asystent domyślnie również odpowiada.
• SMS: przez twoje konto Twilio (integracja Twilio). Przy numerze w polu „A message comes in” wpisz https://reactive.chat/kanal/sms/SITE_KEY; sprawdzany jest X-Twilio-Signature. Asystent domyślnie również odpowiada.
• E-mail: pobieranie twojej skrzynki przez IMAP co minutę, odpowiedź przez twój SMTP (w przeciwnym razie przez naszą wysyłkę z Reply-To). Przy włączeniu stara poczta nie jest pobierana. Przypisanie do rozmowy przez In-Reply-To/References, w przeciwnym razie według nadawcy i tematu z ostatnich 30 dni. Nie są przejmowane: autoodpowiedzi o nieobecności, raporty doręczenia, listy mailingowe, wiadomości oznaczone jako spam, ponad 20 maili na nadawcę na godzinę (300 na projekt). Asystent przy e-mailu domyślnie nie odpowiada; gdy jest włączony, jego odpowiedzi mają Auto-Submitted: auto-replied.

Znana luka: jeśli dostarczenie do dostawcy ostatecznie się nie powiedzie (zablokowany numer, zamknięte okno), przyczyna widnieje w logu integracji, ale jeszcze nie w rozmowie.

Integracje

Integracje włączasz w koncie w sekcji Integracje. Każda ma własne dane dostępowe (klucz, token, adres albo logowanie u dostawcy). Zdarzenia (conversation.created, message.created, handoff.requested, csat.submitted, fehlerfall.erstellt) przechodzą przez kolejkę z ponowieniami:

• do pięciu ponowień z rosnącym odstępem (od 1 s do nieco ponad 10 minut),
• bezpiecznik dla każdego dostawcy i przestrzeni roboczej: po 5 błędach w ciągu 60 sekund 30 sekund przerwy,
• zdarzenia starsze niż godzina nie są już dostarczane,
• czat nigdy nie czeka na integrację.

Dostawcy w kodzie:

• Zdarzenia do własnych systemów: webhooki (podpisane, zobacz Webhooki), Zapier, Make, n8n (przez REST hooki)
• Czat zespołowy: Slack, Microsoft Teams, Discord
• Zgłoszenia i CRM: Zendesk, Freshdesk, HubSpot, Pipedrive, Jira, Linear, GitHub
• Sklepy: Shopify, WooCommerce, Shopware, Stripe
• Wiedza: crawler strony, WordPress, Notion, Confluence, Google Drive
• Analityka i błędy: Google Analytics 4, Matomo, Plausible, Sentry
• Terminy: Cal.com
• Kanały: WhatsApp, Messenger, Instagram, Telegram, Twilio, e-mail

Własnych dostawców nie możesz rejestrować. Do własnych integracji użyj webhooków, API serwera albo MCP.

Funkcje sklepu w czacie (np. „Dodaj do koszyka” dla WooCommerce, Shopify i Shopware) reactive.chat odblokowuje dla każdego projektu osobno; działają tylko na wpisanym hoście sklepu i nie mają własnego API JavaScript.

Aplikacje mobilne

Dla aplikacji nie ma natywnego SDK, tylko strona do osadzenia w WebView: Aplikacje mobilne.

Dalej: Aplikacje mobilne