API de marketing

Pruebas y solución de problemas

Usa esta API para crear y eliminar clientes potenciales de prueba.

Usar la herramienta de prueba

Puedes usar esta herramienta para crear y eliminar clientes potenciales de prueba para los formularios; no obstante, no puedes utilizarla en el modo de desarrollador.

Puedes crear un cliente potencial de prueba por formulario. Deberás eliminar un cliente potencial existente para poder crear uno nuevo.

Depurar la integración de actualizaciones en tiempo real

Usa esta herramienta para probar si tu integración con los webhooks de Facebook es correcta. A continuación se indican los pasos para usar esta herramienta con el objetivo de depurar la integración.

Los clientes potenciales creados con esta herramienta son clientes potenciales orgánicos que no están asociados a ningún anuncio. Solo se puede crear un cliente potencial por formulario. Por lo tanto, si quieres volver a crear un cliente potencial para el mismo formulario, haz clic en Eliminar cliente potencial para eliminar primero el cliente potencial y, a continuación, vuelve a crearlo.

  1. Accede a la herramienta de prueba.

    2. En el menú desplegable se indican todas las páginas a las que tienes acceso de anunciante.

  2. Selecciona una página del menú desplegable.

  3. En el menú desplegable Formulario, selecciona un formulario para usarlo a fin de crear un cliente potencial.

  4. Haz clic en Crear cliente potencial para crear un cliente potencial. De forma predeterminada, el cliente potencial que se crea contiene datos ficticios.

  5. Haz clic en Vista previa del formulario para personalizar los datos que se envían.

  6. Introduce los datos que te interesan en el nivel del formulario para crear un cliente potencial con contenido personalizado.

  7. Una vez creado el cliente potencial, aparece el botón Realizar seguimiento del estado.

  8. Haz clic en Realizar seguimiento del estado para ver el estado de los clientes potenciales. La actualización en tiempo real (RTU) tarda unos segundos en activarse en el extremo. Hasta entonces, la RTU aparece en estado pendiente. Vuelve a hacer clic en Realizar seguimiento del estado hasta que veas que el estado cambia.

Cuando el cliente potencial se envía al extremo, el campo de estado cambia. Si la actualización en tiempo real se ha activado correctamente, el estado cambia a correcto.

En los casos en que el estado sea correcto, también verás la carga útil en la tabla. La carga útil que se muestra aquí es una copia de lo que Facebook envía a tu extremo, de modo que deberías poder ver el contenido y gestionar el objeto JSON. Si se ha producido algún problema durante el envío de la actualización en tiempo real, el estado cambia a error. En estos casos, en la columna “error_code” se proporcionarán detalles sobre el motivo del error.

Pruebas de clientes potenciales

Puedes probar tus clientes potenciales a través del botón “Probar” después de configurar los webhooks para tu aplicación. El botón se encuentra en el panel de webhooks de la aplicación.

Crear clientes potenciales de prueba

Para crear un cliente potencial de prueba, puedes realizar una solicitud POST a /{FORM_ID}/test_leads.

Para que esta solicitud se realice correctamente, deben cumplirse los requisitos siguientes:

  • No deberías tener clientes potenciales de prueba existentes para el formulario de anuncios para clientes potenciales indicado.
  • Debes tener el rol de páginaAdvertiser o uno superior en la página en la que se ha creado el formulario.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Para personalizar el contenido de los clientes potenciales de prueba, pasa los parámetros siguientes:

  • field_data: parámetro de vector con pares de name y values.
  • custom_disclaimer_responses: parámetro de vector con pares de checkbox_key y 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"

Los clientes potenciales creados a partir de las llamadas anteriores son clientes potenciales falsos y, por tanto, no están asociados a ningún anuncio.

Leer clientes potenciales de prueba

Para leer los clientes potenciales de prueba asociados a un formulario de anuncios para clientes potenciales, realiza una llamada GET al extremo {FORM_ID}/test_leads.

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

Eliminar clientes potenciales de prueba

Si pruebas la integración y quieres eliminar un cliente potencial para poder volver a enviarlo, realiza la siguiente llamada a la API:

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

El único usuario que puede eliminar el cliente potencial es su propietario.