Test et dépannage

Utilisez cette API pour créer et supprimer des prospects test.

Utiliser l’outil de test

Vous pouvez utiliser cet outil pour créer et supprimer des prospects test pour vos formulaires. Cependant, vous ne pouvez pas utiliser l’outil dans le mode développeur.

Vous ne pouvez créer qu’un seul prospect test par formulaire. Vous devrez supprimer un prospect existant pour pouvoir en créer un nouveau.

Débuguer une intégration de mise à jour en temps réel

Utilisez cet outil pour voir si votre intégration avec les Webhooks Facebook est réussie. Pour débuguer votre intégration, procédez comme suit :

Les prospects créés à l’aide de cet outil sont des prospects organiques qui ne sont associés à aucune publicité. Un seul prospect peut être créé par formulaire. En conséquence, pour recréer un prospect pour un même formulaire, cliquez d’abord sur Supprimer le prospect pour le recréer ensuite.

Accédez à l’outil de test.

Sélectionnez une page dans la liste.

Dans le menu déroulant Formulaire, sélectionnez un formulaire à utiliser pour créer un prospect.

Cliquez sur Créer un prospect pour créer un prospect. Par défaut, le prospect créé est associé à des données fictives.

Pour personnaliser les données envoyées, cliquez sur Aperçu du formulaire.

Saisissez les données désirées au niveau du formulaire pour créer un prospect avec un contenu personnalisé.

Une fois le prospect créé, le bouton Suivre le statut s’affiche.

Cliquez sur Suivre le statut pour voir le statut des prospects. La mise à jour en temps réel se déclenche au niveau de votre point de terminaison en quelques secondes. Avant cela, le statut de la mise à jour en temps réel est défini sur en attente. Cliquez à nouveau sur Suivre le statut jusqu’à ce que ce dernier change.

Une fois le prospect transmis à votre point de terminaison, le champ de statut est mis à jour. Si la mise à jour en temps réel a bien été déclenchée, le statut passe à réussite.

Dans ce cas, les données utiles s’affichent également dans le tableau. Les données utiles présentées ici sont celles que Facebook envoie à votre point de terminaison. Vous devriez donc voir le contenu JSON et pouvoir le gérer. Si une erreur est survenue au cours de l’envoi de la mise à jour en temps réel, le statut renvoyé est échec. Dans ce cas, la colonne error_code affiche la cause détaillée de l’échec.

Test des prospects

Vous pouvez tester vos prospects via le bouton Tester après avoir configuré les Webhooks pour votre application. Ce bouton se trouve à l’intérieur du tableau de bord Webhooks de l’application.

Créer des prospects test

Vous pouvez créer un prospect test en envoyant une requête POST à /{FORM_ID}/test_leads.

Pour que cette requête aboutisse, les conditions suivantes doivent être remplies :

Aucun prospect test ne doit exister pour le formulaire de publicité à formulaire spécifié.
Vous devez avoir un rôle d’Advertiser ou supérieur sur la Page dans laquelle a été créé le formulaire.

curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Vous pouvez personnaliser le contenu du prospect test en transmettant les paramètres suivants :

field_data : paramètre vectoriel avec les paires name et values.
custom_disclaimer_responses : paramètre vectoriel avec les paires checkbox_key et is_checked.

curl \
  -F "field_data=[{'name': 'favorite_color?', 'values': ['yellow']}, {'name': 'email', 'values': ['test@test.com']}]" \
  -F "custom_disclaimer_responses=[{'checkbox_key': 'my_checkbox', 'is_checked': true}]" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Les prospects créés à partir des appels ci-dessus sont fictifs et ne sont donc associés à aucune publicité.

Lire les prospects test

Vous pouvez lire les prospects test associés à un formulaire de publicités à formulaire en transmettant un appel GET au point de terminaison {FORM_ID}/test_leads.

curl \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Supprimer des prospects test

Si vous testez votre intégration, pour supprimer un prospect en vue d’un nouvel envoi, exécutez l’appel d’API suivant :

curl -X DELETE \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<LEAD_ID>"

Seul le propriétaire du prospect peut le supprimer.