Nvoip · Base de Conhecimento

Como criar um fluxo de Chatbot com integração com banco de dados

Como criar um fluxo de Chatbot com integração com banco de dados

Última atualização: 04/08/2026

Este guia cria um Chatbot que coleta uma identificação, consulta um banco de dados e usa o resultado para responder ou escolher uma fila.

Quando usar

Use para consultar cadastro, contrato, status, unidade responsável ou outra informação permitida. A integração deve ser de leitura quando o objetivo for somente direcionar o atendimento.

1. Criar a entrada e o Chatbot

  1. Crie o fluxo.
  2. Adicione Widget, WhatsApp, Instagram ou Messenger, conforme o canal.
  3. Configure Horário.
  4. Conecte HC ao Chatbot.
  5. Apresente o motivo da coleta antes de pedir o dado.

2. Coletar a chave

  1. Adicione Coleta de dados.
  2. Pergunte por uma informação mínima, como código do cliente.
  3. Escolha o tipo de resposta adequado.
  4. Salve em codigo_cliente ou outro nome claro.
  5. Configure inválido, prazo e destino sem resposta.

Não peça senha, código de autenticação ou dado que não seja necessário para o atendimento.

3. Criar a conexão de banco

Na aba Integrações, crie ou selecione uma conexão reutilizável. O responsável técnico deve informar host, porta, base, usuário e forma segura de autenticação.

Conexões reutilizáveis
Conexões reutilizáveis

Use credencial de acesso mínimo e mantenha consultas parametrizadas. O texto enviado pelo cliente não deve ser concatenado diretamente a um comando.

4. Configurar a consulta no fluxo

  1. Adicione Integrações após a coleta.
  2. Selecione a conexão de banco.
  3. Escolha a operação autorizada.
  4. Associe {{codigo_cliente}} ao parâmetro esperado.
  5. Teste com um registro fictício conhecido.
Configuração de entrada da integração
Configuração de entrada da integração

5. Mapear o retorno

Carregue os campos e salve somente o necessário:

Campo Variável Exemplo de uso
name nome_cliente “Olá, {{nome_cliente}}.”
status status_cliente Caminho ativo, pendente ou não encontrado.
team equipe_destino Seleção de fila.
Mapeamento de retorno
Mapeamento de retorno

6. Construir as respostas

Após sucesso, adicione um Chatbot que use os valores. Exemplo: “Localizamos seu cadastro. Vou encaminhar você à equipe responsável.”

Se o dado for opcional, escreva uma mensagem que não dependa dele. Não mostre no chat informações internas, financeiras ou pessoais sem a validação apropriada.

7. Criar os caminhos

Configure no mínimo:

  • registro encontrado → resposta e Fila correta;
  • registro não encontrado → nova tentativa ou Fila geral;
  • retorno incompleto → continuar sem personalização;
  • erro/timeout → mensagem de indisponibilidade e contingência;
  • cliente sem resposta → voltar ou encerrar de forma orientada.
Caminhos de sucesso e erro
Caminhos de sucesso e erro

8. Testar

Teste cada canal usado, entrada válida, formato inválido, registro inexistente, campo vazio, banco indisponível, timeout e fila sem agentes. Use dados de teste e confirme que nenhuma operação altera registros.

9. Publicar

Salve, resolva as pendências, ative e publique. Faça uma conversa controlada no canal real e confira se a variável aparece somente depois da consulta.

Checklist rápido

  • [ ] Coleta explica a finalidade.
  • [ ] Consulta é parametrizada.
  • [ ] Credencial possui acesso mínimo.
  • [ ] Variáveis de retorno foram mapeadas.
  • [ ] Não encontrado, erro e timeout estão tratados.
  • [ ] Mensagens não expõem dados indevidos.
  • [ ] Teste no canal real concluído.