Conectați WhatsApp la Activepieces pe un număr Coexistence
Activepieces are o piesă WhatsApp Business care se conectează cu un token de acces și un id de WhatsApp Business Account, iar un număr Coexistence le oferă pe amândouă. Trigger-ul New Incoming Message răspunde singur la verificarea Meta, deci URL-ul lui poate fi destinația webhook-ului numărului. Lăsați gol câmpul opțional app secret al piesei, iar fluxul rulează la fiecare mesaj, în timp ce echipa folosește în continuare telefonul.
Acțiunile din piesa WhatsApp Business a Activepieces, inclusiv mesaje text, media, template și interactive, plus 4 trigger-e.
Trigger-ele piesei detectează acest parametru de interogare și returnează valoarea lui ca text simplu, încheind verificarea Meta.
Câmpul app secret al piesei; dacă este completat, livrările fără un X-Hub-Signature-256 corespunzător sunt ignorate.
Cum conectați un număr Coexistence la Activepieces?
Creați conexiunea WhatsApp Business în Activepieces cu două valori: token-ul de acces și id-ul WhatsApp Business Account. Dashboard-ul EasyCoexistence le afișează pe amândouă pentru conexiune, iar get_api_credentials le returnează unui asistent. Instrucțiunile piesei vorbesc despre crearea unei aplicații Meta și a unui utilizator de sistem, pentru că presupun că nu aveți niciuna. Aici numărul este deja conectat, deci treceți direct la lipirea valorilor.
Apoi construiți un flux care pornește cu trigger-ul New Incoming Message, setați pe el un verify token la alegere și publicați fluxul. Copiați URL-ul webhook-ului trigger-ului în destinația webhook-ului numărului din EasyCoexistence, cu același verify token. Meta trimite cererea de verificare, trigger-ul răspunde, iar fiecare mesaj primit de număr pornește o rulare.
De ce trebuie să rămână gol app secret?
Pentru că secretul care semnează aceste livrări nu este al dumneavoastră. Meta semnează fiecare webhook cu app secret al aplicației care deține abonamentul, iar pe un număr conectat prin EasyCoexistence aceasta este aplicația EasyCoexistence, al cărei secret nu este împărțit niciodată.
Piesa tratează câmpul ca opțional. Dacă rămâne gol, trigger-ele ei acceptă livrările așa cum vin. Dacă este completat cu secretul altei aplicații, fiecare livrare pică verificarea X-Hub-Signature-256 și este ignorată fără niciun semnal, ceea ce arată exact ca și cum mesajele nu ar mai ajunge.
Verify token-ul este cel care ține străinii departe de handshake. Alegeți o valoare lungă și aleatorie și păstrați privat URL-ul trigger-ului, deoarece este adresa care pornește fluxul.
Ce poate face un flux după ce sosește un mesaj?
Trigger-ul transmite fluxului un mesaj aplatizat: expeditorul, numele de profil, id-ul mesajului, tipul, textul, eventualul id de media, răspunsurile din butoane și liste și id-ul numărului de telefon care a primit mesajul. De acolo este un flux Activepieces obișnuit, cu celelalte piese ale lui, de exemplu un CRM, o foaie de calcul sau un pas de AI.
Răspunsurile folosesc aceeași piesă. „Send Message” trimite text liber și îl livrează doar în 24 de ore de la ultimul mesaj al clientului. „Send Template Message” trimite un template aprobat, singurul tip de mesaj care se livrează după această fereastră. Butoanele interactive, listele, media, locația și reacțiile sunt acțiuni separate.
Instrucțiunile Activepieces notează că Meta acceptă un singur URL de callback per aplicație. Cu destinații per număr, limita este un URL per număr, așa că un flux care trebuie să gestioneze mai multe tipuri de evenimente ar trebui să se ramifice în interiorul aceluiași flux.
Răspunsurile scrise pe telefon ajung în flux?
Ajung la webhook, dar nu la acest trigger. Pe un număr Coexistence, Meta trimite către aceeași destinație un echo al fiecărui răspuns scris în aplicația WhatsApp Business, sub câmpul smb_message_echoes. Trigger-ul New Incoming Message al piesei citește doar câmpul messages și ignoră tot restul.
Dacă aveți nevoie de răspunsurile de pe telefon în flux, porniți-l cu piesa generică Webhook din Activepieces, care acceptă orice metodă HTTP, și răspundeți la GET-ul de verificare cu un pas Return Response pe URL-ul ei sincron. Apoi analizați singur payload-ul brut, cu ambele câmpuri incluse.
Pentru majoritatea fluxurilor, trigger-ul piesei este alegerea mai simplă: reacționează la clienți, iar răspunsurile echipei rămân vizibile în aplicația de pe telefon.
Greșeli frecvente
- Lipirea unui app secret în conexiunea WhatsApp. Livrările sunt semnate cu secretul aplicației EasyCoexistence, deci toate sunt ignorate.
- Setarea destinației înainte de publicarea fluxului. Meta verifică imediat, iar un flux nepublicat nu poate răspunde.
- Așteptarea ca trigger-ul New Incoming Message să vadă răspunsurile scrise pe telefon. El citește doar câmpul messages, nu smb_message_echoes.
Conectați numărul la easycoexistence.com, lipiți token-ul și WABA id în Activepieces și setați destinația webhook-ului la URL-ul trigger-ului. De la US$ 9 per număr pe lună, scăzând până la US$ 1 pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Funcționează și pe Activepieces găzduit propriu?
Da. Piesa este open source și rulează pe cloud-ul Activepieces sau auto-găzduită, atât timp cât instanța este accesibilă prin HTTPS din internet.
De pe ce număr de telefon trimite un flux?
De pe cel pe care îl alegeți în câmpul de număr de telefon al acțiunii, care listează numerele din WhatsApp Business Account spre care indică conexiunea.
Pot folosi în continuare n8n sau Make pe același număr?
Nu în același timp. Meta direcționează webhook-urile unui număr către o singură destinație, așa că alegeți un singur instrument pentru primire sau redirecționați de la el către celălalt.
EasyCoexistence stochează mesajele?
Nu. Meta livrează fiecare webhook direct către trigger-ul Activepieces, iar EasyCoexistence nu stochează niciodată conținutul conversațiilor.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la