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 borrar clientes potenciales de prueba en tus formularios. Sin embargo, no puedes usar la herramienta en modo de desarrollo.

Puedes crear un cliente potencial de prueba por formulario. Si ya existe un cliente potencial, es necesario eliminarlo para que puedas crear uno nuevo.

Depurar la integración por actualización en tiempo real

Utiliza esta herramienta para probar si la integración con los webhooks de Facebook es correcta. A continuación, se especifican los pasos que se deben seguir para usar esta herramienta a fin de depurar la integración.

Los clientes potenciales creados con esta herramienta son clientes potenciales orgánicos que no están asociados con ningún anuncio. Solo es posible 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. De esta manera, puedes borrar el cliente preexistente y, luego, volver a crearlo.

  1. Ve a la herramienta de prueba.

    2. La lista desplegable muestra todas las páginas a las que tienes acceso de anunciante.

  2. Selecciona una página de la lista desplegable.

  3. En la lista desplegable Formulario, selecciona un formulario que usarás para crear un cliente potencial.

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

  5. Para personalizar los datos que se envían, haz clic en Vista previa del formulario.

  6. Escribe los datos deseados en el nivel del formulario para crear un cliente potencial con contenido personalizado.

  7. Después de que crees el cliente potencial, aparecerá el botón Hacer seguimiento del estado.

  8. Haz clic en Hacer seguimiento del estado para ver el estado del cliente potencial. La activación del RTU al punto de conexión demora unos segundos. Hasta entonces, el RTU se muestra con estado pendiente. Haz clic en Hacer seguimiento del estado nuevamente hasta ver el cambio de estado.

Una vez que el cliente potencial se publique en tu punto de conexión, cambiará el campo del estado. Si el RTU se activó correctamente, el estado cambiará a éxito.

Para los casos de éxito, también verás la carga en la tabla. La carga que se muestra aquí es una copia de lo que Facebook envía a tu punto de conexión, por lo que debes ver el contenido y controlar el JSON. Si ocurre un problema durante el envío del RTU, el estado cambiará a error. En dichos casos, la columna "error_code" mostrará detalles sobre el motivo del error.

Prueba de clientes potenciales

Puedes probar tus clientes potenciales mediante el botón de prueba después de configurar Webhooks para tu app. El botón está dentro del panel de Webhooks para la app.

Crear clientes potenciales de prueba

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

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

  • El formulario del anuncio para clientes potenciales especificado no contener clientes potenciales de prueba.
  • Debes tener un rol de página de Advertiser o superior en la página en la que se creó el formulario.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Para personalizar el contenido del cliente potencial de prueba, pasa los parámetros siguientes:

  • field_data: un parámetro vector con pares name y values.
  • custom_disclaimer_responses: un parámetro vector con pares 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 lo tanto, no están asociados con ningún anuncio.

Leer clientes potenciales de prueba

Puedes leer los clientes potenciales de prueba asociados a un formulario de anuncios para clientes potenciales realizando una llamada GET al punto de conexión {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 estás probando la integración y deseas eliminar un cliente potencial para poder volver a realizar un envío, haz la siguiente llamada a la API:

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

Solo el propietario del cliente potencial puede eliminarlo.