> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Lead Generation

> Transforme os leads dos seus anúncios do TikTok, tanto de formulários instantâneos quanto de anúncios de mensagens, em contatos, responda por WhatsApp assim que um lead chega e guarde o resultado de cada um.

O TikTok Lead Generation transforma os leads dos seus anúncios do TikTok em contatos da Ciarem: tanto os formulários instantâneos que as pessoas preenchem quanto os leads que o TikTok extrai dos seus anúncios de mensagens. Você escolhe onde cada resposta do formulário fica e pode enviar um modelo de WhatsApp para cada novo lead assim que ele chega. Os administradores o configuram em **Configurações > Integrações > TikTok Lead Generation**.

> [!NOTE]
>
> O TikTok guarda os leads por 90 dias. A Ciarem recebe cada lead assim que ele chega e o armazena, então seus contatos duram além desse prazo.

## Conectar uma conta de anúncios

Os leads pertencem a uma conta de anúncios do TikTok, então você conecta as contas de anúncios que veiculam seus anúncios de cadastro.

**1. Abra o TikTok Lead Generation**

Vá em **Configurações**, depois em **Integrações**, e clique em **Conectar** no cartão do TikTok Lead Generation.

**2. Faça login no TikTok for Business**

Faça login com uma conta do TikTok for Business que administre as contas de anúncios e autorize a Ciarem.

**3. Escolha suas contas de anúncios**

Marque todas as contas de anúncios que veiculam seus anúncios de cadastro e clique em **Conectar**. Você pode adicionar mais depois em **Conectar conta de anúncios**.

**4. Confira seus formulários**

Os formulários instantâneos da conta de anúncios aparecem em **Formulários de leads**. Um formulário que você publicar depois no TikTok Ads Manager também aparece lá. Clique em **Atualizar** se ainda não o vir.

Uma conta de anúncios só pode estar conectada a um workspace da Ciarem. Fazer login de novo mais tarde renova o acesso das contas que você já conectou; mantenha-as marcadas.

## Formulários de leads

A tabela **Formulários de leads** mostra, para cada formulário, seus envios, os contatos criados e quantos precisam de atenção. Envios que não viraram contato geralmente indicam um problema de mapeamento. Um formulário mostra **Pronto** quando toda pergunta tem um destino, ou quantas perguntas ainda não foram mapeadas.

Cada conta de anúncios também tem uma linha **Mensagens diretas**. São os leads que o TikTok extrai dos seus anúncios de mensagens: não há formulário, então só podem chegar o nome, o e-mail e o telefone. Você pode pausá-los e dar a eles uma resposta automática como a qualquer formulário.

## Mapear as perguntas

Abra um formulário para escolher onde cada resposta fica, em **Mapeamento de perguntas**. Perguntas padrão, como nome, e-mail e telefone, são mapeadas sozinhas. Perguntas personalizadas precisam de um destino: um campo do contato ou uma propriedade personalizada. Clique em **Salvar alterações**. Uma mudança de mapeamento vale só para os novos leads; os já recebidos mantêm o mapeamento com que chegaram.

Quando uma pergunta fica em uma propriedade com opções, cada resposta vai para a opção com o mesmo rótulo. O TikTok não compartilha com a Ciarem as opções de resposta de uma pergunta, então uma propriedade criada a partir de uma pergunta é de texto.

Para pausar um formulário, desative **Criar contatos a partir deste formulário**. Os envios continuam sendo salvos, mas nenhum contato é criado enquanto estiver desativado.

## Como os leads combinam com seus contatos

Um lead precisa de um e-mail ou de um número de telefone para virar contato. A Ciarem procura primeiro um contato com o mesmo e-mail, depois um com o mesmo telefone:

* **Sem correspondência**: a Ciarem cria um contato novo, com o anúncio do TikTok como origem.
* **Com correspondência**: o nome, o e-mail e o telefone do lead só preenchem os campos vazios do contato, então nada que sua equipe ou o agente de IA já definiu é substituído. As propriedades personalizadas que você mapeou são atualizadas com as respostas do lead mais recente. Uma resposta vazia nunca apaga uma propriedade.

Um lead sem e-mail nem número de telefone não é importado. Ele aparece no histórico de envios do formulário com o motivo.

## Quando chega um novo lead

* **Modelo de resposta automática**: escolha um [modelo](https://help.ciarem.ai/pt/channels/message-templates.md) de WhatsApp aprovado e ele é enviado para cada novo lead deste formulário assim que ele chega. Cada envio é cobrado do seu saldo de WhatsApp pela tarifa da Meta, como qualquer modelo.
* **Criar uma tarefa de follow-up quando a resposta automática não puder ser enviada**: quando está ativo e nenhuma resposta automática sai, seja porque nenhum modelo foi escolhido ou porque não foi possível enviar, a Ciarem cria uma [tarefa](https://help.ciarem.ai/pt/using-ciarem/tasks.md) com vencimento 24 horas depois que o lead chegou, para o proprietário do contato. Um lead novo normalmente ainda não tem proprietário, então os administradores encontram a tarefa em **Sem proprietário**.

A resposta automática é pulada quando o lead não tem número de telefone, o número não está no WhatsApp, falta um valor obrigatório no modelo, seu saldo é insuficiente, o limite de mensagens da linha foi atingido ou a linha de WhatsApp do modelo foi desconectada. Cada pulo é mostrado com o motivo.

## Histórico de envios

Cada formulário mantém um **Histórico de envios** com o resultado de cada lead: o contato que criou ou atualizou, se a resposta automática foi enviada e por que um lead não virou contato.

## Desconectar uma conta de anúncios

**Desconectar** impede que novos leads dessa conta de anúncios criem contatos. Seus mapeamentos de formulários são mantidos e voltam a valer se você reconectar.

## Solução de problemas

### Minha conta de anúncios não aparece na lista

O TikTok só lista as contas de anúncios que a conta com que você fez login pode administrar. Faça login com uma conta do TikTok for Business que tenha acesso à conta de anúncios e clique em **Conectar conta de anúncios** de novo.

### "Esta conta de anúncios do TikTok já está conectada a outro workspace"

Uma conta de anúncios só pode enviar seus leads para um workspace da Ciarem. Desconecte-a do outro workspace primeiro e depois conecte-a aqui.

### "Não conseguimos mais ler os formulários desta conta de anúncios"

A Ciarem perdeu o acesso à conta de anúncios. Isso costuma acontecer quando o acesso foi revogado no TikTok for Business ou a pessoa que a conectou perdeu o papel dela na conta de anúncios. Clique em **Reconectar** e faça login de novo.

### Os leads não chegam

* Confira o **Histórico de envios** do formulário. Se o lead estiver lá, o resultado diz por que ele não virou contato. As causas mais comuns são um formulário pausado ou um lead sem e-mail e sem telefone.
* Se o lead não estiver lá, verifique se a conta de anúncios aparece como conectada sem o aviso **Reconectar**.
* Leads enviados antes de você conectar a conta de anúncios não são importados.

Também veicula anúncios no Facebook ou no Instagram? Veja [Meta Lead Ads](https://help.ciarem.ai/pt/integrations/meta-lead-ads.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.