Conectați un bot Botpress la WhatsApp cu Coexistence
Folosiți integrarea WhatsApp din Botpress în modul Manual Configuration. Lipiți token-ul de acces și phone number id ale numărului conectat, alegeți un verify token și lăsați goale App ID și Client Secret. Apoi setați URL-ul de webhook din Botpress și acel verify token ca destinație de webhook a numărului, iar Meta livrează fiecare mesaj botului.
Câmpul Client Secret din Botpress: dacă rămâne gol, verificarea semnăturii webhook-ului este omisă.
Câmpurile de webhook la care se abonează ghidul Botpress, printre ele mesajele și actualizările de status ale template-urilor.
Fereastra de serviciu pentru clienți pe care o deschide mesajul unui client, în care se poate trimite orice mesaj de serviciu.
Ce configurare Botpress funcționează cu un număr Coexistence?
Manual Configuration. Celelalte opțiuni conectează un număr prin aplicația Meta proprie a Botpress, ceea ce înseamnă o a doua onboardare a numărului, nu o modalitate de a-l folosi pe cel deja conectat.
În integrarea WhatsApp, deschideți meniul derulant Configuration și alegeți Manual Configuration. Vi se cer un Verify Token, un Access Token, un Default Bot Phone Number ID și, opțional, un App ID, un Client Secret și un WABA ID.
Token-ul de acces, phone number id și WABA id provin din conexiune: dashboard-ul le afișează, iar get_api_credentials le returnează unui asistent. Verify token este orice șir ales de dumneavoastră. App ID și Client Secret rămân goale. Ghidul Botpress prezintă secretul ca pe un câmp de completat, dar definiția integrării îl marchează ca opțional și precizează că, fără el, verificarea semnăturii este omisă. Contează, pentru că Meta semnează fiecare livrare cu secretul aplicației Tech Provider, pe care niciun client nu îl deține.
Cum primește webhook-ul Botpress mesajele de la Meta?
Prin destinația de webhook a numărului. Ghidul Botpress vă cere să lipiți URL-ul său de webhook și verify token în configurarea WhatsApp a unei aplicații Meta. Aici nu există nicio aplicație Meta a dumneavoastră: Meta direcționează evenimentele numărului către destinația pe care o indică conexiunea. Copiați deci URL-ul de webhook afișat de Botpress pentru integrare și setați-l, împreună cu același verify token, ca destinație în dashboard sau cu set_webhook_destination.
Meta trimite un GET de verificare, Botpress îl confirmă, iar livrarea începe. Când Botpress salvează o configurare manuală, verifică și token-ul, întrebând Graph ce aplicație l-a emis, așa că un token invalid sau revocat eșuează la salvare, nu la primul mesaj.
Handlerul Botpress procesează și smb_message_echoes, evenimentul pe care Meta îl trimite când cineva răspunde din aplicația WhatsApp Business. Astfel, un răspuns dat de pe telefon este vizibil pentru bot, nu rămâne ascuns de el.
| 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 |
Ce trebuie să știe botul despre Coexistence?
Că un om poate vorbi deja cu clientul. Aplicația WhatsApp Business continuă să funcționeze pe număr, deci un client poate primi un răspuns de pe telefon și unul de la bot în același minut. Stabiliți în flux ce se întâmplă când sosește un ecou: majoritatea echipelor pun botul în pauză pentru acel contact o vreme, ca persoana care a intervenit să nu fie întreruptă.
Al doilea aspect este momentul trimiterii. Un bot care răspunde mesajelor primite lucrează în fereastra de serviciu de 24 de ore, în care textul liber este permis. Un flux care trimite ceva după o zi, o urmărire sau o reamintire, are nevoie de un template aprobat, iar textul liber returnează acolo eroarea 131047. Ghidul Botpress se abonează la câmpurile de status ale template-urilor tocmai pentru acest tip de mesaj proactiv.
Iar debitul este fixat la 20 de mesaje pe secundă pentru un număr Coexistence, mult peste ceea ce trimite un bot conversațional.
Greșeli frecvente
- Completarea Client Secret cu secretul propriei aplicații Meta. Semnătura nu se potrivește niciodată, iar Botpress răspunde cu 401 la fiecare livrare.
- Alegerea opțiunii OAuth sau sandbox în loc de Manual Configuration. Acestea conectează un număr prin aplicația proprie a Botpress, nu prin cea deja conectată.
- Ignorarea ecourilor. Fără o regulă pentru răspunsurile trimise de pe telefon, botul răspunde peste o persoană care a intervenit deja.
Conectați numărul pe easycoexistence.com, lipiți token-ul și phone number id în Manual Configuration din Botpress și setați URL-ul de webhook Botpress ca destinație. De la US$ 9 pe număr pe lună, scăzând la US$ 1 pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Este sigur să omit verificarea semnăturii?
Protecția se mută la nivelul URL-ului. Botpress generează URL-ul de webhook pentru fiecare integrare, deci păstrați-l privat. Media trebuie în continuare preluată de la Meta cu token-ul, lucru pe care un eveniment falsificat nu îl poate imita.
Poate același număr să alimenteze și n8n?
Un număr are o singură destinație de webhook. Îndreptați-o spre un sistem și redirecționați de acolo, dacă un al doilea are nevoie de evenimente.
Are Botpress nevoie de WABA id?
Definiția îl marchează deocamdată ca opțional și precizează că va fi obligatoriu într-o versiune majoră viitoare, așa că completați-l din conexiune.
Trec mesajele prin EasyCoexistence?
Nu. Meta livrează direct la URL-ul de webhook Botpress, iar conținutul nu este stocat niciodată de partea noastră.
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