Integracje / Chatwoot
Obsługa klienta i marketing
Integracja AI: Chatwoot
Podłączamy Chatwoot przez REST API lub bezpośrednio do bazy PostgreSQL i odbieramy rozmowy z czatu, e-maila i Messengera. Asystent odpowiada klientom z bazy wiedzy firmy, przypisuje tagi i przekazuje trudne sprawy agentowi ze streszczeniem.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem Chatwoot?
Łączymy się przez REST API Chatwoot pod /api/v1/accounts/{account_id}/conversations i /api/v1/accounts/{account_id}/contacts. Access token pobieramy z Profile Settings > Access Token w panelu Chatwoot.
- Na start potrzebujemy
- Self-hosted Chatwoot na własnym serwerze albo aktywne konto w wersji cloud Chatwoot.
- Czego asystent nie robi
- Nie odpowiada samodzielnie na pytania spoza bazy wiedzy: przekazuje je agentowi z notatką.
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z Chatwoot w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Rozmowy z Chatwoot. Moduł Rozmowy z Chatwoot zbiera wszystkie otwarte zgłoszenia z czatu na stronie, e-maila i Messengera i pokazuje je w jednym ekranie portalu, posortowane według czasu oczekiwania. Każda rozmowa trafia tu z kanałem, tematem i sygnałem, czy próg SLA jest zagrożony. Po kliknięciu asystent proponuje gotową odpowiedź, a wysyłka do klienta odbywa się po Waszym zatwierdzeniu.
- Wyświetla otwarte rozmowy z Chatwoot posortowane według czasu oczekiwania na odpowiedź
- Pokazuje kanał każdego zgłoszenia: czat na stronie, e-mail, Messenger
- Alarmuje kolorem, gdy rozmowa przekroczy próg SLA ustawiony w Chatwoot
- Kliknięcie rozmowy otwiera kartę z historią kontaktu i sugestią odpowiedzi asystenta
- Po Waszym zatwierdzeniu wysyła gotową odpowiedź bezpośrednio w Chatwoot

Pytanie w czacie
Pytacie asystenta o dowolny wycinek danych z Chatwoot, a on odpowiada z tabelą i konkretną propozycją, co zrobić dalej. Każde działanie, wysyłka i zmiana statusu, czeka na Waszą zgodę.
Chcę wiedzieć, o co klienci najczęściej pytają przez czat na stronie w Chatwoot i czy nasze czasy odpowiedzi są w normie.

Karta w narzędziu
Karta rozmowy z Chatwoot zbiera historię kontaktu, etykiety i gotową odpowiedź asystenta w jednym miejscu. Wysyłka trafia do klienta przez Messenger po Waszym zatwierdzeniu jednym przyciskiem.
W jednym ekranie macie wszystkie otwarte rozmowy z Chatwoot posortowane według czasu oczekiwania, z kolorowym sygnałem, gdzie SLA jest zagrożone. Kliknięcie rozmowy otwiera kartę z gotową sugestią odpowiedzi asystenta.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Chatwoot włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyLista tagów przypisanych do rozmowy: reklamacja, zwrot, pytanie o cennik, prośba o wycenę.
AsystentPrzypisuje tag zgodnie z treścią wiadomości klienta, spójnie z tagami używanymi przez resztę zespołu.
CzytamyPola status (open, resolved, pending) i assigned_user_id każdej rozmowy.
AsystentWykrywa rozmowy bez przypisanego agenta i te czekające zbyt długo, żeby żadne pytanie nie zostało bez odpowiedzi.
CzytamyEndpoint POST /api/v1/accounts/{id}/conversations/{id}/messages, pole content i typ wiadomości.
AsystentWysyła gotową odpowiedź do klienta jako wiadomość od agenta, gdy dopasowanie semantyczne do bazy wiedzy przekracza ustalony próg.
CzytamyEndpoint POST /api/v1/accounts/{id}/conversations/{id}/assignments z ID agenta lub grupy dyżurnej.
AsystentPrzekazuje rozmowę do właściwego agenta lub grupy przy eskalacji, bez czekania na ręczne przypisanie przez zespół.
CzytamyWiadomości klientów z ostatnich 30 dni, filtrowane po roli użytkownika i zakresie dat.
AsystentGrupuje tematy pytań i przygotowuje tygodniowe albo miesięczne zestawienie najczęstszych spraw dla całego zespołu.
CzytamyTabele bazy przy self-hostingu: conversations, messages, contacts, contact_inboxes bez limitów API.
AsystentWykonuje zapytania analityczne na pełnym zbiorze danych, przydatne przy dużych wolumenach rozmów i raportach za dłuższe okresy.
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Ile rozmów z ostatniego miesiąca czeka nadal bez odpowiedzi?”
- „O co klienci pytają najczęściej w czacie na stronie?”
- „Które reklamacje zgłoszone przez e-mail nie zostały jeszcze obsłużone?”
- „Ile czasu mija od pierwszej wiadomości klienta do odpowiedzi agenta?”
Co się zmienia
Sprzedawcy przestają przepisywać te same odpowiedzi, a co tydzień dostają raport tematów z czatu, żeby uzupełnić ofertę albo FAQ.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Chatwoot to skrzynka zbiorcza do obsługi klientów, dostępna jako open source. W jednym widoku lądują wiadomości z czatu na stronie, e-maila i Messengera. Każda rozmowa ma status (otwarta, rozwiązana, oczekująca), przypisanego agenta i tagi nadawane przez zespół. Sprawdza się w firmach, które chcą hostować system u siebie i mieć pełen dostęp do bazy danych.
Na co dzień agenci pracują w widoku kolejki rozmów: widzą, które czekają zbyt długo, kto jest przypisany i z jakiego kanału przyszła wiadomość. Dane trzymane są albo na własnym serwerze firmy (self-hosting, baza PostgreSQL), albo w wersji cloud Chatwoot. Przy self-hostingu firma ma bezpośredni wgląd w tabele bazy, co pozwala na zapytania analityczne bez limitów wywołań API.
Gdzie to działa najlepiej
Sprzedawca w biurze
Klient pisze przez Messengera o dostępność okna w określonym rozmiarze i kolorze. W kolejce czeka jeszcze kilka innych rozmów, a sprzedawca prowadzi właśnie rozmowę telefoniczną.
Z asystentem: Asystent odbiera wiadomość przez webhook, przeszukuje cennik i odpowiada w ciągu sekund. Sprzedawca wraca do kolejki bez zaległości i bez przerywania rozmowy.
Konsultant obsługi klienta
Klient przysłał trzecią wiadomość z rzędu, wyraźnie niezadowolony, że nikt nie odpowiedział na pytanie o status reklamacji złożonej tydzień temu. Asystent ocenia ton wiadomości i wykrywa eskalację.
Z asystentem: Rozmowa trafia do konsultanta z notatką: imię klienta, kanał, streszczenie wątku i informacja, że klient czekał bez odpowiedzi. Konsultant wie, z czym się zmierzy, zanim napisze pierwsze słowo.
Właściciel lub manager
Koniec miesiąca. Właściciel chce wiedzieć, o co klienci pytali najczęściej, żeby uzupełnić FAQ na stronie i przygotować handlowców przed nadchodzącym sezonem.
Z asystentem: Asystent pobiera wiadomości z ostatnich 30 dni, grupuje tematy i dostarcza zestawienie najczęstszych pytań. Właściciel wie, co dopisać do oferty, bez ręcznego przeszukiwania setek rozmów.
Jak się łączymy
Łączymy się przez REST API Chatwoot pod /api/v1/accounts/{account_id}/conversations i /api/v1/accounts/{account_id}/contacts. Access token pobieramy z Profile Settings > Access Token w panelu Chatwoot. Webhooki konfigurujemy w Settings > Integrations > Webhooks, żeby zdarzenia przychodziły do systemu w czasie rzeczywistym.
Przy self-hostingu mamy też bezpośredni dostęp do bazy PostgreSQL. Zapis (odpowiedź do klienta, przypisanie agenta, notatka dla zespołu) odbywa się przez API po ocenie asystenta, nie automatycznie. Portal z bazami i historią rozmów stoi na serwerze klienta. Do modelu AI trafia treść pytania i fragmenty z bazy wiedzy potrzebne do odpowiedzi, bez trenowania modeli na danych klienta.
Czego potrzebujemy od Was
- Self-hosted Chatwoot na własnym serwerze albo aktywne konto w wersji cloud Chatwoot.
- Access token z Profile Settings > Access Token w panelu Chatwoot.
- Skonfigurowane webhooki w Settings > Integrations > Webhooks.
- Dokumenty do bazy wiedzy: FAQ, cennik, regulamin, procedury obsługi w formacie PDF, Word lub TXT.
- Osoba po stronie firmy odpowiedzialna za aktualizację bazy wiedzy przy zmianach w ofercie.
Czego asystent nie robi
- Nie odpowiada samodzielnie na pytania spoza bazy wiedzy: przekazuje je agentowi z notatką.
- Nie zmienia danych kontaktu (imię, e-mail, telefon) w Chatwoot bez potwierdzenia przez agenta.
- Nie odświeża bazy wiedzy automatycznie: aktualizację dokumentów inicjuje wyznaczona osoba z firmy.
- Nie przypisuje rozmowy do agenta poza regułami eskalacji uzgodnionymi przy wdrożeniu.
Częste pytania
Czy klient zobaczy, że odpowiada mu AI, a nie człowiek?
Rekomendujemy oznaczenie wiadomości asystenta podpisem lub zdaniem zachęcającym do kontaktu z konsultantem. Klienci dobrze to przyjmują, bo wiedzą, czego się spodziewać. Ostateczną decyzję o formie i treści komunikatu podejmuje firma przy wdrożeniu.
Co jeśli mamy kilka skrzynek dla różnych działów?
Integrację można ustawić na wybraną skrzynkę albo na kilka jednocześnie, z osobnymi regułami eskalacji i oddzielną bazą wiedzy dla każdego działu. Zakres (które skrzynki, jakie tagi, kto dostaje eskalację) ustalamy przy wdrożeniu i zapisujemy w konfiguracji.
Czy musimy zmieniać coś w obecnej konfiguracji Chatwoot przed startem?
Zazwyczaj wystarczy wygenerować Access Token w Profile Settings i dodać webhook w Settings > Integrations > Webhooks. Nie ruszamy konfiguracji agentów ani istniejących skrzynek. Przed startem sprawdzamy, czy endpoint POST /conversations/{id}/messages zwraca 200 na Waszym planie, bo to weryfikacja uprawnień do wysyłki.
Jak często trzeba aktualizować bazę wiedzy, żeby odpowiedzi były aktualne?
Bazę wiedzy odświeżamy przy każdej zmianie w ofercie lub procedurach: przez skrypt wywoływany ręcznie albo harmonogramem raz na tydzień. Bez aktualizacji asystent odpowiada na podstawie starych informacji. Ktoś z firmy musi pilnować, żeby aktualny cennik i regulamin wróciły do indeksu.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Pokażemy to na Waszych danych z Chatwoot
Jedno zdanie wystarczy: czego szukacie w Chatwoot albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.
Inne programy: obsługa klienta i marketing
Chatwoot jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.