Numer Coexistence jako skrzynka WhatsApp Cloud w Chatwoot
Skrzynka WhatsApp Cloud w Chatwoot prosi o trzy wartości: identyfikator konta WhatsApp Business (WABA id), phone number id oraz token dostępu. Numer Coexistence udostępnia wszystkie trzy. Utwórz z nimi skrzynkę, a potem ustaw jako miejsce docelowe webhooka numeru adres URL webhooka z Chatwoot wraz z tym samym tokenem weryfikacyjnym. Zespół odpowie wtedy z Chatwoot, a Ty z telefonu.
WABA id, phone number id i token dostępu: tego wymaga ręczna konfiguracja WhatsApp Cloud w Chatwoot.
Chatwoot obsługuje to zdarzenie Coexistence, więc odpowiedzi wysłane z aplikacji WhatsApp Business pojawiają się w rozmowie.
Meta pozwala, by numer telefonu firmy miał własny adres URL wywołania zwrotnego webhooka, który zastępuje domyślny adres aplikacji.
Jak połączyć numer Coexistence z Chatwoot?
W dwóch miejscach, w tej kolejności.
W Chatwoot dodaj skrzynkę, wybierz WhatsApp, a następnie dostawcę WhatsApp Cloud z konfiguracją ręczną. Wpisz numer, phone number id, identyfikator konta WhatsApp Business i token dostępu. Wszystkie te dane pokazuje panel EasyCoexistence przy danym połączeniu, a asystentowi zwraca je get_api_credentials. Chatwoot wyświetli wtedy adres URL webhooka i token weryfikacyjny webhooka dla skrzynki.
W EasyCoexistence ustaw jako miejsce docelowe webhooka numeru ten adres URL i wpisz ten sam token weryfikacyjny. Meta wyśle żądanie weryfikacyjne do Chatwoot, Chatwoot na nie odpowie i od tej chwili każda wiadomość do numeru trafia do skrzynki. Nic nie działa pośrodku, więc nie ma workflow, który trzeba pilnować.
Czy odpowiedzi wysłane z telefonu pojawiają się w Chatwoot?
Tak. Na numerze Coexistence odpowiedź wpisana w aplikacji WhatsApp Business jest zgłaszana przez Meta jako zdarzenie smb_message_echoes. Zadanie webhooka w Chatwoot rozpoznaje to pole i zapisuje wiadomość jako wychodzącą we właściwej rozmowie. Kod źródłowy opisuje ten przypadek wprost: firmy odpowiadające zarówno z Chatwoot, jak i z aplikacji, z wiadomościami synchronizowanymi do Chatwoot.
Dzięki temu podział pracy działa w praktyce. Właściciel może dalej odpowiadać stałym klientom z telefonu, zespół obsługuje wspólną skrzynkę przy biurku, a każdy widzi, co wysłał drugi, bez przesyłania zrzutów ekranu.
Wiadomości wysłane z Chatwoot wychodzą przez Cloud API na tym samym numerze, więc widać je także w telefonie.
Dlaczego skrzynka Chatwoot nie powinna mieć klucza tajnego aplikacji?
Ponieważ dostawy są podpisywane kluczem, którego nie masz. Meta podpisuje każdy webhook kluczem tajnym aplikacji, do której należy subskrypcja, czyli aplikacji EasyCoexistence, a ten klucz nigdy nie jest udostępniany.
Według obecnego kodu Chatwoot sprawdza nagłówek X-Hub-Signature-256 w ręcznie skonfigurowanym kanale WhatsApp Cloud tylko wtedy, gdy zapisano w nim klucz tajny aplikacji albo gdy kanał utworzono przez wbudowaną rejestrację Chatwoot (embedded signup). Skrzynka ręczna bez klucza przyjmuje dostawy, a skrzynka z jakimkolwiek wpisanym kluczem odrzuca każdą z nich jako nieautoryzowaną.
Ochroną, która tu obowiązuje, jest token weryfikacyjny. Wybierz długą losową wartość, ponieważ dzięki niej Chatwoot odróżnia żądanie weryfikacyjne od Meta od żądań kogokolwiek innego.
Czego Chatwoot nie zrobi na tym numerze?
Nie odbierze webhooków w drugim miejscu jednocześnie. Meta kieruje webhooki numeru do jednego miejsca docelowego, więc dopóki zajmuje je Chatwoot, workflow w n8n nie dostanie tych samych zdarzeń. Jeśli potrzebujesz obu, wskaż jako miejsce docelowe własny niewielki przekaźnik, który przekaże każdą dostawę do Chatwoot i do workflow.
Limity Coexistence obowiązują tak samo jak wszędzie: API wysyła do 20 wiadomości na sekundę, dowolny tekst można wysłać tylko w ciągu 24 godzin od ostatniej wiadomości klienta, a po tym czasie wszystko obsługują szablony.
Aplikację WhatsApp Business nadal trzeba otworzyć co najmniej raz na 14 dni, a EasyCoexistence tego pilnuje.
Typowe błędy
- Wpisanie klucza tajnego aplikacji w skrzynce Chatwoot. Dostawy są podpisane kluczem aplikacji EasyCoexistence, więc Chatwoot odrzuca każdą z nich jako nieautoryzowaną.
- Użycie w EasyCoexistence innego tokenu weryfikacyjnego niż ten, który pokazuje Chatwoot. Weryfikacja w Meta się nie powiedzie i skrzynka nie dostanie żadnej wiadomości.
- Wybór wbudowanej rejestracji Chatwoot (embedded signup) zamiast przepływu ręcznego. Łączy ona numer przez własną aplikację Meta Chatwoot, czyli osobne połączenie.
Połącz numer na easycoexistence.com, skopiuj jego dane dostępowe do skrzynki WhatsApp Cloud w Chatwoot i ustaw webhook na Chatwoot. Od US$ 9 za numer miesięcznie, spadając do US$ 1 wraz z dodawaniem kolejnych numerów, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy to działa w samodzielnie hostowanym Chatwoot?
Tak. Adres URL webhooka używa Twojej własnej domeny Chatwoot zamiast app.chatwoot.com, a reszta konfiguracji jest taka sama.
Czy potrzebuję własnej aplikacji Meta dla Chatwoot?
Nie. Numer jest połączony przez EasyCoexistence, które dostarcza dane dostępowe i kieruje webhooki. Przewodnik Chatwoot opisuje tworzenie aplikacji Meta tylko dlatego, że zakłada, iż jej nie masz.
Czy do Chatwoot można podłączyć kilka numerów?
Tak. Utwórz jedną skrzynkę WhatsApp Cloud na każdy numer i ustaw dla każdego numeru jako miejsce docelowe webhooka adres URL oraz token weryfikacyjny jego własnej skrzynki.
Czy EasyCoexistence widzi rozmowy?
Nie. Meta dostarcza webhooki prosto do Chatwoot, a EasyCoexistence nigdy nie przechowuje treści rozmów.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w