Envoyer les prospects Facebook et Instagram vers une boîte de réception WhatsApp

Connectez une Page Facebook qui diffuse des publicités Lead Ads à une boîte de réception WhatsApp dans Deskwoot. Chaque formulaire rempli sur Facebook ou Instagram arrive comme une nouvelle conversation dans votre tableau de bord, avec toutes les données du formulaire jointes. Un modèle WhatsApp déjà approuvé part dès que Meta envoie le webhook, ce qui ouvre tout de suite la fenêtre de 24 heures pour répondre au client.

Ce qu'il vous faut avant de connecter

• Une Page Facebook à laquelle appartiennent les publicités Lead Ads.
• Une app Meta avec le webhook Lead Ads abonné au niveau de l'app.
• Un jeton d'accès de la Page avec ces autorisations : pages_show_list, pages_read_engagement, pages_manage_metadata, leads_retrieval. Prenez un jeton longue durée (60 jours) pour ne pas avoir à le renouveler chaque semaine.
• La clé secrète de l'app Meta (Paramètres, Général, Clé secrète dans votre app Meta).
• Une boîte de réception WhatsApp Cloud API déjà configurée dans Deskwoot.
• Au moins un modèle de message WhatsApp approuvé dans Meta Business Manager. Les modèles peuvent contenir des variables (les espaces réservés {{1}}, {{2}}, ...), et nos paramètres vous permettent de relier ces variables au prénom du prospect, au nom de votre compte, à un texte fixe ou à n'importe quel champ du formulaire.

Connecter la Page

1. Dans Deskwoot, allez dans Paramètres, Intégrations, Meta Lead Ads.
2. Collez l'ID de la Page, le jeton d'accès longue durée de la Page et la clé secrète de l'app.
3. Choisissez la boîte de réception WhatsApp Cloud API où les conversations doivent arriver.
4. Saisissez le nom de votre modèle de bienvenue approuvé et le code de langue (par exemple lead_welcome + en_US).
5. Cliquez sur Connecter la Page.

Nous testons votre jeton d'accès de la Page auprès de la Graph API pour confirmer que la Page existe. Ensuite, nous appelons POST /<page_id>/subscribed_apps?subscribed_fields=leadgen côté Meta pour que la Page commence vraiment à envoyer les webhooks leadgen. Sans cette activation Page par Page, l'abonnement au niveau de l'app ne transmet rien. Nous nous en chargeons pour vous.

Configurer le webhook dans votre app Meta

Une fois la Page connectée, cliquez sur Configurer sur la carte de la Page. Deux valeurs s'affichent :

• URL de rappel, par exemple https://deskwoot.com/api/webhooks/meta-leadgen/<your-slug>
• Jeton de vérification, un texte aléatoire propre à chaque Page

Collez les deux dans le tableau de bord de votre app Meta, sous Webhooks, Page, Modifier l'abonnement. Chaque Page connectée a son propre slug et son propre jeton de vérification : si les données d'une Page fuitent, elles ne permettent jamais d'autoriser un webhook pour une autre Page.

Découvrir les champs du formulaire

Cliquez sur Découvrir les champs dans le panneau de configuration. Nous appelons Graph /<page_id>/leadgen_forms?fields=questions et récupérons la clé de chaque question de tous les formulaires actifs de cette Page. Ces clés deviennent les choix des listes déroulantes pour la correspondance des champs et les variables de modèle, plus bas.

Correspondance des champs

Indiquez-nous quelle question du formulaire Meta correspond à quel champ de contact Deskwoot. Les réglages par défaut sont judicieux :

• email, EMAIL ou le nom que votre formulaire lui donne, correspond à E-mail. L'e-mail sert à identifier le contact (nous cherchons ou créons d'abord le contact par e-mail, puis par téléphone à défaut).
• full_name correspond à Nom complet
• phone_number correspond à Téléphone, réduit aux seuls chiffres avant d'être enregistré comme ID WhatsApp.

Vous pouvez ajouter vos propres correspondances pour Entreprise ou Poste si votre formulaire contient ces questions.

Variables de modèle

Les modèles WhatsApp utilisent des espaces réservés {{1}}, {{2}}, ... dans le corps du message. Le sélecteur de variables vous permet de remplir chacun avec :

• Prénom du prospect, tiré de la correspondance full_name
• Nom du compte, le nom affiché de votre compte Deskwoot
• Texte fixe, un texte tel quel
• Champ du formulaire, n'importe quelle clé de champ découverte plus haut

Ajoutez autant de lignes de variables que votre modèle en attend, dans l'ordre. Pour un modèle sans variables, vous pouvez ne mettre aucune ligne.

Ce qui se passe quand un prospect remplit le formulaire

1. Meta envoie un webhook leadgen à l'URL de votre slug avec la signature HMAC x-hub-signature-256.
2. Nous vérifions la signature avec la clé secrète de votre app et ignorons le prospect sans rien signaler si elle ne correspond pas.
3. Nous réservons le prospect dans une ligne MetaLeadAdLead avec UNIQUE(accountId, leadgenId). Les envois de webhook en double (Meta réessaie jusqu'à 7 fois sur 5 jours) sont écartés à cette étape, donc aucune conversation en double n'est jamais créée.
4. Nous récupérons le prospect complet via Graph GET /<leadgen_id>.
5. Nous cherchons ou créons le contact, en reliant les champs du formulaire selon vos réglages.
6. Nous ouvrons une nouvelle conversation dans votre boîte de réception WhatsApp, avec toutes les données du formulaire dans customAttributes.metaLeadAd.
7. Nous envoyons le modèle de bienvenue via WhatsApp Cloud API. Le message arrive sur le téléphone du prospect, ouvre la fenêtre de 24 heures pour répondre, et votre agent (ou Fynn s'il est responsable) prend le relais.

Déconnecter

Cliquez sur Déconnecter sur la carte de la Page. Nous appelons Meta DELETE /<page_id>/subscribed_apps pour arrêter l'envoi des webhooks, puis nous supprimons la ligne locale. Même si Meta renvoie une erreur (jeton expiré, Page supprimée), nous supprimons quand même la ligne locale, pour que vous ne restiez jamais bloqué avec une configuration impossible à retirer.

Questions fréquentes