Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Mensagens diretas do TikTok através da API

A Business Messaging API do TikTok permite a um programador aprovado enviar e receber mensagens diretas em contas com Advanced Access ou Verified Business Accounts: texto, imagens e cartões de perguntas e respostas, com as mensagens recebidas entregues por webhook, além de mensagens de boas-vindas automáticas e perguntas sugeridas. Exige a revisão de segurança de dados do TikTok e não abrange contas registadas no Espaço Económico Europeu, na Suíça ou no Reino Unido.

A easyCoexistence liga contas do TikTok através da API for Business do TikTok, para que o Claude, o ChatGPT ou a sua própria plataforma respondam a comentários em público, executem regras de comentários e respostas com IA e encaminhem os eventos de comentário para o seu endpoint, com cada ligação monitorizada 24 horas por dia.

Advanced Access

Nível mais baixo de conta suportado pela Business Messaging API; as Verified Business Accounts também se qualificam, mas as General TikTok Accounts não.

10 messages

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

3 countries

Vietname, Indonésia e Tailândia, onde a conta tem de estar registada para usar o Comment-to-Message.

10 working days

Prazo em que o TikTok inicia a revisão de segurança e privacidade de dados após o programador submeter o formulário de admissão.

O que faz a Business Messaging API do TikTok?

Permite que uma conta do TikTok troque mensagens diretas com utilizadores do TikTok através de uma plataforma que integra a API. A mensagem de um utilizador chega por webhook com um conversation_id, e a empresa responde através de /business/message/send/ com texto, uma imagem, uma publicação partilhada do TikTok ou um cartão de perguntas e respostas cujos botões enviam a resposta do utilizador. Pode também mostrar que a conta está a escrever e marcar mensagens como lidas, listar até 100 conversas e ler até às 20 mensagens mais recentes de uma só.

Que contas e regiões podem usá-la?

Contas com Advanced Access ou Verified Business Accounts; as General TikTok Accounts só se tornam elegíveis depois de atualizarem a conta. A região é o local de registo da conta:

  • Espaço Económico Europeu, Suíça e Reino Unido: não disponível para contas aí registadas, e uma mensagem de um utilizador de lá chega ao webhook apenas como aviso, sem o texto.
  • Estados Unidos: só programadores que passem a revisão de segurança de dados do TikTok nos EUA e assinem o USDS Addendum, além da revisão geral.
  • Resto do mundo: programadores que passem a revisão de segurança e privacidade de dados do TikTok.
  • Algumas funcionalidades variam por região, como as mensagens com imagens, que só funcionam onde os países de ambos os lados as suportam.

O que precisa um programador para ter acesso?

Uma aplicação de programador aprovada na API for Business do TikTok, seguida de uma revisão separada. O programador submete o formulário de admissão, e o TikTok inicia a revisão de segurança e privacidade de dados no prazo de 10 dias úteis, enviando um questionário de diligência devida; o acesso aos EUA acrescenta um segundo questionário da TikTok U.S. Data Security. Depois, cada conta autoriza a aplicação, aprovando as permissões para ler, enviar e gerir as suas mensagens e para ler o tipo da sua conta.

Que limites se aplicam às mensagens?

O TikTok proíbe iniciar conversas: uma empresa só pode enviar mensagens a utilizadores que lhe escreveram primeiro. Nas conversas com utilizadores que não são seguidores mútuos, o volume também é limitado:

  • Depois da primeira mensagem do utilizador: até 10 mensagens nas 48 horas seguintes.
  • Após cada resposta do utilizador: mensagens ilimitadas durante 48 horas.
  • Passadas mais de 48 horas desde a última resposta do utilizador: mais três mensagens, até que o utilizador volte a escrever.

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

As mensagens automáticas também se definem através da API: uma mensagem de boas-vindas quando um utilizador inicia uma conversa, perguntas sugeridas com respostas, sugestões para iniciar conversa que convidam a dialogar e uma mensagem para novos seguidores. O Comment-to-Message permite à empresa responder por mensagem direta quando o TikTok assinala um comentário nos seus vídeos como de alta intenção, ou seja, uma forte vontade de comprar ou de saber mais. Está disponível apenas para contas registadas no Vietname, na Indonésia e na Tailândia e, uma vez ativado, a conta responde a quem comenta registado na APAC, na LATAM e na METAP.

A easyCoexistence pode responder a mensagens diretas do TikTok?

Ainda não. A ligação do TikTok na easyCoexistence assenta na Accounts API do TikTok, e a API de mensagens do TikTok precisa de aprovação própria, que a easyCoexistence já pediu. Até ser concedida, o send_social_dm recusa uma conta do TikTok, as regras de comentários no TikTok respondem apenas em público e as automações do TikTok não têm passos de mensagens diretas.

Como funcionam hoje as conversas no TikTok através da easyCoexistence?

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

Erros comuns

  • Acrescentar os EUA a um pedido que não precisa deles. O TikTok refere que a revisão de segurança de dados nos EUA pode prolongar a aprovação, e o acesso aos EUA pode ser acrescentado mais tarde.
  • Abrir pedidos de apoio para acompanhar a revisão. Estes servem para problemas técnicos, e as revisões não podem ser seguidas no portal de programadores.
  • Usar a Business Messaging API para as conversas do TikTok Shop. O TikTok Shop Messaging é um sistema separado que a API não gere.
  • Guardar o media_id de uma imagem para mais tarde. O ID de uma imagem carregada é válido durante 30 dias, depois do qual a imagem tem de ser carregada outra vez.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, baixando à medida que se acrescentam ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

O TikTok tem uma API de mensagens diretas?

Sim. A Business Messaging API envia e recebe mensagens diretas em contas com Advanced Access ou Verified Business Accounts, para programadores que o TikTok tenha revisto.

Quanto tempo demora o acesso à Business Messaging API do TikTok?

O TikTok inicia a revisão de segurança e privacidade de dados no prazo de 10 dias úteis após o formulário de admissão, com um questionário de diligência devida, e o acesso aos EUA acrescenta um segundo questionário que pode prolongar a aprovação. As revisões não podem ser acompanhadas no portal de programadores.

Pode uma empresa do TikTok enviar mensagens a alguém que não escreveu primeiro?

Não. O TikTok proíbe iniciar conversas ou enviar mensagens a um utilizador 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 registadas no Espaço Económico Europeu, na Suíça ou no Reino Unido; as suas mensagens também não podem ser lidas através da API nem dos webhooks.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

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

Verificado em