No llegan leads de TikTok al webhook: qué revisar

Conectaste un formulario instantáneo de TikTok Ads Manager a tu sistema mediante un webhook, pero faltan leads en el destino. Antes de rehacer la integración, separa los contactos anteriores a la conexión de los nuevos y comprueba que el formulario esté suscrito. Son las dos primeras verificaciones que documenta TikTok para webhooks que no reciben leads.

Este recorrido es para quien mantiene una integración webhook ya configurada con un Instant Form de Ads Manager. No describe la captación orgánica de una cuenta empresarial ni el diagnóstico completo de HubSpot, LeadsBridge u otros conectores.

Confirma el formulario y su suscripción

Identifica la cuenta publicitaria y el formulario del que esperas recibir datos. Con la persona que configuró el webhook, comprueba que la suscripción a ese formulario esté habilitada. Anota cuándo se completó la integración de ese formulario; conectar otra cuenta o tener un receptor disponible no demuestra que este formulario esté suscrito.

La ayuda de TikTok exige esa verificación, pero no muestra un recorrido único de pantallas para todos los receptores. Revisa la configuración de tu integración o pide ese dato a quien la mantiene antes de modificarla.

Compara el momento del lead con el de la conexión

Obtén los leads del mismo formulario en Leads Center o mediante su descarga. Compara cuándo se recogió cada uno con el momento en que se completó la integración. Comprueba también que las horas usen la misma zona horaria antes de ordenar los eventos.

TikTok solo envía por esta integración los leads recogidos después de completarla. Los anteriores no se sincronizan automáticamente. En un ejemplo ficticio con todas las horas en UTC, el formulario se conecta a las 14:00. Que no llegue por webhook un lead de las 13:40 es coherente con ese límite. Si falta uno de las 14:20, es un caso posterior a la conexión que aún debes investigar.

La comparación separa el histórico de una posible incidencia nueva; no determina por sí sola la causa de un envío ausente.

Descarga el histórico disponible si lo necesitas

Para descargar y gestionar leads necesitas permiso Admin. TikTok Ads Manager conserva esos datos durante 90 días. Su guía de acceso a leads de Instant Forms indica este recorrido:

1. Entra en TikTok Ads Manager y abre Herramientas → Página instantánea.
2. Sitúa el cursor sobre el formulario instantáneo correcto.
3. Selecciona Descargar datos de clientes potenciales y revisa el archivo descargado.

La descarga reúne los leads del formulario, aunque se haya usado en varios anuncios, dentro del histórico disponible. Descargar el archivo no habilita una sincronización retroactiva por webhook. Si debes incorporarlo al sistema de destino, utiliza su proceso de importación y comprueba posibles duplicados.

Si sigue faltando un lead posterior a la conexión

Guarda la referencia de cuenta y formulario, la hora de suscripción, el momento del lead con su zona horaria y el estado observado en el receptor. Entrega esos datos al responsable técnico para comparar ambos lados de la integración. Para abrir un caso, evita copiar nombres, correos o teléfonos del lead en mensajes públicos.

Si ese lead figura en TikTok pero no en el destino, ya tienes un caso delimitado para investigar; aún no prueba dónde falló la entrega. Si tampoco figura en TikTok, comprueba primero el formulario y el período consultados. No recrees el formulario ni borres su conexión como primer intento sin conservar el estado que necesitas diagnosticar.