Guide de configuration Meta (Instagram & Messenger)

Connecter votre bot à Facebook Messenger et aux messages directs d'Instagram nécessite la configuration d'une application dans le portail Meta for Developers.

Ce processus comporte plusieurs étapes car Meta exige des autorisations explicites et des webhooks pour acheminer les messages de leurs plateformes vers votre instance FRENZY.BOT.

Prérequis

Avant de commencer, assurez-vous d'avoir : 1. Une Page Facebook pour votre entreprise. 2. Un Compte Professionnel Instagram (Business ou Créateur) lié à cette page Facebook. 3. Un accès à votre tableau de bord FRENZY.BOT pour obtenir votre URL de Webhook.

Étape 1 : Créer une application Meta

Allez sur le Portail Meta for Developers et connectez-vous.
Cliquez sur Mes apps en haut à droite, puis sur Créer une app.
Sélectionnez Autre comme type d'application et cliquez sur Suivant.
Sélectionnez Entreprise et cliquez sur Suivant.
Saisissez un Nom d'affichage de l'app (ex: "Mon Bot d'Entreprise") et votre e-mail de contact.
Sélectionnez votre compte Business (optionnel mais recommandé) et cliquez sur Créer une app.

Étape 2 : Ajouter des produits à votre application

Depuis le tableau de bord de votre application : 1. Faites défiler jusqu'à Ajouter des produits à votre application. 2. Trouvez Messenger et cliquez sur Configurer. 3. Dans la barre latérale gauche, cliquez sur Messenger → Paramètres Instagram (si vous voulez Instagram) ou restez sur Messenger → Paramètres (pour Facebook Messenger).

Étape 3 : Générer des jetons d'accès

Vous avez besoin d'un Jeton d'Accès de Page pour permettre à FRENZY.BOT d'envoyer des messages en votre nom.

Sous Messenger → Paramètres, trouvez la section Jetons d'accès.
Cliquez sur Ajouter ou supprimer des pages et authentifiez-vous avec votre compte Facebook.
Sélectionnez la ou les pages Facebook que vous souhaitez connecter et accordez les autorisations demandées.
Une fois la page liée, cliquez sur Générer un jeton à côté de celle-ci.
Copiez ce jeton immédiatement et sauvegardez-le. Vous devrez le coller dans le tableau de bord FRENZY.BOT.

Étape 4 : Configurer le Webhook

Cela indique à Meta où envoyer les messages entrants.

Dans votre tableau de bord FRENZY.BOT, allez dans Channels → Messenger (ou Instagram).
Recherchez votre Webhook URL unique et votre Verify Token sur cette page.
De retour dans le portail Meta for Developers, faites défiler jusqu'à la section Webhooks (sous les paramètres Messenger).
Cliquez sur Ajouter une URL de rappel.
Collez l'Webhook URL et le Verify Token provenant de votre tableau de bord FRENZY.BOT.
Cliquez sur Vérifier et enregistrer.

Étape 5 : S'abonner aux événements

Vous devez indiquer à Meta quels événements envoyer à votre webhook.

Dans la section Webhooks, cliquez sur Gérer à côté du nom de votre page.
Abonnez-vous aux champs suivants :
messages (Requis pour les messages texte)
messaging_postbacks (Requis pour les clics sur boutons/réponses rapides)
messaging_optins (Optionnel, pour les boutons "Démarrer")
Cliquez sur Enregistrer.

Étape 6 : Trouver vos identifiants

Si vous configurez Instagram, vous avez besoin d'identifiants spécifiques :

ID de compte Instagram :
Allez dans Paramètres de la page Facebook → Comptes liés → Instagram.
Ou utilisez l'Explorateur d'API Graph : GET /v18.0/me?fields=instagram_business_account
Recipient IGID :
Il s'agit de l'ID spécifique à Instagram de la personne qui doit recevoir les alertes (si vous utilisez Instagram comme Intégration). Pour la configuration du canal (Channel), cela n'est généralement pas requis sauf indication contraire dans le tableau de bord.

Étape 7 : Finaliser dans FRENZY.BOT

Retournez dans votre tableau de bord FRENZY.BOT (Channels → Messenger ou Instagram).
Collez le Page Access Token que vous avez généré à l'étape 3.
Collez tous les identifiants requis (comme l'ID de compte Instagram).
Basculez sur Enable pour activer le canal.
Cliquez sur Save Settings.

⚠️ Crucial : Examen de l'application (Mise en ligne)

Lorsque vous créez une application Meta pour la première fois, elle est en Mode Développement.

En Mode Développement, votre bot ne répondra qu'à vous et aux autres développeurs/testeurs ajoutés à l'application dans le portail Meta (sous Rôles de l'app).

Pour que votre bot réponde au grand public, vous devez : 1. Effectuer la Vérification de l'entreprise dans le portail Meta for Developers. 2. Demander un Accès Avancé pour des autorisations spécifiques (généralement pages_messaging et instagram_manage_messages). 3. Soumettre une vidéo de démonstration (screencast) montrant le fonctionnement de votre bot. 4. Une fois approuvé, basculez le bouton en haut de l'écran de Développement à En direct.

Note : Le processus d'examen de Meta peut prendre plusieurs jours.