Connecter un bot Botpress à WhatsApp avec Coexistence
Utilisez l'intégration WhatsApp de Botpress en Manual Configuration. Collez le token d'accès et l'ID du numéro de téléphone du numéro connecté, choisissez un token de vérification, et laissez App ID et Client Secret vides. Définissez ensuite l'URL de webhook de Botpress et ce token de vérification comme destination de webhook du numéro, et Meta livre chaque message au bot.
Le champ Client Secret de Botpress : s'il reste vide, la vérification de signature du webhook est ignorée.
Les champs de webhook auxquels le guide de Botpress s'abonne, dont les messages et les mises à jour de statut des templates.
La fenêtre de service client qu'ouvre le message d'un client, et dans laquelle tout message de service peut être envoyé.
Quelle configuration Botpress fonctionne avec un numéro Coexistence ?
Manual Configuration. Les autres options connectent un numéro via l'app Meta de Botpress, ce qui constitue un onboarding distinct du numéro et non un moyen d'utiliser un numéro déjà connecté.
Dans l'intégration WhatsApp, ouvrez le menu déroulant Configuration et choisissez Manual Configuration. Elle demande un Verify Token, un Access Token, un Default Bot Phone Number ID, et en option un App ID, un Client Secret et un WABA ID.
Le token d'accès, l'ID du numéro de téléphone et l'ID WABA proviennent de la connexion : le dashboard les affiche, et get_api_credentials les renvoie à un assistant. Le token de vérification est la chaîne de votre choix. App ID et Client Secret restent vides. Le guide de Botpress présente le secret comme un champ à remplir, mais la définition de son intégration le marque comme optionnel et précise que sans lui la vérification de signature est ignorée. C'est important, car Meta signe chaque livraison avec le secret d'app du Tech Provider, qu'aucun client ne détient.
Comment le webhook Botpress reçoit-il les messages de Meta ?
Par la destination de webhook du numéro. Le guide de Botpress vous fait coller son URL de webhook et votre token de vérification dans la configuration WhatsApp d'une app Meta. Ici, vous n'avez pas d'app Meta : Meta route les événements du numéro vers la destination que nomme la connexion. Copiez donc l'URL de webhook que Botpress affiche pour l'intégration et définissez-la, avec le même token de vérification, comme destination dans le dashboard ou avec set_webhook_destination.
Meta envoie un GET de vérification, Botpress y répond, et la livraison démarre. Quand Botpress enregistre une configuration manuelle, il contrôle aussi le token en demandant à Graph quelle app l'a émis : un token invalide ou révoqué échoue donc à l'enregistrement, et non au premier message.
Le gestionnaire de Botpress traite aussi smb_message_echoes, l'événement que Meta envoie quand quelqu'un répond depuis l'app WhatsApp Business. Une réponse donnée depuis le téléphone est donc visible du bot au lieu de lui échapper.
| 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 |
Que doit savoir le bot à propos de Coexistence ?
Qu'un humain est peut-être déjà en train de discuter. L'app WhatsApp Business continue de fonctionner sur le numéro : un client peut donc recevoir une réponse du téléphone et une du bot dans la même minute. Décidez dans le flow de ce qui se passe à l'arrivée d'un écho : la plupart des équipes mettent le bot en pause pour ce contact pendant un temps, afin que la personne qui est intervenue ne soit pas interrompue.
Le second point est le délai. Un bot qui répond aux messages entrants travaille dans la fenêtre de service client de 24 heures, où le texte libre est autorisé. Un flow qui envoie quelque chose un jour plus tard, une relance ou un rappel, exige un template approuvé, et un texte libre renvoie alors l'erreur 131047. Le guide de Botpress s'abonne aux champs de statut des templates précisément pour ce type de message proactif.
Enfin, le débit est fixé à 20 messages par seconde pour un numéro Coexistence, bien au-delà de ce qu'envoie un bot conversationnel.
Erreurs courantes
- Renseigner Client Secret avec le secret de votre propre app Meta. La signature ne correspond jamais et Botpress répond 401 à chaque livraison.
- Choisir l'option OAuth ou sandbox au lieu de Manual Configuration. Elles connectent un numéro via l'app de Botpress, pas celui qui est déjà connecté.
- Ignorer les échos. Sans règle pour les réponses envoyées depuis le téléphone, le bot répond par-dessus une personne déjà intervenue.
Connectez le numéro sur easycoexistence.com, collez son token et l'ID du numéro de téléphone dans la Manual Configuration de Botpress, puis définissez l'URL de webhook de Botpress comme destination. À partir de US$ 9 par numéro et par mois, jusqu'à US$ 1 à mesure que vous ajoutez des numéros, avec les 3 premiers jours gratuits.
Questions fréquemment posées
Ignorer la vérification de signature est-il sûr ?
La protection se déplace vers l'URL. Botpress génère l'URL de webhook pour chaque intégration : gardez-la privée. Les médias doivent toujours être récupérés auprès de Meta avec le token, ce qu'un événement falsifié ne peut pas simuler.
Le même numéro peut-il aussi alimenter n8n ?
Un numéro n'a qu'une seule destination de webhook. Pointez-la vers un système, puis transférez les événements depuis celui-ci si un second en a besoin.
Botpress a-t-il besoin de mon ID WABA ?
Sa définition le marque comme optionnel pour l'instant et indique qu'il sera obligatoire dans une future version majeure : renseignez-le donc à partir de la connexion.
Les messages transitent-ils par EasyCoexistence ?
Non. Meta livre directement à l'URL de webhook de Botpress, et le contenu n'est jamais stocké de notre côté.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le