← Voltar às documentações

Dados coletados e roteiro

Como configurar os campos que o bot coleta, a prioridade de cada um e o roteiro de perguntas.

Na edição do bot, a aba Dados coletados reúne duas ideias que trabalham juntas:

  1. Dados coletados: o que o bot deve obter e guardar (nome, telefone, interesse…).
  2. Roteiro: como conduzir a conversa, com perguntas sugeridas e, se quiser, ligadas a um campo.

Se você está montando o primeiro bot, comece por Como começar a configurar um bot.

Parte 1 — Dados coletados

Para que servem

Cada linha da tabela é um campo que a IA tenta obter durante a conversa. Quando o valor é confirmado, ele fica registrado no atendimento e aparece no resultado e nos sistemas que você conectou (como um CRM).

Se um bot que usa coleta não tem campos configurados, ele conversa normalmente, mas sem um controle organizado do que fica guardado.

Colunas e opções

OpçãoSignificado
TipoNome, Telefone, E-mail ou Personalizado. Nome, Telefone e E-mail têm identificadores fixos e não podem se repetir.
RótuloUm nome amigável (ex.: "WhatsApp", "Produto de interesse").
Token saídaO identificador do campo, usado para enviar o dado a outros sistemas (ex.: interesse). Nos campos de Nome, Telefone e E-mail ele é fixo.
ObrigatórioSe marcado, o bot insiste até obter o valor, ou até a pessoa recusar claramente. Campos obrigatórios também pesam no encerramento automático.
PrioridadeO quanto o bot insiste em obter o campo (veja abaixo).
AtivoDesligado, o campo deixa de ser perguntado, mas continua salvo na configuração para você religar depois.

Prioridade

NívelComportamento típico
OpcionalPouca insistência; no máximo uma menção leve, se couber. Nunca trava o encerramento.
RecomendadoPode perguntar mais uma vez; se a pessoa recusar ou ignorar, o bot segue.
EssencialPrioridade alta; com Obrigatório, o bot continua conduzindo até obter o valor ou haver recusa explícita.
Avançado (peso manual)Ajuste fino entre campos do mesmo nível. Na maioria dos casos, os três níveis bastam.

Tipos especiais

  • Telefone: o bot cuida do DDD e do país. Peça o número com DDD quando fizer sentido; o valor salvo é padronizado.
  • Nome e e-mail: são ligados ao contato. O bot não pergunta de novo o que já foi confirmado.
  • Personalizado: qualquer identificador livre, exceto nome, telefone e email. Bom para "prazo", "empresa", "produto_interesse".

O que o bot considera a cada mensagem

O bot sabe se cada campo está confirmado ou faltando. Ele não pergunta de novo o que já está confirmado e não promete retorno por um canal (como ligar) enquanto esse dado ainda falta.

Boas práticas

  • Comece com poucos campos: um nome, um contato (telefone) e um ou dois critérios do seu negócio.
  • Marque como obrigatório só o que realmente impede o próximo passo do seu time.
  • Use Ativo para desligar um campo em teste sem apagá-lo.
  • Não mude o identificador depois de conectar outros sistemas: eles dependem dele.

Parte 2 — Roteiro

Para que serve

O Roteiro é uma lista de até 20 perguntas que orienta a conversa. Não é um formulário rígido: o bot faz uma pergunta por vez, pula o que já foi respondido e pausa o roteiro diante de cumprimentos, correções, recusas ou pedido para falar com uma pessoa.

Onde configurar

Na mesma aba, abaixo da tabela de campos:

  1. Ative Usar roteiro de perguntas.
  2. Adicione as perguntas e, se quiser, escolha em Salvar em qual campo recebe a resposta.
  3. Reordene com as setas de subir e descer.

Salvar em

OpçãoEfeito
Um campo coletado (ex.: Interesse)A resposta é guardada nesse campo. Se o campo já estiver confirmado, o bot pula a pergunta.
Só guia (não salva)A pergunta orienta a conversa, mas não guarda nenhum dado.

Só aparecem na lista os campos que você já configurou. Por isso, configure primeiro os campos e depois o roteiro.

Roteiro e dados coletados

Dados coletadosRoteiro
PapelO que guardarComo perguntar
Guarda o dado?SimSó se ligado a um campo
ControleObrigatório, prioridade e ativoGuia flexível

Eles se complementam: o campo é o "lugar" onde o dado fica; o roteiro sugere quando e com que frase perguntar.

Exemplos

Só guia

  1. "O que te trouxe até nós hoje?" → Só guia
  2. "Quem mais participa da decisão?" → Só guia

Com salvamento

  1. "Qual produto ou serviço te interessa?" → Salvar em Interesse
  2. "Qual é o prazo ideal?" → Salvar em Prazo (campo personalizado)
  3. "Qual WhatsApp podemos usar?" → Salvar em Telefone

Boas práticas

  • Poucas perguntas no começo; você pode ampliar depois.
  • Prefira uma linguagem natural a uma lista de itens.
  • Ligue a pergunta a um campo só quando a resposta for um dado útil para o seu time.

Erros comuns

  • Muitos campos obrigatórios: a conversa trava ou parece insistente demais.
  • Roteiro longo sem campos ligados: a conversa fica rica, mas seu time não recebe os dados organizados.
  • Campo personalizado com identificador confuso: fica difícil usá-lo em outros sistemas.
  • Esquecer de ativar o campo: a pergunta do roteiro não tem onde guardar a resposta.

Relacionados