O MaviBot possui integração com o TikTok — uma das plataformas sociais mais dinâmicas e populares do mundo. Isso marca um novo capítulo para o nosso ecossistema. O TikTok, onde milhões de usuários interagem diariamente, é o epicentro da comunicação moderna, tendências e novos formatos interativos. Essa integração permite que empresas e projetos se conectem com um público mais jovem em um nível totalmente novo.
Vamos revisar os aspectos técnicos do processo:
- as etapas necessárias para ativar a integração
- os callbacks disponíveis
- as permissões que precisam ser concedidas
Além disso, vamos nos concentrar especificamente nas nuances da disponibilidade regional.
É importante notar que a integração com o TikTok não está disponível em todos os países e depende de zonas econômicas específicas onde a plataforma suporta oficialmente esses recursos. Vamos descrever onde ela pode ser configurada imediatamente e onde podem haver limitações.
A API de Mensagens do TikTok está atualmente em teste beta aberto na região da Ásia-Pacífico, América Latina, Oriente Médio, África (METAP) e América do Norte (excluindo os Estados Unidos). A conta conectada deve estar registrada em uma dessas regiões.
Se um usuário dos Estados Unidos, do Espaço Econômico Europeu (EEE), da Suíça ou do Reino Unido enviar uma mensagem, ela não será recebida devido às restrições do TikTok.
Por favor, note!
Para criar e configurar um chatbot para o TikTok, consulte a seção "Como criar um chatbot para negócios".
As especificações dos botões do TikTok são abordadas aqui.
Integrar o TikTok com o MaviBot é mais do que uma atualização técnica — é uma oportunidade de estar na vanguarda da comunicação com o público, usar o canal mais quente para promoção e engajar usuários onde eles passam seu tempo.
Como preparar sua conta para a integração
Vamos começar com o passo mais importante — configurar a conexão corretamente.
Antes de conectar sua conta, você deve mudar para uma Conta Comercial.
Passo 1: Vá para a seção "Configurações e privacidade".
Passo 2: Em seguida, vá para a seção "Conta".
Passo 3: Clique em "Mudar para Conta Comercial".
Passo 4: Preencha os detalhes do seu negócio.
Pronto! Sua conta agora está pronta para ser conectada ao MaviBot.
Como conectar sua conta ao MaviBot
Vá para a seção "Mensageiros" e clique no botão TikTok.
Em seguida, faça login na sua conta do TikTok na janela que aparecer.
E conceda ao MaviBot acesso à sua conta.
Importante!
Recomendamos fortemente que você conceda acesso a comentários, mensagens, informações do perfil e a capacidade de visualizar seus vídeos. O bot e seus callbacks podem simplesmente não funcionar sem essas permissões.
Você pode deixar ou negar todas as outras permissões a seu critério.
Se posteriormente você revogar qualquer uma das permissões essenciais para o funcionamento correto do chatbot, só poderá reativá-las nas próprias configurações do TikTok.
Você será então redirecionado automaticamente para a seção "Mensageiros" no MaviBot, onde verá uma notificação confirmando a integração bem-sucedida.
Especificidades do TikTok
- Para poder enviar mensagens a um usuário, ele deve iniciar o chat primeiro.
- Você pode enviar até 10 mensagens dentro de um período de 48 horas após receber uma mensagem de um usuário do TikTok.
&#xNAN;Exemplo: Se você receber uma mensagem de um usuário, pode enviar até 10 mensagens nas próximas 48 horas. Se o mesmo usuário enviar outra mensagem mais tarde, uma nova janela de 48 horas começará, permitindo que você envie outras 10 mensagens para esse usuário. - Uma mensagem não pode conter texto e imagem simultaneamente.
- O envio e recebimento de anexos de imagem via API só está disponível se tanto o remetente quanto o destinatário estiverem localizados em países que suportam imagens em mensagens privadas. O compartilhamento de imagens não está disponível em todos os países.
- O tamanho máximo para um anexo de imagem é de 3 megabytes.
- Uma única mensagem pode conter apenas um anexo.
Callbacks
tiktok_client_new_comment <video_id>: <comment_text> - um usuário deixou um comentário no seu vídeo.
tiktok_client_share_post <shared_video_id> <url> - um usuário enviou um vídeo nas mensagens diretas da conta conectada.
Variáveis de cliente armazenadas
tiktok_comment_id - ID do comentário. Salvo quando um usuário comenta no seu vídeo e usado para responder a esse comentário.
tiktok_comment_video_id - ID do vídeo que está sendo comentado. Salvo quando um usuário comenta no seu vídeo e usado para responder ao comentário.
tiktok_is_follower - torna-se True se o usuário estiver seguindo sua conta.
tiktok_conversation_id - ID do chat. Gerado após um usuário enviar uma mensagem no chat. Necessário para enviar mensagens; não exclua!
Botões
O número máximo de botões em uma única mensagem é 3.
O TikTok suporta dois tipos de botões: callback e "padrão" (URL). No entanto, uma única mensagem só pode conter botões de um tipo.
Exemplo 1.
Exemplo 2.
Resultado
Por favor, note!
Mensagens com botões não estão disponíveis no TikTok Desktop. No chat do desktop, você verá uma notificação como esta:
No entanto, no aplicativo móvel, a mensagem será exibida corretamente:
O texto exibido no botão e o texto enviado ao bot ao clicar são idênticos. O botão é gerado usando dados do campo "Texto da Mensagem de Resposta" ou "URL" nas configurações do botão.
- Botões de callback aparecem como botões normais. Quando clicados, enviam uma mensagem no chat em nome do usuário, contendo o texto do botão. Comprimento máximo é de 20 caracteres.
- Botões de URL aparecem como links. No entanto, seu comportamento é o mesmo dos botões de callback. Atualmente, o TikTok não suporta a criação de botões que abrem uma página web na URL especificada quando clicados. Comprimento máximo é de 40 caracteres.
Saiba mais sobre o uso de botões de callback no MaviBot aqui.
Funções
Como responder a um comentário:
tiktok_create_comment(text, comment_video_id, comment_id) - publica uma resposta ao comentário especificado.