Połącz WhatsApp z Activepieces na numerze Coexistence

Jak połączyć numer Coexistence z Activepieces?

Utwórz w Activepieces połączenie WhatsApp Business z dwiema wartościami: tokenem dostępu i identyfikatorem konta WhatsApp Business Account. Panel EasyCoexistence pokazuje obie dla danego połączenia, a get_api_credentials zwraca je asystentowi. Instrukcja elementu mówi o tworzeniu aplikacji Meta i użytkownika systemowego, bo zakłada, że nie masz żadnego z nich. Tutaj numer jest już połączony, więc od razu wklej wartości.

Następnie zbuduj przepływ zaczynający się od wyzwalacza New Incoming Message, ustaw w nim wybrany przez siebie verify token i opublikuj przepływ. Skopiuj adres URL webhooka wyzwalacza do miejsca docelowego webhooka numeru w EasyCoexistence, z tym samym verify tokenem. Meta wyśle żądanie weryfikacji, wyzwalacz na nie odpowie, a każda wiadomość na numer uruchomi przepływ.

Dlaczego app secret musi zostać puste?

Ponieważ sekret podpisujący te dostarczenia nie należy do Ciebie. Meta podpisuje każdy webhook sekretem aplikacji, która jest właścicielem subskrypcji, a w numerze połączonym przez EasyCoexistence jest to aplikacja EasyCoexistence, której sekret nigdy nie jest udostępniany.

Element traktuje to pole jako opcjonalne. Puste: jego wyzwalacze przyjmują dostarczenia bez sprawdzania podpisu. Wypełnione sekretem innej aplikacji: każde dostarczenie nie przechodzi kontroli X-Hub-Signature-256 i jest po cichu ignorowane, co wygląda dokładnie tak, jakby wiadomości w ogóle nie docierały.

Verify token chroni uzgadnianie przed osobami z zewnątrz. Wybierz długą, losową wartość i nie udostępniaj adresu URL wyzwalacza, bo to właśnie on uruchamia Twój przepływ.

Co może zrobić przepływ po nadejściu wiadomości?

Wyzwalacz przekazuje przepływowi spłaszczoną wiadomość: nadawcę, nazwę profilu, identyfikator wiadomości, typ, tekst, ewentualny identyfikator multimediów, odpowiedzi z przycisków i list oraz identyfikator numeru telefonu, który ją odebrał. Dalej jest to zwykły przepływ Activepieces z innymi elementami, takimi jak CRM, arkusz czy krok z AI.

Odpowiedzi wysyłasz tym samym elementem. Send Message wysyła dowolny tekst i dostarcza go tylko w ciągu 24 godzin od ostatniej wiadomości klienta. Send Template Message wysyła zatwierdzony szablon, który jako jedyny dociera po upływie tego okna. Przyciski interaktywne, listy, multimedia, lokalizacja i reakcje to osobne akcje.

Instrukcja Activepieces zaznacza, że Meta przyjmuje jeden adres URL wywołania zwrotnego na aplikację. Przy miejscach docelowych przypisanych do numerów limit to jeden adres URL na numer, więc przepływ obsługujący kilka typów zdarzeń powinien rozgałęziać się wewnątrz jednego przepływu.

Czy odpowiedzi wpisane na telefonie trafiają do przepływu?

Trafiają do webhooka, ale nie do tego wyzwalacza. Na numerze Coexistence Meta wysyła echo każdej odpowiedzi wpisanej w aplikacji WhatsApp Business na to samo miejsce docelowe, w polu smb_message_echoes. Wyzwalacz New Incoming Message czyta tylko pole messages i odrzuca resztę.

Jeśli potrzebujesz w przepływie odpowiedzi z telefonu, zacznij go od ogólnego elementu Webhook w Activepieces, który przyjmuje dowolną metodę HTTP, a na weryfikacyjne żądanie GET odpowiedz krokiem Return Response pod jego synchronicznym adresem URL. Wtedy sam analizujesz surowy payload, w tym oba pola.

W większości przepływów prostszym wyborem jest wyzwalacz z elementu: reaguje na klientów, a odpowiedzi zespołu pozostają widoczne w aplikacji na telefonie.

Typowe błędy

• Wklejenie app secret do połączenia WhatsApp. Dostarczenia są podpisane sekretem aplikacji EasyCoexistence, więc każde z nich zostanie zignorowane.
• Ustawienie miejsca docelowego przed opublikowaniem przepływu. Meta weryfikuje je natychmiast, a nieopublikowany przepływ nie może odpowiedzieć.
• Oczekiwanie, że wyzwalacz New Incoming Message zobaczy odpowiedzi wpisane na telefonie. Czyta on tylko pole messages, a nie smb_message_echoes.

Najczęściej zadawane pytania

Czytaj dalej