Integracje, przeniesienie i klucze API

W sekcji Integracje (/app/integrations) łączysz reactive.chat z narzędziami, których twój zespół już używa. Integracje obowiązują w całej przestrzeni. Konfigurować je mogą właściciele i admini; admin ograniczony do wybranych projektów nie może tego zrobić.

Ta strona opisuje, co integracje dla ciebie robią i jak je obsługiwać. Szczegóły techniczne, na przykład o podpisie webhooków, opisuje część Integracja techniczna.

Uczciwie o stanie prac

Gotowe jest połączenie z ponad 30 usługami. Większość z nich sprawdzono na odtworzonych usługach testowych, ale nie działały jeszcze z prawdziwą usługą. Strona integracji oznacza je dopiskiem „Niesprawdzone z prawdziwą usługą”; niektóre mają oznaczenie „W budowie”. Webhooki i Slack nie mają tego dopisku. Skonfiguruj niesprawdzoną integrację, przetestuj ją na prawdziwych danych i daj nam znać przez Prześlij opinię, jeśli coś się nie zgadza.

Konfigurowanie integracji

1. Otwórz Integracje. U góry widzisz, ile integracji jest połączonych, ile ma błąd, ile jest wstrzymanych i czy jakieś dostarczenia się nie powiodły.
2. Wyszukaj w katalogu (Szukaj integracji, filtr „Wszystkie” albo „Niepołączone”) i kliknij Skonfiguruj.
3. Wpisz dane dostępowe, których wymaga usługa, zwykle klucz API albo token z twojego konta w tej usłudze.
4. Połącz i włącz od razu sprawdza połączenie i włącza integrację. Przyciskiem Zapisz bez włączania odkładasz to na później.

Później możesz integrację Edytować, Wstrzymać, Włączyć ponownie albo Usunąć. Usunięcie kasuje zapisane dane dostępowe i nie da się go cofnąć. Dane dostępowe są zapisywane w postaci zaszyfrowanej.

Przycisk logowania do usługi jest tylko dla Google Drive. We wszystkich innych przypadkach wpisujesz dane dostępowe samodzielnie, w Slacku na przykład dane własnej aplikacji Slack.

Gdy usługa nie odpowiada

Każda integracja działa przez kolejkę. Jeśli usługa nie odpowiada, próba jest kilka razy ponawiana z rosnącym odstępem; po powtarzających się awariach usługa jest na jakiś czas wstrzymywana („Chwilowo wstrzymana: usługa wielokrotnie nie odpowiedziała …”). Zdarzenie, które nie zostanie dostarczone w ciągu około godziny, jest odrzucane. Ostatnie nieudane dostarczenia widzisz w sekcji Nieudane dostarczenia, bez treści.

Wiadomość na czacie nigdy nie czeka na integrację. Jeśli usługa się zawiesi, czat działa dalej bez zakłóceń.

Co jest dostępne

Powiadomienia dla twojego zespołu

• Slack – każda nowa rozmowa pojawia się jako wątek na kanale. Odpowiadacie w wątku, a odwiedzający widzi odpowiedź w czacie. /rc pokazuje stan. Użytkowników Slacka przypisujesz do agentów.
• Microsoft Teams, Discord – powiadomienia przez adres webhooka.
• Telegram – powiadomienia na czat przez token bota i ID czatu.
• E-mail – powiadomienia na skrzynkę zespołu.

Automatyzacja

• Webhooki – reactive.chat wysyła podpisane zdarzenia na wybrany przez ciebie adres https://: nowa rozmowa, każda wiadomość, prośba o przekazanie do człowieka, wystawiona ocena, nowy przypadek błędu. Przez webhooki łączą się też Zapier, Make i n8n. Sekret podpisu możesz odsłonić, skopiować i wygenerować na nowo; nowy sekret działa od razu, a stary przestaje działać.
• Zapier – przez REST hooks interfejsu. Dla Make i n8n nie ma jeszcze gotowej aplikacji, tam używasz webhooków.

Kontekst na pulpicie

Te integracje pokazują na pulpicie, w kolumnie kontekstu, karty o odwiedzającym, na przykład jego zamówienia albo kontakt w CRM, częściowo z akcjami:

• CRM – HubSpot, Pipedrive
• Sklep – Shopify, Shopware 6, WooCommerce
• Płatności – Stripe (z ograniczonym kluczem do odczytu)
• Strona – WordPress
• Analityka – Matomo, Plausible, Google Analytics 4
• Błędy – Sentry

Informacje oparte na niepodpisanej deklaracji odwiedzającego karta oznacza. Akcje wykonujesz przyciskiem Wykonaj i potwierdzeniem.

Zgłoszenia, terminy, telefon

• Zendesk, Freshdesk, Jira, Linear, GitHub – tworzenie zgłoszeń lub issues z rozmowy albo z przypadku błędu.
• Cal.com – pokazywanie i rezerwowanie wolnych terminów, także przez asystenta AI.
• Twilio – SMS z pulpitu i droga wysyłki dla kanału SMS.

Źródła wiedzy

• Notion, Confluence – przejmowanie treści do bazy wiedzy.
• Google Drive – w bazie wiedzy, „Pliki i Google Drive” (zobacz Baza wiedzy i centrum pomocy).
• KB-Crawler – ustawienia przebiegu po twojej stronie.

Kanały

• WhatsApp Business, Facebook Messenger, Instagram Direct – zobacz Kanały.

Przeniesienie od innego dostawcy

W sekcji Przeniesienie (/app/migration) przejmujesz dane z innego narzędzia do czatu:

• Intercom i Crisp – przez ich interfejs albo plik eksportu; w przypadku Crisp także artykuły pomocy jako Markdown,
• Tidio – przez plik eksportu,
• Zendesk – przez pełny eksport JSON i eksport centrum pomocy.

Jak postępować:

1. Nowe przeniesienie i wybór celu (Do którego projektu?).
2. Połącz i sprawdź, co tam jest – widzisz, co jest dostępne, oraz próbkę.
3. Co ma zostać przeniesione? – kontakty, rozmowy, artykuły.
4. Rozpocznij przeniesienie. Możesz Wstrzymać albo Odrzucić zadanie.

Warto wiedzieć:

• Zaimportowane rozmowy trafiają na pulpit jako zamknięte.
• Zaimportowane kontakty są traktowane jako niepotwierdzone.
• Dane wrażliwe w tekstach są maskowane.
• Załączniki przychodzą jako odnośnik, nie jako plik.
• Drugi przebieg niczego nie duplikuje.
• Twoje dane dostępowe do starego dostawcy są usuwane po przebiegu.
• Interfejsy dostawców sprawdzono bez prawdziwych kont u nich; importy z plików sprawdzono do końca na plikach przykładowych.

Funkcją Wymiana snippetu konto przekłada istniejący snippet Intercom albo Crisp na snippet reactive.chat. Polecenia JavaScript boot, open, identify i track nazywają się przy tym tak samo jak w Intercomie.

Klucze API

W sekcji Klucze API (/app/api-keys, właściciele i admini) tworzysz klucze do interfejsu REST. Klucz jest pokazywany dokładnie raz; potem reactive.chat przechowuje już tylko jego odcisk. Skopiuj go więc od razu w bezpieczne miejsce.

Przy tworzeniu wybierasz, co klucz może robić:

• tylko odczyt
• odczyt i zapis
• tylko import danych klientów – do importu opisanego w Dane klientów w czacie
• odczyt + dane odwiedzających albo odczyt, zapis + dane odwiedzających – dopiero z tym zakresem klucz widzi imię, adres e-mail i telefon odwiedzających

Lista pokazuje nazwę, prefiks, kiedy i przez kogo klucz został utworzony oraz kiedy ostatnio go użyto. Unieważnij działa od razu i nie da się tego cofnąć.

Z kluczem możesz też podłączyć reactive.chat do narzędzi AI, które obsługują Model Context Protocol (MCP); strona pokazuje przykłady. Jak działa interfejs, opisuje część Integracja techniczna.