Connecter WhatsApp à Activepieces sur un numéro Coexistence

Comment connecter un numéro Coexistence à Activepieces ?

Créez la connexion WhatsApp Business dans Activepieces avec deux valeurs : le token d'accès et l'ID du compte WhatsApp Business. Le dashboard EasyCoexistence affiche les deux pour la connexion, et get_api_credentials les renvoie à un assistant. Les instructions de la pièce parlent de créer une app Meta et un utilisateur système, parce qu'elles supposent que vous n'avez ni l'une ni l'autre. Ici, le numéro est déjà connecté : passez directement au collage des valeurs.

Construisez ensuite un flow qui démarre par le déclencheur « Nouveau message entrant », définissez-y le verify token de votre choix, puis publiez le flow. Copiez l'URL du webhook du déclencheur dans la destination du webhook du numéro dans EasyCoexistence, avec le même verify token. Meta envoie sa requête de vérification, le déclencheur y répond, et chaque message adressé au numéro lance une exécution.

Pourquoi l'app secret doit-il rester vide ?

Parce que le secret qui signe ces envois n'est pas à vous. Meta signe chaque webhook avec l'app secret de l'app qui détient l'abonnement, et sur un numéro connecté via EasyCoexistence, c'est l'app EasyCoexistence, dont le secret n'est jamais partagé.

La pièce traite ce champ comme facultatif. Laissé vide, ses déclencheurs acceptent les envois tels quels. Rempli avec l'app secret d'une autre app, chaque envoi échoue au contrôle X-Hub-Signature-256 et est ignoré en silence, ce qui ressemble exactement à des messages qui n'arrivent jamais.

Le verify token est ce qui tient les inconnus à l'écart de la poignée de main. Choisissez une longue valeur aléatoire et gardez l'URL du déclencheur privée, puisque c'est l'adresse qui démarre votre flow.

Que peut faire un flow une fois le message arrivé ?

Le déclencheur transmet au flow un message aplati : expéditeur, nom de profil, ID du message, type, texte, éventuel ID de média, réponses de boutons et de listes, et l'ID du numéro de téléphone récepteur. À partir de là, c'est un flow Activepieces ordinaire, avec ses autres pièces, comme un CRM, une feuille de calcul ou une étape d'IA.

Les réponses passent par la même pièce. L'action « Envoyer un message » envoie du texte libre, et il n'est remis que dans les 24 heures suivant le dernier message du client. L'action « Envoyer un message de template » envoie un template approuvé, seul moyen de livrer au-delà de ce délai. Les boutons interactifs, listes, médias, localisations et réactions sont des actions à part.

Les instructions d'Activepieces rappellent que Meta n'accepte qu'une URL de rappel par app. Avec des destinations par numéro, la limite est d'une URL par numéro : un flow qui doit gérer plusieurs types d'événements doit donc se ramifier à l'intérieur d'un seul flow.

Les réponses saisies sur le téléphone atteignent-elles le flow ?

Elles atteignent le webhook, mais pas ce déclencheur. Sur un numéro Coexistence, Meta envoie un écho de chaque réponse saisie dans l'app WhatsApp Business à la même destination, sous le champ smb_message_echoes. Le déclencheur « Nouveau message entrant » de la pièce ne lit que le champ messages et ignore tout le reste.

Si vous avez besoin des réponses du téléphone dans le flow, démarrez-le avec la pièce Webhook générique d'Activepieces, qui accepte n'importe quelle méthode HTTP, et répondez au GET de vérification avec une étape de réponse sur son URL synchrone. Vous analysez ensuite vous-même le payload brut, avec les deux champs.

Pour la plupart des flows, le déclencheur de la pièce est le choix le plus simple : il réagit aux clients, et les réponses de l'équipe restent visibles dans l'app sur le téléphone.

Erreurs courantes

• Coller un app secret dans la connexion WhatsApp. Les envois sont signés avec le secret de l'app EasyCoexistence : tous sont donc ignorés.
• Définir la destination avant de publier le flow. Meta vérifie aussitôt, et un flow non publié ne peut pas répondre.
• Attendre du déclencheur « Nouveau message entrant » qu'il voie les réponses saisies sur le téléphone. Il ne lit que le champ messages, pas smb_message_echoes.

Questions fréquemment posées

Poursuivre la lecture