Como criar um chatbot para TikTok
O MaviBot tem 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, das tendências e dos 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 analisar 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 observar 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 nas quais a plataforma oferece oficialmente esses recursos. Vamos mostrar onde ela pode ser configurada imediatamente e onde podem haver limitações.
A API de Mensagens do TikTok está atualmente em testes beta abertos 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.
Consulte a documentação oficial do TikTok para mais detalhes.
Por favor, observe!
Para criar e configurar um chatbot para o TikTok, consulte a seção "Como criar um chatbot para empresas".
As especificações dos botões do TikTok são abordadas aqui.
Integrar o TikTok ao 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 a etapa mais importante — configurar a conexão corretamente.
Antes de conectar sua conta, você deve mudar para uma Conta Comercial.
Etapa 1: Vá para a "Configurações e privacidade" seção.
Etapa 2: Em seguida, vá para a seção "Conta".
Etapa 3: Clique em "Mudar para Conta Comercial".
Etapa 4: Preencha os dados da sua empresa.
Pronto! Sua conta agora está pronta para ser conectada ao MaviBot.
Como conectar sua conta ao MaviBot
Vá para a guia "Mensageiros" seção e clique em 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 à capacidade de visualizar seus vídeos. O bot e seus callbacks podem simplesmente não funcionar sem essas permissões.
Você pode deixar de conceder ou negar todas as outras permissões a seu critério.
Se depois você revogar qualquer uma das permissões essenciais para o chatbot funcionar corretamente, só poderá reativá-las nas próprias configurações do TikTok.
Em seguida, você será redirecionado automaticamente para a "Mensageiros" seção 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 precisa iniciar a conversa primeiro.
Você pode enviar até 10 mensagens em um período de 48 horas após receber uma mensagem de um usuário do TikTok. Exemplo: Se você receber uma mensagem de um usuário, poderá enviar até 10 mensagens nas próximas 48 horas. Se o mesmo usuário enviar outra mensagem depois, um novo período de 48 horas começará, permitindo que você envie mais 10 mensagens para esse usuário.
Uma mensagem não pode conter texto e uma imagem ao mesmo tempo.
O envio e o recebimento de anexos de imagem via API só estão disponíveis se tanto o remetente quanto o destinatário estiverem localizados em países que oferecem suporte a imagens em mensagens privadas. O compartilhamento de imagens não está disponível em todos os países.
O tamanho máximo de um anexo de imagem é de 3 megabytes.
Uma única mensagem pode conter apenas um anexo.
Retornos de chamada
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 armazenadas do cliente
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 Verdadeiro 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). HNo entanto, uma única mensagem pode conter apenas botões de um tipo.
Exemplo 1.
Exemplo 2.
Resultado
Por favor, observe!
Mensagens com botões não estão disponíveis no TikTok Desktop. No chat do desktop, você verá uma notificação assim:
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.
Os 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. O comprimento máximo é de 20 caracteres.
Os botões de URL aparecem como links. No entanto, seu comportamento é o mesmo dos botões de callback. Atualmente, o TikTok não oferece suporte à criação de botões que abrem uma página da web no URL especificado quando clicados. O 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.
! text
parâmetro obrigatório, o texto do comentário
comment_video_id
O ID do vídeo em que o comentário foi publicado. Este é um parâmetro opcional; se não for fornecido, o valor será obtido de cliente tiktok_comment_video_id variável.
comment_id
O ID do comentário ao qual responder. Este é um parâmetro opcional; se não for fornecido, o valor de cliente tiktok_comment_id variável será usado.
Atualizado