> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/canais-de-atendimento/tiktok.md). # TikTok O canal **TikTok** permite conectar a conta comercial do TikTok da sua empresa à **Hyperflow Integrações**, para que as mensagens diretas enviadas pelos seus contatos no TikTok cheguem até os seus fluxos de atendimento, do mesmo jeito que já acontece com outros canais como WhatsApp e Instagram. {% hint style="warning" %} O TikTok tem regras próprias e mais restritas de mensagem do que outros canais. Antes de conectar, leia a seção [Limites e regras do TikTok](#-limites-e-regras-do-tiktok-dicas-úteis) para entender o que é possível fazer hoje. {% endhint %}
Card do canal TikTok já conectado, na tela de Canais

Imagem 1 - Canal do TikTok com uma conexão, na tela de 'Canais'.

## 🧭 Como acessar 1. No menu lateral, clique em **Canais**. 2. Localize o card do **TikTok**. 3. Para conectar uma conta nova, clique em **Conectar**. Para ver ou editar contas já conectadas, clique em **Visualizar**.

Imagem 2 - Card do TikTok na tela de Canais, com os botões Visualizar e Conectar.

{% hint style="info" %} Para conectar o canal, você precisa ter uma **Conta Comercial do TikTok (TikTok Business Account)** já criada e ativa. Essa conta é configurada diretamente no TikTok, fora da Hyperflow. {% endhint %} ## 🖥️ Conhecendo a tela ### 🔐 Conectar com o TikTok Ao abrir a tela de conexão, você verá o botão **Entrar com o TikTok**. Ao clicar, uma janela oficial do TikTok é aberta para que você faça login e autorize o acesso da Hyperflow à sua conta comercial. Nessa autorização, o TikTok pede sua confirmação para que a Hyperflow possa: * Ler informações básicas da conta (nome, foto e tipo de conta). * Ler as mensagens recebidas na sua conta comercial. * Enviar respostas em nome da sua conta comercial.

Imagem 3 - Tela de login do TikTok, primeiro passo da autorização oficial.

### 👤 Conta conectada Depois de autorizar, a conta aparece listada na tela de **Canais**. Ao clicar em **Visualizar** no card do TikTok, você vê uma tabela com todas as contas já conectadas, mostrando **nome da conta** e **identificador da conta**. Clicando em **Editar** em uma delas, você abre a tela de configuração completa daquele canal. Nessa tela de edição, logo no topo, você também vê o **status da conexão**. Normalmente ele indica que está tudo certo, mas pode aparecer um aviso informando que a conexão ainda está sendo finalizada. Se isso acontecer, aguarde alguns instantes e, se persistir, entre em contato com o suporte Hyperflow antes de considerar o canal pronto para uso.

Imagem 4 - Tabela de contas TikTok conectadas, com botões Editar e Remover.

{% hint style="warning" %} Só considere o canal pronto para receber mensagens quando o status da conexão não mostrar nenhum aviso pendente. Enquanto houver um aviso de configuração pendente, é possível que mensagens não cheguem corretamente até a conexão ser concluída. {% endhint %}

Imagem 5 - Tela de edição do canal TikTok, com nome, identificador e status da conexão visíveis.

### 🔀 Fluxo padrão e apelido do canal Na aba **Geral** da tela de edição, você define como esse canal deve se comportar dentro da Hyperflow. | Campo | O que preencher | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Fluxo padrão** | Selecione o fluxo (a automação de atendimento montada na Hyperflow Integrações) que deve ser executado sempre que uma nova mensagem chegar pelo TikTok. | | **Apelido do canal** | Um nome interno para identificar essa conexão nas suas telas de Canais e Atendimento. Não precisa ser igual ao nome da conta no TikTok. |

Imagem 6 - Aba Geral com os campos Fluxo padrão e Apelido do canal preenchidos.

### ⚙️ Permissões do canal Ainda na aba **Geral**, três opções controlam o que esse canal pode fazer dentro da Hyperflow: | Opção | O que faz | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | | **Permitir ativo** | Libera que seus atendentes iniciem uma conversa ativa a partir da Hyperflow. | | **Permitir transmissão** | Libera o uso desse canal nas suas transmissões (envio de mensagem para vários contatos de uma vez). | | **Permitir apenas gatilhos** | Se ativado, o canal só aceita mensagens que chegam através de fluxos do tipo gatilho, e não pelo fluxo padrão comum. |

Imagem 7 - As três opções de permissão do canal na aba Geral.

{% hint style="warning" %} Mesmo que você ative **Permitir ativo** ou **Permitir transmissão**, o próprio TikTok não permite que a empresa inicie uma conversa nova ou envie mensagens em massa — veja a seção [Limites e regras do TikTok](#-limites-e-regras-do-tiktok-dicas-úteis) para entender por quê. {% endhint %} ### 💬 Mensagem automática Nesta aba você configura uma mensagem que o próprio TikTok exibe automaticamente para quem abre uma conversa com a sua conta comercial pela primeira vez. Essa configuração é feita aqui na Hyperflow, mas quem exibe a mensagem é o TikTok. O primeiro campo dessa aba é o **Tipo de mensagem automática**, com estas opções: * **Desativar mensagem automática**: nenhuma mensagem automática fica ativa para o canal. * **Mensagens de boas-vindas**: um texto (até 250 caracteres) exibido assim que o contato abre o chat com a sua conta pela primeira vez. * **Perguntas sugeridas**: uma ou mais perguntas prontas que aparecem para o contato clicar. Para cada pergunta, você preenche a **pergunta** (até 80 caracteres), a **resposta automática** (até 200 caracteres) e, opcionalmente, um **fluxo** que deve ser iniciado quando o contato clicar nela. * **Prompts do chat**: atalhos de conversa que funcionam de forma parecida com as perguntas sugeridas, também podendo iniciar um fluxo específico. {% hint style="info" %} Apenas **um** tipo de mensagem automática pode ficar ativo por vez. Ao escolher um novo tipo, o anterior deixa de valer para esse canal. {% endhint %}

Imagem 8 - Aba Mensagem automática com o campo Tipo de mensagem automática aberto, mostrando as opções.

#### 🎯 Propósito Dar as boas-vindas automaticamente a quem entra em contato pela primeira vez e já direcionar a conversa para o assunto certo, sem depender de uma primeira resposta manual. #### ✅ Como fazer na tela 1. Abra o canal TikTok já conectado em **Canais**, clicando em **Visualizar** e depois em **Editar** na conta desejada. 2. Clique na aba **Mensagem automática**. 3. Escolha o tipo de mensagem automática que deseja usar. 4. Preencha os campos correspondentes (mensagem de boas-vindas, ou as perguntas/prompts com suas respostas e fluxos). 5. Clique em **Salvar mudanças**. #### 📌 Resultado esperado A tela exibe uma mensagem de confirmação e, a partir desse momento, todo novo contato que abrir o chat verá a mensagem automática configurada. ### 🎯 Ações principais {% stepper %} {% step %} ## Conectar o canal TikTok #### 🎯 Propósito Vincular a conta comercial do TikTok à Hyperflow para começar a receber e responder mensagens pelos seus fluxos. #### ✅ Como fazer na tela 1. Acesse **Canais** e clique em **Conectar** no card do TikTok. 2. Clique em **Entrar com o TikTok** e conclua o login na janela do TikTok. 3. Confirme os dados da conta exibidos na tela. 4. Selecione o **fluxo padrão** do canal. 5. Clique em **Conectar**. #### 📌 Resultado esperado A conta aparece na lista de contas do card **TikTok**, em **Canais**, pronta para ser configurada e usada.

Imagem 9 - Conta TikTok conectada, com contador atualizado no card do canal.

{% hint style="info" %} A tela de conexão traz um link **Ver docs**, que leva direto para a documentação oficial da TikTok Business Messaging API — útil caso a equipe técnica precise consultar detalhes adicionais sobre a conta comercial do TikTok. {% endhint %} {% endstep %} {% step %} ## Testar o recebimento de mensagens #### 🎯 Propósito Confirmar que uma mensagem enviada por um contato no TikTok chega corretamente ao fluxo configurado. #### ✅ Como fazer na tela 1. Envie uma mensagem de teste para a conta comercial pelo próprio aplicativo do TikTok. 2. No menu lateral, clique em **Atendimento** e localize a nova conversa. 3. Confirme se o fluxo padrão foi iniciado corretamente. #### 📌 Resultado esperado A conversa aparece na fila de atendimento com os dados do contato (nome, @ e foto) preenchidos automaticamente. {% hint style="warning" %} **Antes de usar este recurso:** 1. O que precisa existir antes: uma Conta Comercial do TikTok já criada e ativa. 2. Onde configurar: diretamente no aplicativo/portal do TikTok, fora da Hyperflow. 3. Como voltar para concluir: depois de criar a conta comercial, volte para **Canais**, clique em **Conectar** no card do TikTok e siga o passo a passo de conexão. {% endhint %} {% endstep %} {% endstepper %} ## 💡 Limites e regras do TikTok (Dicas úteis) Estas regras não são definidas pela Hyperflow — são políticas do próprio TikTok, válidas para qualquer empresa que use a mensageria comercial dele. {% hint style="warning" %} * **A conversa só pode ser iniciada pelo contato.** A sua empresa não consegue mandar a primeira mensagem para alguém — o cliente sempre precisa escrever primeiro (pelo perfil, QR code ou anúncio do TikTok). * **Janela de resposta de 48 horas.** A partir da última mensagem do contato, sua empresa pode responder por até 48 horas, com um limite de até 10 mensagens dentro desse período. Passado esse prazo (ou esgotado o limite), só é possível continuar a conversa depois que o contato escrever novamente. * **Não existe envio de mensagem fora dessa janela.** Diferente do WhatsApp, o TikTok não oferece um recurso de mensagem paga/aprovada para reabrir uma conversa parada. * **Não existe transmissão em massa (broadcast).** Não é possível disparar uma mesma mensagem para vários contatos de uma vez pelo canal TikTok. * **Não existe gatilho por comentário, menção ou live.** O canal TikTok na Hyperflow funciona apenas para mensagens diretas — não é possível automatizar respostas a comentários em vídeos, menções ou interações em lives. {% endhint %} Sobre os tipos de mensagem: * **Você pode enviar:** texto (até 6.000 caracteres) e imagem. * **Compartilhar um vídeo já publicado:** é possível reenviar um vídeo que já existe publicado na sua conta, mas não é possível gravar e enviar um vídeo novo pela conversa. * **Você não pode enviar:** áudio nem arquivos/documentos — o TikTok não aceita esses formatos na mensageria comercial. * **Você pode receber:** texto, imagem, vídeo, compartilhamento de post e emojis/figurinhas enviados pelo contato. {% hint style="info" %} O envio e recebimento de imagem pode não estar disponível dependendo do país de origem da conta comercial — essa é uma restrição definida pelo próprio TikTok, que varia por região. {% endhint %} ## 📝 Resumo * O canal TikTok conecta a sua conta comercial do TikTok à Hyperflow Integrações, usando login oficial do TikTok, direto pela tela de **Canais**. * Depois de conectado, verifique o status da conexão antes de considerar o canal pronto, escolha o fluxo padrão e, se quiser, configure um tipo de mensagem automática (boas-vindas, perguntas sugeridas ou prompts do chat). * As opções **Permitir ativo**, **Permitir transmissão** e **Permitir apenas gatilhos** controlam permissões do canal dentro da Hyperflow, mas não driblam as regras do próprio TikTok. * O contato é identificado automaticamente pelo nome, @ e foto assim que manda a primeira mensagem. * O TikTok só permite responder quem já escreveu antes, dentro de uma janela de 48 horas e com limite de 10 mensagens — não há envio de mensagem fora dessa janela, nem transmissão em massa. * Hoje não existe automação por comentário, menção ou live no TikTok — apenas mensagens diretas.