EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Mensagens diretas do TikTok pela API

A Business Messaging API do TikTok permite que um app de desenvolvedor aprovado envie e receba mensagens diretas de contas do TikTok com Advanced Access ou Verified Business Accounts: texto, imagens e cards de perguntas e respostas, com as mensagens recebidas entregues por webhook, além de mensagens de boas-vindas automáticas e perguntas sugeridas. Ela exige a análise de segurança de dados do TikTok e não abrange contas criadas no Espaço Econômico Europeu, na Suíça ou no Reino Unido.

A easyCoexistence conecta contas do TikTok pela API for Business do TikTok, para que Claude, ChatGPT ou sua própria plataforma responda a comentários em público, execute regras de comentário e respostas com IA e encaminhe eventos de comentário para o seu endpoint, com cada conexão monitorada 24 horas por dia.

Advanced Access

Menor nível de conta suportado pela Business Messaging API; as Verified Business Accounts também se qualificam, mas as Contas gerais do TikTok não.

10 messages

Limite máximo de mensagens que uma empresa pode enviar a um seguidor não mútuo nas 48 horas após a primeira mensagem dele, até que ele responda.

3 countries

Vietnã, Indonésia e Tailândia, onde a conta precisa estar registrada para usar Comment-to-Message.

10 working days

Prazo para o TikTok iniciar sua análise de segurança de dados e privacidade após o desenvolvedor enviar o formulário de admissão.

O que a Business Messaging API do TikTok faz?

Ela permite que uma conta do TikTok troque mensagens diretas com usuários do TikTok por meio de uma plataforma que integra a API. A mensagem do usuário chega por webhook com um conversation_id, e a empresa responde em /business/message/send/ com texto, uma imagem, uma publicação do TikTok compartilhada ou um card de perguntas e respostas cujos botões enviam a resposta do usuário. Também é possível exibir o indicador de digitação, marcar mensagens como lidas, listar até 100 conversas e ler as 20 mensagens mais recentes de uma delas.

Quais contas e regiões podem usar?

Contas com Advanced Access ou Verified Business Accounts; as Contas gerais do TikTok só ficam elegíveis depois de fazer upgrade. A região é o local de criação da conta:

  • Espaço Econômico Europeu, Suíça e Reino Unido: não disponível para contas criadas ali, e uma mensagem de um usuário dessa região chega ao webhook apenas como um aviso, sem o texto.
  • Estados Unidos: somente desenvolvedores que passem na análise de segurança de dados do TikTok nos EUA e assinem o USDS Addendum, além da análise geral.
  • Resto do mundo: desenvolvedores que passem na análise de segurança de dados e privacidade do TikTok.
  • Alguns recursos variam por região, como mensagens com imagem, que funcionam apenas onde os países de ambos os lados as suportam.

O que o desenvolvedor precisa para ter acesso?

Um app de desenvolvedor aprovado na API for Business do TikTok e, em seguida, uma análise separada. O desenvolvedor envia o formulário de admissão do TikTok, e o TikTok inicia a análise de segurança de dados e privacidade em até 10 dias úteis, enviando um questionário de due diligence; o acesso nos EUA acrescenta um segundo questionário da TikTok U.S. Data Security. Cada conta então autoriza o app, aprovando as permissões para ler, enviar e gerenciar suas mensagens e para ler o tipo de conta.

Quais limites se aplicam às mensagens?

O TikTok proíbe iniciar uma conversa: a empresa só pode enviar mensagens a usuários que escreveram para ela primeiro. Em conversas com usuários que não são seguidores mútuos, o volume também é limitado:

  • Após a primeira mensagem do usuário: até 10 mensagens nas 48 horas seguintes.
  • Após cada resposta do usuário: mensagens ilimitadas por 48 horas.
  • Mais de 48 horas desde a última resposta do usuário: mais três mensagens, até que o usuário escreva novamente.

O que são mensagens automáticas e Comment-to-Message?

As mensagens automáticas também são configuradas pela API: uma mensagem de boas-vindas quando o usuário inicia um chat, perguntas sugeridas com respostas, prompts de chat que convidam à conversa e uma mensagem para novos seguidores. O Comment-to-Message permite que a empresa responda por mensagem direta quando o TikTok marca um comentário em seus vídeos como de alta intenção, ou seja, um forte desejo de comprar ou saber mais. Ele está aberto apenas para contas registradas no Vietnã, na Indonésia e na Tailândia e, uma vez ativado, a conta responde a quem comentou e está registrado em APAC, LATAM e METAP.

A easyCoexistence pode responder DMs do TikTok?

Ainda não. A conexão da easyCoexistence com o TikTok roda na Accounts API do TikTok, e a API de mensagens do TikTok precisa de aprovação própria, que a easyCoexistence já solicitou. Até que ela seja concedida, o send_social_dm recusa uma conta do TikTok, as regras de comentário no TikTok respondem apenas em público e as automações do TikTok não têm etapas de mensagem direta.

Como funcionam as conversas no TikTok pela easyCoexistence hoje?

Nos comentários, em público. Sua IA lê os comentários de um vídeo com list_social_comments e responde abaixo deles com reply_to_comment; as regras de comentário respondem sozinhas aos comentários com palavras-chave, e as automações podem escrever a resposta com IA, com até 150 caracteres. Cada evento de comentário também pode ser encaminhado, assinado, para o seu próprio endpoint com set_social_webhook_destination.

Erros comuns

  • Adicionar os EUA a um app que não precisa deles. O TikTok observa que a análise de segurança de dados dos EUA pode prolongar a aprovação, e o acesso aos EUA pode ser adicionado depois.
  • Abrir chamados de suporte para cobrar a análise. Os chamados para desenvolvedores do TikTok são para problemas técnicos, e as análises não podem ser acompanhadas no portal de desenvolvedores.
  • Usar a Business Messaging API para chats do TikTok Shop. O TikTok Shop Messaging é um sistema separado que a API não gerencia.
  • Guardar o media_id de uma imagem para depois. O ID de uma imagem enviada vale por 30 dias, e depois disso a imagem precisa ser enviada novamente.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0,75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O TikTok tem uma API de DM?

Sim. A Business Messaging API envia e recebe mensagens diretas para contas com Advanced Access ou Verified Business Accounts, para desenvolvedores que o TikTok analisou.

Quanto tempo leva para ter acesso à Business Messaging API do TikTok?

O TikTok inicia a análise de segurança de dados e privacidade em até 10 dias úteis após o formulário de admissão, com um questionário de due diligence, e o acesso nos EUA acrescenta um segundo questionário que pode prolongar a aprovação. As análises não podem ser acompanhadas no portal de desenvolvedores.

Uma empresa do TikTok pode enviar mensagem para quem não escreveu primeiro?

Não. O TikTok proíbe iniciar uma conversa ou enviar mensagem a um usuário que não tenha iniciado uma conversa com a empresa.

A API de mensagens do TikTok está disponível na Europa?

Não para contas criadas no Espaço Econômico Europeu, na Suíça ou no Reino Unido; as mensagens dessas contas também não podem ser lidas pela API nem pelos webhooks.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorado 24/7

Verificado em