Table of Contents

TikTok Ads (formularios instantáneos)

  • Tipo de canal: captura de clientes potenciales (leads). Es una entrada de eventos hacia Lynn, no un canal conversacional.
  • Origen del lead: campañas de TikTok Ads con objetivo Lead Generation y Formulario instantáneo (Instant Form).
  • Destino: Lynn, mediante un webhook HTTPS.
  • Dónde se configura en Lynn: en el diseñador de flujos, como el resto de los canales (clic derecho → Configurar Canal).
  • Sandbox disponible: No.

Definición

Permite que los clientes potenciales que completan un formulario instantáneo de TikTok Ads sean enviados automáticamente a Lynn. Cuando un usuario envía el formulario, TikTok notifica el evento a Lynn con los datos capturados y la información del anuncio que lo originó.

Note

No confundir con el canal TikTok (mensajes directos, comentarios y menciones). Son integraciones distintas: aquélla trabaja con la cuenta de TikTok del negocio para atender conversaciones; ésta trabaja con la cuenta publicitaria (advertiser) para recibir leads de campañas.

Requisitos del cliente

Requisito Detalle
Acceso a TikTok Ads Manager Usuario con acceso a la cuenta publicitaria en ads.tiktok.com.
Autorización de la cuenta publicitaria La cuenta publicitaria debe autorizar la aplicación de integración (autorización del advertiser). Es un paso técnico que requiere al administrador de la cuenta; su detalle no forma parte de esta guía.
Campaña con objetivo Lead Generation La campaña de TikTok Ads que captará los leads debe usar un formulario instantáneo.

Configuración del canal en Lynn

El canal se agrega al flujo como cualquier otro canal:

  1. En el diseñador de flujos, clic derecho → Configurar Canal → Agregar canal, y seleccionar TikTok Ads en la Lista de Canales (en la descripción aparece el nombre "TikTok Ads", el autor e-Contact Digital Dev Team y la fecha de publicación).

  2. Presionar Crear.

    Lista de Canales, con TikTok Ads seleccionado

  3. Completar el formulario Configurar Canal:

    Formulario Configurar Canal de TikTok Ads

    Datos generales del canal: Ambiente (ej. developer), Channel Id (en el ejemplo, 47), Proveedor (LYNN (1)) y División; más las opciones habituales de cualquier canal: Habilitar canal, Verificación de salud, Habilitar la depuración, No enviar mensajes en blanco y Deshabilitar eventos de escritura.

    Sección "Configuración asociada a TikTok Ads (Requerido)" — los tres campos son obligatorios (marcados con *):

Campo Variable Descripción
Nombre configurado en TikTok Ads TIKTOK_ADS_NAME Nombre con el que se identifica la configuración en TikTok Ads.
Id del anuncio TIKTOK_ADS_ID Identificador del anuncio.
Tiempo de espera configurado para detectar inactividad y cerrar la interacción TIKTOK_ADS_TIMEOUT_SECONDS En segundos. Máximo 7200 s (2 horas).

Sección "Valores configuración del canal": muestra el campo WebHook (con un ícono para copiarlo), con la URL de Lynn a la que TikTok debe enviar los leads. En el ejemplo, de un ambiente de pruebas, es https://premium-testing.lynn.cx/connector/common2/TikTokAds/Index.

  1. Presionar Verificar.

Guía: crear el formulario instantáneo

El formulario se crea desde TikTok Ads Manager y no requiere publicar una campaña de inmediato.

Ruta: Herramientas → Páginas instantáneas → Crear → Formulario instantáneo.

Paso Acción
1 Ingresar a TikTok Ads Manager con acceso a la cuenta publicitaria.
2 Abrir Herramientas y seleccionar Páginas instantáneas.
3 Seleccionar Crear y luego Formulario instantáneo.
4 Elegir una plantilla o crear un formulario en blanco.
5 Configurar los campos requeridos, por ejemplo nombre, correo, teléfono u otros campos personalizados.
6 Configurar la sección de Privacidad, incluyendo la URL de la política de privacidad.
7 Configurar la pantalla final y completar/publicar el formulario.

Guías oficiales de TikTok:

Probar la integración

TikTok dispone de Test Leads (leads de prueba): permiten comprobar que el formulario y la entrega del evento a Lynn funcionan sin depender de una campaña pagada real. En producción se usa el mismo mecanismo cuando un usuario envía un formulario instantáneo asociado a una campaña de Lead Generation.

Note

En un lead de prueba, la información del anuncio (campaña, grupo de anuncios, anuncio) puede contener valores ficticios o no asociados a una campaña real.

Información que recibe Lynn

Dato Descripción
Identificador del lead Identifica el lead recibido.
Identificador del formulario Identifica el formulario instantáneo que lo originó.
Campaña Id y nombre de la campaña que originó el lead.
Grupo de anuncios Id y nombre del grupo de anuncios asociado.
Anuncio Id y nombre del anuncio asociado.
Fecha de creación Momento en que se creó el lead.
Campos del formulario Cada pregunta del formulario con el valor ingresado (por ejemplo, nombre y correo).
Important

Los campos del lead no son un conjunto fijo: dependen de las preguntas definidas en cada formulario instantáneo.

Consideraciones

  • La entrega de eventos requiere una URL HTTPS pública de Lynn accesible desde TikTok.
  • La suscripción se asocia a un formulario específico: si el cliente utiliza otros formularios, la configuración debe contemplarlos.
  • El alcance de la fuente termina con la recepción del evento por Lynn; el tratamiento posterior del lead depende del caso de uso definido para Lynn.
  • Las credenciales de la aplicación (App Secret, token de acceso, código de autorización) deben tratarse como confidenciales y no incluirse en documentación distribuida.

Pendientes

  • Procedimiento para habilitar la integración a un cliente en producción (quién ejecuta la autorización de la cuenta publicitaria y la suscripción de eventos): no definido en la fuente, que describe una prueba de concepto.
  • Flujo o campaña de Lynn que atiende el lead una vez recibido: depende del caso de uso, sin detalle en la fuente.

Documentación relacionada