O MaviBot integra-se com o TikTok — uma das plataformas sociais que mais cresce e é mais popular no mundo.
Esta integração abre um novo capítulo para o ecossistema MaviBot. O TikTok, onde milhões de usuários interagem diariamente, tornou-se o centro da comunicação moderna, tendências e novos formatos interativos. As empresas agora podem alcançar públicos mais jovens através de uma das plataformas mais envolventes do mundo.
Neste artigo, você aprenderá:
- como ativar a integração;
- quais callbacks estão disponíveis;
- quais permissões devem ser concedidas.
Também abordaremos a disponibilidade regional e suas limitações.
Importante
A integração com o TikTok não está disponível em todos os países.
A API de Mensagens do TikTok está atualmente disponível em beta aberto apenas em:
- Ásia-Pacífico (APAC);
- América Latina;
- Oriente Médio;
- África (METAP);
- América do Norte (excluindo os Estados Unidos).
A conta do TikTok conectada deve estar registrada em uma dessas regiões.
Mensagens enviadas por usuários dos Estados Unidos, do Espaço Econômico Europeu (EEE), da Suíça ou do Reino Unido não podem ser recebidas devido a restrições da plataforma TikTok.
Para mais informações, consulte a documentação oficial do TikTok:
https://business-api.tiktok.com/portal/docs?id=1832184145137922
Por favor, observe
Antes de criar um chatbot para TikTok, consulte a seção Como criar um chatbot para negócios.
As limitações dos botões do TikTok estão descritas na seção Botões abaixo.
Integrar o TikTok com o MaviBot é mais do que apenas mais um canal — é uma oportunidade de se comunicar com os usuários onde eles passam mais tempo e construir interações altamente envolventes com os clientes.
Prepare sua conta do TikTok
Antes de conectar sua conta ao MaviBot, mude para uma Conta Comercial.
Passo 1
Abra Configurações e privacidade.
Passo 2
Abra a seção Conta.
Passo 3
Selecione Mudar para Conta Comercial.
Passo 4
Complete seu perfil comercial.
Pronto! Sua conta agora está pronta para conectar ao MaviBot.
Conecte sua conta do TikTok
Abra a seção Mensageiros no MaviBot e clique em TikTok.
Faça login na sua conta do TikTok.
Conceda ao MaviBot acesso à sua conta.
Importante
Recomendamos fortemente conceder permissão para:
- ler e gerenciar mensagens;
- acessar comentários;
- acessar informações do perfil;
- visualizar vídeos.
Sem essas permissões, o chatbot e alguns callbacks podem não funcionar corretamente.
Você pode negar qualquer outra permissão se não precisar delas.
Se posteriormente você revogar alguma permissão necessária, só poderá reativá-la nas configurações da sua conta do TikTok.
Após a autorização, você será redirecionado de volta para a seção Mensageiros, onde o MaviBot exibirá uma confirmação de que a integração foi bem-sucedida.
Limitações do TikTok
- Um usuário deve iniciar a conversa antes que o bot possa enviar mensagens.
- Você pode enviar até 10 mensagens em 48 horas após receber uma mensagem de um usuário.
- Exemplo: se um usuário lhe enviar uma mensagem, você pode enviar até 10 respostas nas próximas 48 horas. Se o usuário enviar outra mensagem mais tarde, uma nova janela de 48 horas começa com outra permissão de 10 mensagens de saída.
- Uma única mensagem não pode conter texto e imagem ao mesmo tempo.
- Anexos de imagem são suportados apenas se o remetente e o destinatário estiverem localizados em países onde o TikTok permite o compartilhamento de imagens em mensagens privadas.
- O tamanho máximo da imagem é 3 MB.
- Apenas um anexo pode ser incluído em uma única mensagem.
Callbacks
Novo comentário
tiktok_client_new_comment <video_id>: <comment_text>
Acionado quando um usuário deixa um comentário em um dos seus vídeos.
Vídeo compartilhado
tiktok_client_share_post <shared_video_id> <url>
Acionado quando um usuário compartilha um vídeo do TikTok nas mensagens diretas da conta conectada.
Variáveis do cliente
tiktok_comment_id
Armazena o ID do comentário.
Preenchida automaticamente quando um usuário comenta em seu vídeo e usada ao responder a esse comentário.
tiktok_comment_video_id
Armazena o ID do vídeo que recebeu o comentário.
Preenchida automaticamente quando um usuário comenta em seu vídeo.
tiktok_is_follower
Retorna True se o usuário segue sua conta do TikTok.
tiktok_conversation_id
Armazena o ID da conversa.
Criada automaticamente após um usuário enviar a primeira mensagem direta.
Importante
Não exclua esta variável.
Ela é necessária para enviar mensagens ao usuário.
Botões
Uma mensagem do TikTok pode conter até três botões.
O TikTok suporta dois tipos de botões:
- Botões de callback
- Botões de URL
Importante
Uma única mensagem pode conter botões de apenas um tipo.
Exemplo 1
Exemplo 2
Resultado
Por favor, observe
Mensagens com botões não são suportadas no TikTok Desktop.
Usuários de desktop verão a seguinte notificação:
No aplicativo móvel, a mensagem é exibida corretamente.
O texto exibido no botão é idêntico ao texto enviado de volta ao bot após ser clicado.
O texto do botão é retirado do campo Texto da Mensagem de Resposta ou do campo URL nas configurações do botão.
Botões de callback
Exibidos como botões normais.
Quando clicados, o TikTok envia uma mensagem ao bot em nome do usuário contendo o texto do botão.
Comprimento máximo: 20 caracteres.
Botões de URL
Exibidos como links.
Atualmente, o TikTok não suporta a abertura de páginas da web quando botões de URL são clicados.
Em vez disso, clicar no botão envia seu texto ao bot, como um botão de callback.
Comprimento máximo: 40 caracteres.
Saiba mais sobre botões de callback.
Funções
Responder a um comentário
tiktok_create_comment(text, comment_video_id, comment_id)
Publica uma resposta a um comentário do TikTok.
| Parâmetro | Descrição |
|---|---|
| text | Obrigatório. Texto da resposta. |
| comment_video_id | ID do vídeo que contém o comentário. Opcional. Se omitido, o valor da variável do cliente tiktok_comment_video_id é usado. |
| comment_id | ID do comentário a ser respondido. Opcional. Se omitido, o valor da variável do cliente tiktok_comment_id é usado. |