Use este guia quando você precisar configurar, entender ou validar **Como conectar TikTok** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Para a versão em nuvem da IAra, siga este guia.

## Pré-requisitos

Antes de configurar o canal TikTok, certifique-se do seguinte:

1. Você tem uma **Conta Comercial TikTok** registrada em uma região qualificada.

2. Sua conta comercial TikTok está configurada para **aceitar mensagens diretas de todos**. Caso contrário, você precisará aceitar mensagens manualmente no aplicativo TikTok. Saiba como atualizar suas [configurações de mensagens](https://ads.tiktok.com/help/article/how-to-update-your-tiktok-direct-message-permission-for-tiktok-messaging-ads?lang=en)

## Configurando o canal TikTok

### **Etapa 1: navegar até as caixas de entrada**

Vá para **Configurações** > **Caixas de entrada** e clique em **Adicionar caixa de entrada**.

\
Selecione **TikTok** na lista de canais disponíveis.

### **Etapa 2: Conecte sua conta TikTok**

### Clique em **Continuar com o TikTok** para iniciar o processo de autenticação.

### **Etapa 4: Autorizar IAra**

\
Você será redirecionado para o TikTok. Revise as permissões solicitadas e clique em **Continuar** para autorizar a IAra a acessar sua conta comercial TikTok.

\

### Etapa 5: Adicionar agentes

\
Após a autorização, você será redirecionado de volta a IAra. Adicione agentes à caixa de entrada do TikTok para que possam ver e responder às mensagens.

\
Seu canal TikTok agora está conectado. As mensagens diretas recebidas do TikTok aparecerão no painel da IAra.

## Limitações de mensagens

* Os clientes devem iniciar a conversa, as empresas não podem enviar mensagens primeiro.

* Os agentes podem enviar até **10 mensagens** antes que a pessoa atendida responda. Depois que a pessoa atendida responde, as mensagens são ilimitadas.

* O período de resposta é de **48 horas** a partir da última mensagem do cliente.

* Atualmente, apenas mensagens de **texto**, **imagem** e **post share** são suportadas devido a limitações na API TikTok Business Messaging.

* As mensagens enviadas diretamente do aplicativo TikTok serão sincronizadas com a IAra.

* Mensagens recebidas em formatos não suportados (por exemplo, áudio, adesivos) aparecerão como "Esta mensagem não é suportada. Você pode visualizar esta mensagem no aplicativo TikTok."

## **Perguntas frequentes**

### Por que não consigo enviar mensagens de mídia para alguns usuários do TikTok?

Isso acontece devido às restrições do TikTok. Algumas regiões não permitem o envio ou recebimento de imagens e, em outros casos, a conta do usuário pode ser sinalizada pelo TikTok.

### Quais países oferecem suporte ao TikTok Business Messaging?

A API TikTok Business Messaging não está atualmente disponível no EEE, na Suíça ou no Reino Unido. Os recursos de mensagens podem estar limitados ou indisponíveis para usuários nessas regiões.  Para as regiões e restrições suportadas mais recentes, consulte a [documentação] oficial do TikTok (https://business-api.tiktok.com/portal/docs/business-messaging-api/v1.3).

## **Disponibilidade**

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.