Connexion

Brancher ta Page Facebook et ton compte Instagram sur Trackily. Tu crées ta propre application Meta (Trackily n'a pas d'app centrale), tu colles son identifiant et sa clé secrète dans Trackily, puis un jeton de Page. Compte une demi-heure la première fois. Tout se passe dans Messages Instagram & Messenger → Comptes ; l'écran a le même guide, repliable : « Créer ton app Meta, pas à pas ».

Ce qu'il te faut

• Une Page Facebook sur laquelle tu as un rôle complet.
• Pour Instagram : un compte Instagram professionnel lié à cette Page. Sans lui, la Page ne répond que sur Messenger.
• Un compte développeur sur developers.facebook.com et, de préférence, un portefeuille d'entreprise (Meta Business).
• L'URL publique de Trackily réglée en https (Settings (Paramètres) → General → Advanced Configuration → Public URL). Sans elle, la carte de ton application affiche « URL publique non réglée » et tu ne peux pas copier l'adresse du webhook.

Les menus de Meta changent souvent de nom et de place. Les étapes ci-dessous disent quoi chercher ; si un libellé a bougé, cherche le mot-clé (Webhooks, Clé secrète, Live).

1. Créer l'application chez Meta

1. Sur developers.facebook.com, crée une application de type Business, rattachée à ton portefeuille d'entreprise.
2. Ajoute les produits Messenger et Instagram (choisis « Instagram API with Facebook Login », pas « Instagram Login »).
3. Lie ton compte Instagram professionnel à ta Page Facebook, si ce n'est pas déjà fait.
4. Dans Paramètres → Général, recopie l'identifiant de l'app (App ID, un nombre) et sa clé secrète (App Secret).

2. Créer l'application dans Trackily

Comptes → Nouvelle application, choisis « Mon application Meta », puis :

Clique « Créer l'application ». La carte de l'application montre :

• l'URL du webhook (l'URL de rappel à donner à Meta), avec un bouton « Copier » ;
• le jeton de vérification (verify token). Il s'affiche en clair une seule fois, juste après la création ; ensuite, « Copier le jeton de vérification » le recopie sans l'afficher ;
• les champs à cocher chez Meta, objet par objet.

La clé secrète vérifie la signature de chaque notification de Meta. Elle est chiffrée et n'est plus jamais montrée : tu peux la remplacer, pas la relire.

3. Passer l'app en mode Live

Dans le tableau de bord de l'app, publie-la (mode Live). En mode développement, Meta n'envoie aucune notification : rien ne marcherait. Meta demande pour cela une URL de politique de confidentialité et quelques informations sur l'app.

4. Générer un jeton de Page sans expiration

Trackily a besoin d'un jeton de Page qui n'expire pas. Accorde-lui ces permissions :

pages_messaging, pages_manage_metadata, pages_read_engagement, pages_show_list, pages_manage_engagement, instagram_basic, instagram_manage_messages, instagram_manage_comments, business_management.

Sur la Page, la personne qui génère le jeton doit pouvoir gérer les messages et la modération (tâches MESSAGING et MODERATE).

Deux façons de l'obtenir :

Par un jeton d'utilisateur longue durée (le plus simple)

1. Dans l'Explorateur de l'API Graph (Graph API Explorer), choisis ton app, demande un jeton d'utilisateur avec les permissions ci-dessus, et accepte la fenêtre de Meta en cochant ta Page et ton compte Instagram.
2. Ce jeton ne vit qu'une heure environ : prolonge-le en jeton longue durée (environ 60 jours), par exemple avec « Prolonger le jeton d'accès » (Extend Access Token) dans le Débogueur de jeton d'accès.
3. Les jetons de Page tirés de ce jeton longue durée par /me/accounts n'expirent pas. Tu n'as même pas besoin de faire cet appel : colle directement le jeton d'utilisateur longue durée dans Trackily, qui te propose tes Pages et en tire le jeton de la Page choisie (voir l'étape suivante).

Évite de coller le jeton d'une heure : la Page qu'on en tire expirerait avec lui.

Par un utilisateur système (pour une agence, ou si tu ne veux pas dépendre de ton profil)

1. Dans les paramètres de ton entreprise Meta, crée un utilisateur système, donne-lui ta Page et ton app.
2. Génère son jeton en choisissant ton app, l'expiration « Jamais » et les permissions ci-dessus.
3. Colle ce jeton dans Trackily : comme pour un jeton d'utilisateur, Trackily te propose les Pages et garde le jeton de celle que tu choisis.

5. Brancher la Page dans Trackily

Comptes → Ajouter une Page, choisis l'application, colle le jeton dans « Jeton de la Page », puis « Brancher la Page ».

• Tu as collé un jeton de Page : la Page est branchée.
• Tu as collé un jeton d'utilisateur : Trackily affiche « Choisis la Page à brancher ». Clique « Brancher cette Page » sur la bonne. Seul le jeton de cette Page est gardé, chiffré ; le tien n'est pas conservé.

Trackily vérifie le jeton chez Meta et remplit la carte de la Page :

Refus courants à cette étape : un jeton expiré ou mal copié (« Meta dit que ce jeton n'est pas valide »), un jeton d'une autre app que celle choisie, un jeton qui ne donne accès à aucune Page (vérifie ton rôle sur la Page et pages_show_list), ou une Page déjà branchée.

6. Donner le webhook à Meta

Dans le tableau de bord de l'app Meta, ouvre la configuration des Webhooks (dans Messenger, puis dans Instagram, ou dans le produit Webhooks selon la version de l'écran) :

1. Colle l'URL du webhook comme URL de rappel et le jeton de vérification (boutons « Copier » de la carte de ton application). Clique « Vérifier et enregistrer » : Meta appelle Trackily, qui répond si le jeton est le bon.
2. Coche les champs objet par objet, exactement ceux de la carte :

Une application n'a qu'une URL de webhook : la même sert à toutes ses Pages et aux deux objets.

7. Abonner la Page

Sur la carte de la Page, clique « Abonner ». Trackily demande à Meta d'envoyer les notifications de cette Page à ton app. Sans abonnement, la carte dit « La Page n'est pas abonnée » et rien n'arrive.

8. Le test indispensable : depuis le compte d'un ami

Les personnes qui ont un rôle sur ton app (toi, un développeur, un testeur) sont toujours servies par Meta. Ça ne prouve donc pas que le public le sera. Teste avec le compte d'un ami qui n'a aucun rôle sur l'app :

1. il t'écrit un message privé sur Instagram, puis sur Messenger ;
2. il commente une de tes publications ;
3. il répond à une de tes stories.

Puis regarde Dernières notifications reçues sur la carte de la Page : chaque geste doit y laisser une date, par canal et par type. Tant que rien n'est arrivé, la carte dit « Aucune notification reçue pour l'instant ».

Si les commentaires ou les messages du public n'arrivent pas

La documentation de Meta se contredit sur ce que permet l'accès standard. Si tes propres tests marchent mais pas ceux de ton ami, c'est que ton app a besoin de l'accès avancé :

1. fais la vérification d'entreprise de ton portefeuille Meta ;
2. demande l'accès avancé pour ton app (revue de Meta, avec une vidéo qui montre l'usage), au moins pour instagram_manage_comments, instagram_manage_messages et pages_messaging.

Rien ne change dans Trackily : dès que Meta accorde l'accès, les notifications arrivent.

Autres causes fréquentes :

• L'app n'est pas en Live : aucune notification du tout.
• Un champ n'est pas coché chez Meta pour l'objet concerné (par exemple comments sur l'objet Instagram).
• Le compte Instagram est privé : Meta n'envoie aucune notification de commentaire pour un compte privé.
• L'accès aux messages n'est pas autorisé côté Instagram : dans les réglages de messages de l'app Instagram, autorise l'accès aux messages pour les outils connectés.
• Les notifications se sont arrêtées après avoir marché : la carte dit « Meta a peut-être désabonné l'app ». Meta désabonne une app qui ne répond plus pendant une heure. Clique « Abonner » à nouveau et vérifie que l'app est toujours en Live.

Entretenir une Page branchée

• Vérifier relit chez Meta le jeton, les permissions et l'abonnement, et remet à jour la carte. À faire après avoir changé quoi que ce soit chez Meta.
• Désactiver met les envois en pause. La réception continue : un STOP reçu pendant ce temps est toujours appliqué. « Activer » relance les envois.
• Supprimer la Page annule ses envois en attente et arrête ses conversations en cours. Ses contacts, leurs désabonnements et le journal sont gardés : si tu rebranches plus tard la même Page, tu les retrouves (il faudra recliquer « Abonner »).
• Jeton à renouveler, ou jeton refusé (« En erreur ») : les envois attendent, ils ne sont pas perdus. L'écran n'a pas encore de bouton pour remplacer le jeton d'une Page branchée : un développeur peut le faire par l'API admin (PUT /admin/api/dm/comptes/<id> avec { "jeton": "…" }, le jeton de la même Page), sinon supprime la Page et rebranche-la avec le nouveau jeton.
• Une application ne se supprime que lorsqu'elle n'a plus de Page.

Le bac à sable : essayer sans Meta

Pour découvrir le module, écrire tes premières automatisations ou faire une démonstration sans rien brancher :

1. Comptes → Nouvelle application, choisis « Bac à sable », donne un nom, « Créer l'application ».
2. Ajouter une Page, choisis l'application de bac à sable : aucun jeton à coller. Trackily invente une Page et un compte Instagram de démonstration.

Dans le bac à sable :

• aucun appel à Meta, aucun message réel : les envois sont capturés, jamais envoyés ;
• tout ce que la Page peut faire est prêt, et elle est abonnée d'office ;
• les publications récentes sont trois publications fictives, pour essayer le déclencheur sur commentaire ;
• une capture n'inscrit jamais personne : ni liste e-mail, ni liste WhatsApp, ni étiquette. La valeur est gardée sur le contact de démonstration et le journal dit « capture simulée (bac à sable) » ;
• ses contacts ne touchent ni aux vraies listes de suppression ni aux vrais pixels.

Un développeur peut aussi poster des notifications de test sur l'URL du webhook du bac à sable : elle accepte les notifications non signées.