Construtor de fluxo/Etapas (Blocos)/Etapa de Ação/Ações Avançadas/TikTok API (Ações Avançadas)

TikTok API (Ações Avançadas)

As Ações Avançadas do TikTok API permitem executar operações diretas com sua conta comercial do TikTok sem precisar sair do NicoChat. Essas ações podem ser usadas dentro dos fluxos de automação.

2026-08-12

Conecte suas automações diretamente à API oficial do TikTok

As Ações Avançadas do TikTok API permitem executar operações diretas com sua conta comercial do TikTok sem precisar sair do NicoChat.
Essas ações podem ser usadas dentro dos fluxos de automação para buscar vídeos, responder comentários, curtir publicações e muito mais.

Onde encontrar

No construtor de fluxo:
Ações → Avançadas → TikTok API

Estrutura geral

Cada ação da TikTok API segue o mesmo formato:

Campo

Descrição

Ação

Define qual operação será executada na API do TikTok

Campos (opcionais)

Parâmetros adicionais da requisição

Testar Requisição

Permite testar a ação em tempo real e visualizar o retorno da API

Caminho JSON

Define o campo específico do retorno que você deseja salvar

Mapear resposta

Permite salvar o resultado em um campo personalizado do contato

Categorias de ações disponíveis

As ações estão organizadas por tipo de recurso:

🧑💼 Account (Conta)

Get Account Info

Obtém informações detalhadas da conta TikTok Business conectada.

Retorno de exemplo:

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 comuns:

Exibir dados da conta conectada no painel do chatbot
Validar se a conta é comercial antes de executar automações
Exibir a imagem e nome público do perfil no fluxo

🎥 Video (Vídeos)

Retorna uma lista de vídeos publicados na conta.

Parâmetros opcionais:

Limit — define a quantidade de vídeos retornados (padrão: 10)

Retorno de exemplo:

texto

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

Usos comuns:

Obter IDs de vídeos para automações de comentários
Criar relatórios ou listas de vídeos publicados
Enviar mensagens automáticas relacionadas ao conteúdo mais recente

Get Video Info

Retorna informações detalhadas de um vídeo específico.

Campos principais:

Video ID — ID do vídeo (geralmente capturado via gatilho ou variável)

Usos comuns:

Buscar o título, legenda ou metadados do vídeo antes de gerar uma resposta automatizada
Enviar respostas com base no conteúdo do vídeo
Criar fluxos de IA contextualizados (ex.: responder comentários com base no tema do vídeo)

Publish Video

Publica um novo vídeo diretamente pelo NicoChat (em contas com permissão).

Get Publishing Status

Verifica o status de publicação de vídeos enviados via API.

💬 Comment (Comentários)

List Comments

Lista todos os comentários de um vídeo específico.

Parâmetro: Video ID
Retorna lista com comment_id, username, text e timestamp.

Get Comment Info

Obtém detalhes de um comentário individual.

Listar Respostas de Comentário

Retorna respostas existentes dentro de um comentário pai.

Add Comment to Video

Publica um novo comentário em um vídeo.

Campos necessários:

Video ID
Mensagem

Responder ao Comentário

Responde diretamente a um comentário existente.

Campos necessários:

Video ID
Comment ID
Mensagem

Exemplo prático:

Nota

Um usuário comenta: “Tem em estoque?”
O fluxo busca o ID do vídeo e do comentário, e executa a ação Responder ao Comentário com a mensagem “Sim! Temos disponível em todas as cores 😄”.

Opção adicional:

Save as Bot Message — salva a resposta no histórico do bot (opcional).