Uruchom przepływ Typebot w WhatsApp dzięki Coexistence
Kanał WhatsApp w Typebot wymaga tokenu, identyfikatora konta WhatsApp Business Account oraz identyfikatora numeru telefonu, a w zamian podaje callback URL i token weryfikacyjny. Pierwsze trzy wartości weź z podłączonego numeru, opcjonalny klucz tajny aplikacji w Typebot zostaw pusty, a callback URL i token weryfikacyjny ustaw jako miejsce docelowe webhooka numeru.
Typebot wymienia integrację z WhatsApp jako funkcję planu Pro, a nie planów Free ani Starter.
Typebot sprawdza podpis webhooka tylko wtedy, gdy wraz z danymi uwierzytelniającymi zapisano klucz tajny aplikacji.
Kreator Typebot odrzuca token, którego wygasanie nie jest ustawione na „nigdy”.
Stała przepustowość dla numeru używanego jednocześnie w aplikacji WhatsApp Business i w Cloud API.
Które pola Typebot przyjmują wartości z podłączonego numeru?
Kreator WhatsApp w Typebot, na karcie Share w ustawieniach bota, prosi o cztery rzeczy: App secret, System User Token, WhatsApp Business Account ID i Phone number ID.
Trzy z nich pochodzą wprost z połączenia. Panel pokazuje identyfikator WABA, identyfikator numeru telefonu i token dostępu dla numeru, a narzędzie get_api_credentials zwraca te same wartości, jeśli pobiera je za Ciebie asystent. Wklej je do odpowiednich pól.
Klucz tajny aplikacji (App secret) zostaw pusty. Typebot używa go do jednego celu przy ruchu przychodzącym: sprawdza nagłówek X-Hub-Signature-256, który Meta dodaje do każdej dostawy. Dla numeru podłączonego przez Tech Provider Meta podpisuje dostawy kluczem tajnym aplikacji dostawcy, który nigdy nie jest udostępniany, więc każda wartość wpisana w to pole sprawi, że Typebot odrzuci wszystkie prawdziwe wiadomości. Przy pustym polu Typebot pomija to sprawdzenie i przyjmuje dostawę.
Gdzie wpisać callback URL i token weryfikacyjny z Typebot?
W miejscu docelowym webhooka numeru, a nie w panelu aplikacji Meta.
Kreator Typebot każe wkleić „Callback URL” i „Verify Token” w ustawieniach WhatsApp Twojej własnej aplikacji Meta. Przy Coexistence przez EasyCoexistence nie ma żadnej Twojej aplikacji: Meta kieruje zdarzenia numeru tam, gdzie wskazuje połączenie. Skopiuj więc obie wartości z ostatniego kroku Typebot i ustaw je jako miejsce docelowe, w panelu lub przez set_webhook_destination.
Następnie Meta wysyła do Typebot żądanie weryfikacyjne GET, Typebot odpowiada na wyzwanie i od tej chwili każda wiadomość wysłana na numer trafia do bota. Token weryfikacyjny Typebot jest jednorazowy: jest usuwany z bazy danych Typebot w chwili udanej weryfikacji. Jeśli później ustawisz miejsce docelowe ponownie, najpierw wygeneruj nowy token, uruchamiając kreator jeszcze raz.
Co bot robi z 24-godzinnym oknem?
Typebot odpowiada osobom, które do niego napisały, dzięki czemu prawie każda wiadomość mieści się w oknie obsługi klienta. Meta otwiera 24-godzinne okno za każdym razem, gdy klient pisze, a w jego trakcie można wysłać dowolny typ wiadomości serwisowej bez szablonu. Bot, który tylko odpowiada, to więc najprostszy przypadek.
Problem zaczyna się przy przepływie, który czeka. Blok Wait albo sesja wznawiana po tym, jak klient milczał ponad dobę, spróbuje wysłać dowolny tekst poza oknem, a Meta odrzuci go z błędem 131047. Limit czasu wygaśnięcia sesji w Typebot, domyślnie 4 godziny i do 48 godzin, określa, kiedy wracający klient zaczyna nową rozmowę, a nie czy Meta przyjmie wiadomość.
Ponieważ to Coexistence, zespół nadal widzi każdą rozmowę w aplikacji WhatsApp Business i może wkroczyć z telefonu, gdy bot nie powinien odpowiadać.
Typowe błędy
- Wklejenie klucza tajnego aplikacji Meta do Typebot. Dostawy są podpisane kluczem tajnym Tech Provider, więc Typebot odrzuca każdą wiadomość jako mającą nieprawidłowy podpis.
- Ponowne użycie starego tokenu weryfikacyjnego Typebot. Jest usuwany po jednej udanej weryfikacji, więc ponowne ustawienie miejsca docelowego wymaga nowego tokenu z kreatora.
- Udostępnianie callback URL. Przy wyłączonym sprawdzaniu podpisu to znajomość adresu URL wpuszcza żądanie, więc traktuj go jak hasło.
Podłącz numer na easycoexistence.com, skopiuj jego token, identyfikator WABA i identyfikator numeru telefonu do Typebot, a callback URL z Typebot ustaw jako miejsce docelowe webhooka. Od US$ 9 za numer miesięcznie, spadek do US$ 1 w miarę dodawania numerów, z bezpłatnym 3-dniowym okresem próbnym.
Najczęściej zadawane pytania
Czy potrzebuję własnej aplikacji Meta do Typebot?
Nie. Przewodnik Typebot ją zakłada, bo większość osób podłącza numer samodzielnie. Przy Coexistence przez Tech Provider token i identyfikatory pochodzą z połączenia, a webhook Meta kieruje do Typebot.
Czy zespół nadal zobaczy wiadomości bota na telefonie?
Tak. Wiadomości wysłane przez Cloud API pojawiają się w aplikacji WhatsApp Business na tym samym numerze, więc człowiek może przeczytać wątek i przejąć rozmowę.
Czy Typebot i n8n mogą jednocześnie odbierać wiadomości tego samego numeru?
Nie. Numer ma jedno miejsce docelowe webhooka. Jeśli oba narzędzia potrzebują zdarzeń, skieruj miejsce docelowe na n8n i niech przepływ przekazuje surowy payload do callback URL w Typebot.
Czy Typebot przechowuje rozmowy?
Typebot przechowuje własne dane sesji i wyników, tak jak w każdym kanale. EasyCoexistence nigdy nie przechowuje treści wiadomości: Meta dostarcza je prosto do ustawionego przez Ciebie miejsca docelowego.
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