Builder · Atualizado em 06/10/2026

Como adicionar pesquisa ao Builder

Crie o bloco Pesquisa de satisfação, edite a pergunta, trate as notas de 1 a 5 e saiba como a resposta é registrada.

A Pesquisa de satisfação pergunta ao contato, ao fim de um atendimento, como ele avalia o serviço. No Builder ela é um bloco próprio, pronto para uso, com a escala de 1 a 5.

Quando usar

  • Depois que o atendimento humano termina e o fluxo recupera a conversa.
  • Para registrar a nota que o contato dá ao atendimento, por fila e por atendente.
  • Para encaminhar notas baixas a um caminho de recuperação (por exemplo, um pedido de desculpas ou um novo atendimento).

Pré-requisitos

  • Acesso de edição a um fluxo no Builder.
  • Um bloco Humano no fluxo, para que exista um atendimento encerrado a ser avaliado.

Passo a passo

  1. No canvas do Builder, clique no botão + para abrir NOVO BLOCO.
  2. Escolha Pesquisa de satisfação. O bloco nasce com o título "Pesquisa de satisfação" e já traz uma Entrada do usuário.
  3. Abra a aba Condições de saída do novo bloco.
  4. Em Pergunta da pesquisa, edite o campo Pergunta. O texto inicial é "De 1 a 5, como você avalia o atendimento?".
  5. Ainda em Condições de saída, clique em + Adicionar condição de saída para tratar as notas, por exemplo, Resposta do usuário Menor ou igual a 2.
  6. Escolha o bloco de destino em Ir para.
  7. Em Saída padrão, escolha para onde vão as demais respostas, como um bloco de agradecimento.
  8. No bloco Humano, em Saídas de atendimento, escolha a pesquisa como destino de "ticket finalizado pelo atendente" (e das demais saídas, se quiser avaliar também esses casos).
  9. Teste o caminho no painel de teste do Builder.
Menu NOVO BLOCO com a opção Pesquisa de satisfação

Campos da tela

OndeCampoO que faz
Condições de saídaPerguntaTexto enviado ao contato. Obrigatório
Condições de saídaSe, Condição, Valores, Ir paraDirecionam a conversa conforme a nota
Condições de saídaSaída padrãoDestino quando nenhuma condição é atendida
Condições de saídaExibir pesquisa de satisfaçãoOpção ao escolher o destino: filtra a lista para mostrar só blocos de pesquisa

Como o contato responde

O Pipe envia a pergunta seguida da linha 1 2 3 4 5. O contato responde com um número de 1 a 5, podendo acrescentar um comentário depois do número.

Resposta do contatoRegistro no Pipe
5Nota 5, sem comentário (estado so_nota)
4 chegou rápidoNota 4 com o comentário "chegou rápido" (estado completa)
Sem resposta dentro do tempo de inatividade da EntradaRegistrada sem nota (estado sem_resposta)
Outro texto, como "ok"Não é registrada como nota

Exemplo na Loja Girassol

Quando a conversa volta de um atendimento humano, o bloco Avaliação da Loja Girassol envia "De 1 a 5, como foi o atendimento da nossa equipe?". Notas até 2 seguem para o bloco Recuperação, que pede desculpas e oferece um novo contato. As demais notas seguem para o bloco Obrigado.

Resultado esperado

A nota e o comentário são gravados no último atendimento encerrado do contato, junto da fila e do atendente.

Boas práticas

  • Faça a pergunta curta e deixe claro que 5 é a melhor nota.
  • Ative o Tempo de inatividade na Entrada do usuário do bloco para registrar quem não responde.
  • Trate as notas baixas em um caminho próprio.
  • Use a validação da Entrada do usuário se quiser reforçar que a resposta é um número.

Limitações

  • A escala é fixa de 1 a 5; só o texto da pergunta é editável.
  • O Pipe não traz categorias prontas como promotor ou detrator: você cria as condições de saída.
  • A resposta só é registrada se o contato tiver um atendimento encerrado para ser avaliado.
  • Uma resposta que não comece por um número de 1 a 5 não vira nota.

Problemas comuns

  • A nota não foi registrada: o contato não tinha atendimento encerrado, ou a resposta não começava com um número de 1 a 5.
  • Não encontro a pesquisa no Adicionar conteúdo: ela é um bloco. Use NOVO BLOCO.
  • "O campo 'question' é obrigatório na pesquisa de satisfação": o campo Pergunta está vazio.

Próximos passos

Perguntas frequentes

A pesquisa aparece no menu Adicionar conteúdo?

Não. Ela é um tipo de bloco: clique no + do canvas e escolha Pesquisa de satisfação em NOVO BLOCO. Dentro do bloco, o cartão Pesquisa só indica que a pergunta é editada na aba Condições de saída.

Posso mudar a escala de 1 a 5?

Não. A escala é fixa de 1 a 5. Você edita apenas o texto da pergunta.

A que atendimento a nota é associada?

Ao último atendimento encerrado do contato, com a fila e o atendente daquele atendimento. Se o contato não tiver atendimento encerrado, a resposta não é registrada.

O contato pode deixar um comentário?

Sim. Se ele responder com a nota seguida de texto, como 5 atendimento ótimo, o texto fica como comentário.