Podłącz bota Botpress do WhatsApp dzięki Coexistence
Skorzystaj z integracji WhatsApp w Botpress w trybie Manual Configuration. Wklej token dostępu podłączonego numeru i phone number id, wybierz verify token, a pola App ID i Client Secret zostaw puste. Następnie ustaw adres URL webhooka Botpress i ten verify token jako miejsce docelowe webhooka numeru, a Meta będzie dostarczać każdą wiadomość do bota.
Pole Client Secret w Botpress: jeśli zostanie puste, weryfikacja podpisu webhooka jest pomijana.
Pola webhooka, które subskrybuje przewodnik Botpress, w tym wiadomości i aktualizacje statusu szablonów.
Okno obsługi klienta, które otwiera wiadomość klienta i w którym można wysłać dowolną wiadomość serwisową.
Która konfiguracja Botpress działa z numerem Coexistence?
Manual Configuration. Pozostałe opcje podłączają numer przez własną aplikację Meta w Botpress, co oznacza osobny proces wdrożenia numeru, a nie wykorzystanie numeru już podłączonego.
W integracji WhatsApp otwórz listę Configuration i wybierz Manual Configuration. Wymaga ona pól Verify Token, Access Token i Default Bot Phone Number ID, a opcjonalnie App ID, Client Secret i WABA ID.
Token dostępu, phone number id i WABA id pochodzą z połączenia: pokazuje je panel, a get_api_credentials zwraca je asystentowi. Verify token to dowolny ciąg znaków, który wybierasz. App ID i Client Secret zostają puste. Przewodnik Botpress przedstawia sekret jako pole do wypełnienia, ale definicja integracji oznacza je jako opcjonalne i podaje, że bez niego weryfikacja podpisu jest pomijana. To ważne, ponieważ Meta podpisuje każdą dostawę sekretem aplikacji Tech Provider, którego nie posiada żaden klient.
Jak webhook Botpress otrzymuje wiadomości z Meta?
Przez miejsce docelowe webhooka numeru. Przewodnik Botpress każe wkleić adres URL jego webhooka i Twój verify token w konfiguracji WhatsApp aplikacji Meta. Tutaj nie ma Twojej aplikacji Meta: Meta kieruje zdarzenia numeru tam, gdzie wskazuje połączenie. Skopiuj więc adres URL webhooka, który Botpress pokazuje dla integracji, i ustaw go razem z tym samym verify tokenem jako miejsce docelowe w panelu lub przez set_webhook_destination.
Meta wysyła weryfikacyjne GET, Botpress na nie odpowiada i rozpoczyna się dostarczanie. Gdy Botpress zapisuje ręczną konfigurację, sprawdza też token, pytając Graph, która aplikacja go wystawiła. Nieprawidłowy lub unieważniony token kończy się więc błędem przy zapisie, a nie przy pierwszej wiadomości.
Handler Botpress obsługuje również smb_message_echoes, czyli zdarzenie, które Meta wysyła, gdy ktoś odpowiada z aplikacji WhatsApp Business. Dzięki temu odpowiedź z telefonu jest widoczna dla bota, a nie niewidoczna.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Co bot powinien wiedzieć o Coexistence?
Że rozmawiać może już człowiek. Aplikacja WhatsApp Business nadal działa na numerze, więc klient może dostać odpowiedź z telefonu i od bota w ciągu tej samej minuty. Zdecyduj w przepływie, co dzieje się po nadejściu echa: większość zespołów wstrzymuje bota dla danego kontaktu na pewien czas, aby nie wchodzić w słowo osobie, która przejęła rozmowę.
Druga sprawa to czas. Bot odpowiadający na przychodzące wiadomości działa w 24-godzinnym oknie obsługi klienta, w którym dowolny tekst jest dozwolony. Przepływ wysyłający coś dzień później, na przykład kontynuację lub przypomnienie, wymaga zatwierdzonego szablonu, a dowolny tekst zwróci tam błąd 131047. Przewodnik Botpress subskrybuje pola statusu szablonów właśnie z myślą o takich proaktywnych wiadomościach.
Przepustowość jest stała i wynosi 20 wiadomości na sekundę dla numeru Coexistence, czyli znacznie więcej, niż wysyła bot konwersacyjny.
Typowe błędy
- Wpisanie w Client Secret sekretu własnej aplikacji Meta. Podpis nigdy się nie zgadza, a Botpress odpowiada na każdą dostawę kodem 401.
- Wybranie opcji OAuth lub sandbox zamiast Manual Configuration. Te opcje podłączają numer przez własną aplikację Botpress, a nie ten już podłączony.
- Ignorowanie ech. Bez reguły dla odpowiedzi wysłanych z telefonu bot odpowiada w miejsce osoby, która już przejęła rozmowę.
Podłącz numer na easycoexistence.com, wklej jego token i phone number id w Manual Configuration w Botpress i ustaw adres URL webhooka Botpress jako miejsce docelowe. Od US$ 9 za numer miesięcznie, malejąco do US$ 1 wraz z dodawaniem kolejnych numerów, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Czy pominięcie sprawdzania podpisu jest bezpieczne?
Ochrona przenosi się na adres URL. Botpress generuje adres URL webhooka osobno dla każdej integracji, więc zachowaj go w tajemnicy. Multimedia nadal trzeba pobrać z Meta za pomocą tokenu, czego sfałszowane zdarzenie nie potrafi podrobić.
Czy ten sam numer może zasilać także n8n?
Numer ma jedno miejsce docelowe webhooka. Wskaż jeden system i przekazuj zdarzenia dalej stamtąd, jeśli potrzebuje ich drugi.
Czy Botpress potrzebuje mojego WABA id?
Jego definicja oznacza to pole jako opcjonalne na razie i podaje, że będzie wymagane w przyszłej wersji głównej, więc uzupełnij je danymi z połączenia.
Czy wiadomości przechodzą przez EasyCoexistence?
Nie. Meta dostarcza je prosto na adres URL webhooka Botpress, a treść nigdy nie jest przechowywana po naszej stronie.
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