NicoChatNicoChatDocumentaçãoBuscar na documentação…
Entrar

TikTok API (Acciones Avanzadas)

Las Acciones Avanzadas de TikTok API permiten ejecutar operaciones directas con tu cuenta comercial de TikTok sin salir de NicoChat. Estas acciones pueden usarse dentro de los flujos de automatización.

2026-08-12

Conecta tus automatizaciones directamente a la API oficial de TikTok

Las Acciones Avanzadas de TikTok API permiten ejecutar operaciones directas con tu cuenta comercial de TikTok sin salir de NicoChat.
Estas acciones pueden usarse dentro de los flujos de automatización para buscar videos, responder comentarios, dar me gusta a publicaciones y mucho más.

Dónde encontrar

En el constructor de flujo:
Actions → Advanced → TikTok API

Estructura general

Cada acción de la TikTok API sigue el mismo formato:

Campo
Descripción
Action
Define qué operación se ejecutará en la API de TikTok
Fields (optional)
Parámetros adicionales de la solicitud
Solicitud de prueba
Permite probar la acción en tiempo real y ver la respuesta de la API
JSON Path
Define el campo específico de la respuesta que deseas guardar
Map Response
Permite guardar el resultado en un campo personalizado del contacto

Categorías de acciones disponibles

Las acciones están organizadas por tipo de recurso:

🧑💼 Account (Cuenta)

Get Account Info

Obtiene información detallada de la cuenta de TikTok Business conectada.

Respuesta de ejemplo:

texto
{
  "display_name": "Nicola Occhipinti",
  "username": "nicola.om",
  "is_business_account": true,
  "profile_deep_link": "https://vm.tiktok.com/ZMAPqstW5/",
  "profile_image": "https://p16-sign-va.tiktokcdn.com/.../avatar.jpg"
}

Usos comunes:

  • Mostrar los datos de la cuenta conectada en el panel del chatbot
  • Validar si la cuenta es comercial antes de ejecutar automatizaciones
  • Mostrar la imagen y el nombre público del perfil en el flujo

🎥 Video (Vídeos)

List Videos

Devuelve una lista de videos publicados en la cuenta.

Parámetros opcionales:

  • Limit — define la cantidad de videos devueltos (predeterminado: 10)

Respuesta de ejemplo:

texto
{
  "videos": [
    { "item_id": "7563630498665286919", "caption": "🚀 Aumente suas conversões no real!" },
    { "item_id": "7563628163410955538", "caption": "A IA descobriu o gameplay..." }
  ]
}

Usos comunes:

  • Obtener IDs de videos para automatizaciones de comentarios
  • Crear informes o listas de videos publicados
  • Enviar mensajes automáticos relacionados con el contenido más reciente

Get Video Info

Devuelve información detallada de un video específico.

Campos principales:

  • Video ID — ID del video (generalmente capturado mediante un disparador o una variable)

Usos comunes:

  • Buscar el título, la leyenda o los metadatos del video antes de generar una respuesta automatizada
  • Enviar respuestas basadas en el contenido del video
  • Crear flujos de IA contextualizados (ej.: responder comentarios según el tema del video)

Publish Video

Publica un nuevo video directamente desde NicoChat (en cuentas con permiso).

Get Publishing Status

Verifica el estado de publicación de los videos enviados vía API.

💬 Comment (Comentarios)

List Comments

Lista todos los comentarios de un video específico.

Parámetro: Video ID
Devuelve una lista con comment_id, username, text y timestamp.

Get Comment Info

Obtiene detalles de un comentario individual.

Lista de respuestas a comentarios

Devuelve las respuestas existentes dentro de un comentario padre.

Add Comment to Video

Publica un nuevo comentario en un video.

Campos necesarios:

  • Video ID
  • Mensaje

Reply to Comment

Responde directamente a un comentario existente.

Campos necesarios:

  • Video ID
  • Comment ID
  • Mensaje

Ejemplo práctico:

Nota
Un usuario comenta: “¿Hay en stock?”
El flujo busca el ID del video y del comentario, y ejecuta la acción Reply to Comment con el mensaje “¡Sí! Lo tenemos disponible en todos los colores 😄”.

Opción adicional:

  • Save as Bot Message — guarda la respuesta en el historial del bot (opcional).

Like Comment

Agrega un me gusta a un comentario específico.

Campo necesario: Comment ID

Unlike Comment

Elimina el me gusta de un comentario previamente marcado.

Campo necesario: Comment ID

Hide Comment

Hace que el comentario sea invisible para el público (sigue visible para el autor y para el administrador).

Campo necesario: Comment ID

Unhide Comment

Revierte la acción de ocultar, haciendo que el comentario vuelva a ser público.

Campo necesario: Comment ID

Delete Comment

Elimina definitivamente un comentario de un video.

Campo necesario: Comment ID

💡 Ejemplos de automatización práctica

🧠 Flujo de respuesta inteligente

  • Disparador: TikTok Comment Created
  • Acción 1: TikTok API → Get Video Info
  • Acción 2: La IA genera una respuesta personalizada según la leyenda
  • Acción 3: TikTok API → Reply to Comment

❤️ Flujo de interacción automática

  • Disparador: TikTok Comment Created
  • Acción 1: TikTok API → Like Comment
  • Acción 2: TikTok API → Reply to Comment con una frase amable

🚫 Flujo de moderación

  • Disparador: TikTok Comment Created
  • Condición: Si el texto contiene palabras ofensivas
  • Acción: TikTok API → Hide Comment
  • Acción: Enviar una alerta interna para el equipo