Cas d’utilisation Threads

Ce document explique comment créer et personnaliser une application Meta avec le cas d’utilisation API Threads dans l’Espace App.

Ce guide part du principe que vous avez lu et implémenté les exigences de création d’une application avec Meta.

Étape 1 : lancer le processus de création de l’application

Vous pouvez créer une application de plusieurs manières.

  • Si vous venez de terminer le processus d’inscription, cliquez sur le bouton Créer une première application
  • Si vous vous trouvez dans l’Espace App , cliquez sur Créer une application en haut à droite
  • Si vous vous trouvez dans le tableau de bord d’une application existante et que vous voulez créer une nouvelle application, sélectionnez le menu déroulant en haut à gauche, puis cliquez sur le bouton Créer une nouvelle application

Étape 2 : connecter une entreprise (facultatif)

Si vous créez une application pour une entreprise que vous possédez ou gérez, vous n’avez pas l’obligation de connecter une entreprise à votre application.

Si vous êtes un fournisseur de technologies, vous créez une application destinée à des client·es ou à d’autres portefeuilles business. Vous devez la connecter à une entreprise ayant terminé la vérification de l’accès et de l’entreprise avant de pouvoir la publier (étape 11).

Vous pouvez connecter l’entreprise maintenant, mais aussi à tout moment du processus de développement.

  1. Sélectionnez une option et cliquez sur Suivant.

En savoir plus sur la vérification de l’accès et de l’entreprise.

Étape 3 : sélectionner le cas d’utilisation

  1. Sélectionnez le cas d’utilisation Accéder à l’API Threads pour utiliser l’API Threads.
  2. Cliquez sur Suivant.

Étape 4 : ajouter les informations relatives à l’application

  1. Ajoutez un nom d’application. Il apparaîtra dans le tableau de bord de l’application.
  2. Ajoutez un e-mail de contact. Meta l’utilisera pour vous contacter au sujet de votre application.
  3. Cliquez sur Suivant.

Remarque : si vous avez connecté votre application à une entreprise ayant terminé la vérification de l’accès et de l’entreprise à l’étape 2, une question supplémentaire apparaît :

  • Sélectionnez Oui si votre application est destinée à des client·es ou à d’autres portefeuilles business ou Non si vous la créez pour une entreprise que vous possédez ou gérez. Cliquez sur Suivant.

Étape 5 : examiner les détails

Au cours de cette étape, vous examinerez :

  • Le cas d’utilisation principal que vous avez sélectionné pour l’application
  • Les conditions de publication requises pour l’application, le cas échéant
  • Les Conditions générales de la plateforme Meta et les Politiques développeur

Cliquez sur Créer une application.

Une fois l’application créée, vous serez redirigé·e vers le tableau de bord correspondant pour la personnaliser davantage.

Personnalisation de l’application et conditions

Vous pouvez à tout moment mettre à jour les paramètres de l’application dans le tableau de bord correspondant en cliquant sur Tableau de bord dans le menu de gauche.

Étape 6 : ajouter et personnaliser des cas d’utilisation

  1. Cliquez sur Personnaliser l’accès à l’API Threads. Vous verrez la liste des autorisations que vous pouvez ajouter pour que votre application fonctionne comme vous le souhaitez. L’autorisation threads_basic est déjà sélectionnée car elle est requise pour l’API Threads.
    Autorisations
    • threads_content_publish
    • threads_manage_insights
    • threads_manage_replies
    • threads_read_replies
  2. Cliquez sur + Demande pour chaque autorisation à ajouter.
    Une fois qu’une autorisation est ajoutée à l’application, vous pouvez en voir le statut :
    • Prête pour le mode Live : l’autorisation a été approuvée par un Contrôle app et vous pouvez publier votre application
    • Prête pour le test : vous pouvez tester des appels d’API vers les points de terminaison qui nécessitent cette autorisation et effectuer les tests d’autorisation exigés pour le Contrôle app
    • Vérification requise : cette autorisation nécessite l’ajout d’un compte business Meta vérifié à l’application
    Vous pouvez également connaître le nombre d’appels d’API qui ont été effectués sur des points de terminaison requérant les différentes autorisations et qui ont abouti.
  3. (Facultatif) Cliquez sur Prête pour le test pour en savoir plus sur les conditions de test des appels d’API vers les points de terminaison qui nécessitent l’autorisation considérée.

Vous pouvez ajouter et supprimer des autorisations à tout moment du processus de développement.

Étape 7 : ajouter des paramètres

  1. Dans le menu de gauche, cliquez sur Paramètres.
  2. Ajoutez les URL suivantes :
    • Paramètres OAuth client : URI de redirection OAuth valides
    • URL de rappel pour les annulations d’autorisation : URL que Meta exécutera si un·e utilisateur·ice annule l’autorisation de votre application
    • URL de la demande de suppression des données : URL que Meta exécutera si un·e utilisateur·ice demande la suppression de ses données
  3. Cliquez sur Enregistrer.

Étape 8 : tokens utilisateur·ice pour le test

Vous pouvez obtenir des tokens d’accès de longue durée pour vos utilisateur·ices test et suivre le lien pour ajouter ou supprimer des utilisateur·ices test Threads.

Étape 9 : ajouter des cas d’utilisation

Vous pouvez ajouter d’autres cas d’utilisation aux applications de cas d’utilisation API Threads.

  1. Cliquez sur Gérer les cas d’utilisation en haut à droite.
  2. Cliquez sur + Ajouter à droite de chaque cas d’utilisation pour ajouter des webhooks ou un suivi d’évènements d’application.
  3. Lorsque vous ajoutez un cas d’utilisation, il apparaît dans le menu de gauche. Cliquez sur les paramètres sous chaque cas d’utilisation pour le configurer.
  4. Lorsque vous avez terminé, cliquez sur Tableau de bord en haut du menu de gauche.

Si vous êtes un fournisseur de technologies, votre application est destinée à des client·es ou à d’autres portefeuilles business. Poursuivez avec la section **Pour les fournisseurs de technologie**.

Étape 10 : tester les cas d’utilisation (facultatif)

Cliquez sur Testez les cas d’utilisation pour tester la configuration.

Étape 11 : terminer la personnalisation

Cliquez sur Finish customization (Terminer la personnalisation) pour indiquer la fin de la création de l’application. Il est encore possible de revenir en arrière et d’ajouter des cas d’utilisation à l’application.

Cliquez sur Oui, j’ai terminé. Vous serez redirigé·e vers le tableau de bord qui affichera l’état de l’application et les appels d’API quotidiens.

Félicitations, vous avez terminé votre application !

Si vous souhaitez devenir fournisseur de technologies, cliquez sur Devenir un fournisseur de technologies.

Pour les fournisseurs de technologies

Les étapes suivantes sont à réaliser par les fournisseurs de technologies. Votre application est destinée à des client·es ou à d’autres portefeuilles business.

Étape 10 : Contrôle app

  1. Cliquez sur le chevron en regard de chaque condition figurant sous Préparez et envoyez votre application au Contrôle app. Vous devez satisfaire chaque condition avant de pouvoir publier votre application.

Un cercle coché apparaît une fois que chaque condition est remplie.

En savoir plus sur le processus Contrôle app.

Étape 11 : publier l’application

  1. Cliquez sur le chevron à droite de Vérifiez que toutes les conditions requises sont remplies, puis publiez votre application. Si des conditions n’ont pas encore été remplies, un message apparaît pour que vous y remédiez.
  2. Une fois toutes les conditions remplies, cliquez sur Publier en bas à droite.

Une fois l’application publiée, le tableau de bord affichera l’état de l’application et les appels d’API quotidiens.