Pular para o conteúdo
SoftChat

AjudaAgentes (chatbot)

Agentes (chatbot)

Montar fluxos que atendem sozinhos e passam para a equipe na hora certa.

Nesta seção: 13 tópicos

Agentes

Um agente é um fluxo de atendimento automático: dá boas-vindas, pergunta, mostra opções e transfere. Só agentes publicados respondem clientes sozinhos; os em rascunho ficam guardados para ajustar.

Criar um agente

Clique em Novo agente, dê nome e descrição. Em seguida o editor de fluxo abre. Se você já tem o fluxo pronto em JSON (feito por uma IA, como explicado mais abaixo), cole no campo Fluxo em JSON e o agente já nasce montado.

O editor de fluxo

O fluxo começa no bloco Início e segue pelas ligações. Em Adicionar você escolhe o próximo bloco; puxe a bolinha de saída de um bloco (embaixo ou ao lado de cada opção) até a bolinha de entrada do próximo (em cima) para ligar os dois. Saída só liga em entrada, e nada entra no Início.

  • Mensagem: envia um texto.
  • Pergunta: espera a resposta e guarda numa variável, como {{produto}}.
  • Opções e Lista: mostram botões ou uma lista; cada escolha segue um caminho. Uma Mensagem logo antes sai junto com os botões, numa mensagem só.
  • Mídia: envia imagem, vídeo, áudio ou documento.
  • Condição: segue um caminho ou outro conforme uma resposta.
  • Espera: dá uma pausa antes da próxima mensagem.
  • Transferir: passa para atendentes, com etiqueta e mensagem opcionais.
  • Agendar: cria um lembrete para a equipe do canal, ligado à conversa.
  • Definir variável: guarda um valor para usar mais à frente.
  • Agente IA: uma inteligência artificial conversa com o cliente seguindo as suas instruções.
  • Fim: encerra o fluxo.
  • Comentário e Grupo: só organizam o desenho, não mandam nada.

Editar um bloco

Clique num bloco para editar no painel da direita. As variáveis entre chaves viram o dado na hora do envio: {{contato.nome}}, {{contato.numero}}, {{canal.nome}}, {{conversa.link}}, {{data}} e {{hora}} já existem; as outras são as que o próprio fluxo guardou, como {{produto}}.

Integrações de IA

Para usar inteligência artificial nos agentes, cadastre antes a conexão com um provedor de IA em Integrações de IA, no menu lateral. Vale qualquer provedor no formato da OpenAI (OpenAI, Groq, OpenRouter, Gemini, DeepSeek, Ollama…) ou o Claude, da Anthropic. Cada integração é usada por quantos agentes você quiser.

  1. 1Cadastra uma integração nova.
  2. 2Testa a conexão: faz uma pergunta rápida à IA e avisa se a chave e o modelo estão certos.

Dica: O uso da IA é cobrado pelo provedor, direto na sua conta com ele.

Cadastrar uma integração

Dê um nome, escolha o provedor e cole a chave de API criada no site dele. A chave fica guardada com criptografia e não aparece de novo: para trocar, digite uma nova; deixar o campo vazio mantém a atual.

  • Provedor: OpenAI ou compatível para OpenAI, Groq, OpenRouter, Gemini, Ollama e similares; Anthropic para o Claude.
  • URL base: deixe vazio para o endereço oficial. Para outro provedor compatível, use o endereço dele (a dica embaixo do campo traz exemplos).
  • Modelo padrão: o modelo usado quando o bloco não define um, como gpt-4o-mini ou claude-sonnet-4-5.

O bloco Agente IA

Adicione o bloco Agente IA e clique nele para configurar. Escolha a integração, escreva nas Instruções quem a IA é e o que ela deve fazer, e cole na Base de conhecimento o que ela pode responder: preços, prazos, trocas, horários. Ela só usa o que estiver ali.

  • Modo Conversa: a IA responde cada mensagem do cliente até resolver. Sai por Concluído (objetivo atingido ou despedida), Transferir (o cliente pediu uma pessoa ou o limite de respostas acabou) ou Erro (a IA não respondeu).
  • Modo Resposta única: a IA gera um texto e o fluxo segue pela saída Resposta. Dá para guardar o texto numa variável e escolher se ele vai para o cliente. Serve para resumir ou classificar uma resposta.
  • Dados a salvar: a IA guarda numa variável o que o cliente contar, como o e-mail, para usar mais à frente.
  • Ferramentas: endereços de API que a IA pode consultar sozinha, como o status de um pedido ou um webhook do n8n.
  • Máx. respostas: depois desse número a conversa vai para a equipe, para a IA não ficar em círculos.
  • Mensagens seguidas: se o cliente manda várias mensagens de uma vez, a IA lê todas e responde uma vez só.

Dica: A saída Erro é opcional: se ela ficar solta e a IA falhar, o cliente recebe o aviso padrão e entra na fila de atendimento.

Criar o fluxo com ajuda de IA

Não sabe por onde começar o fluxo? O botão IA, no alto do editor, monta o agente a partir de uma descrição em português.

  1. 1Gerar com IA: escreve o que o agente deve fazer e uma das suas integrações monta o fluxo.
  2. 2Copiar instruções para IA: copia um texto que ensina qualquer IA (ChatGPT, Claude, Gemini…) a montar fluxos do SoftChat, com os nomes da sua equipe, etiquetas e integrações.
  3. 3Importar JSON: cola o fluxo que a IA devolveu.
  4. 4Exportar JSON: copia o fluxo aberto, para pedir ajustes a uma IA e importar de volta.

Gerar com IA

Escolha a integração e conte, com detalhes, como deve ser o atendimento: os assuntos, as perguntas, para quem transferir e com qual etiqueta. Ligue Partir do fluxo atual para a IA só ajustar o fluxo aberto, em vez de criar outro. A geração pode levar até 2 minutos.

Dica: Use um modelo forte (os mais novos de cada provedor): fluxos grandes exigem mais da IA.

Importar o JSON de uma IA de fora

Prefere usar o ChatGPT ou o Claude no navegador? Copie as instruções, cole numa conversa com a IA, escreva no fim o que o agente deve fazer e envie. A IA devolve o fluxo em JSON: copie a resposta e cole em Importar JSON. Pode colar a resposta inteira, o sistema acha o JSON sozinho.

  • No editor, clique em IA → Copiar instruções para IA.
  • Cole numa IA e descreva o agente no fim do texto.
  • Copie o JSON que a IA devolver.
  • Clique em IA → Importar JSON, cole, clique em Importar e confirme em Substituir.

Revisar o fluxo importado

Ao importar, o sistema mostra quantos blocos e ligações vieram e avisa o que precisa de atenção, como um atendente que não existe; confirme em Substituir. O fluxo atual é trocado e os blocos se organizam sozinhos na tela. Nada é gravado até você clicar em Salvar, e Desfazer volta ao fluxo anterior.

Dica: Confira cada bloco antes de publicar: a IA ajuda a começar, mas quem conhece o atendimento é você.

Testar e publicar

Em Testar → No simulador você conversa com o agente sem mandar nada no WhatsApp. "Em uma conversa" testa de verdade, num chat escolhido. Quando estiver pronto, clique em Rascunho (vira Publicado) e depois em Salvar. Se faltar alguma ligação no fluxo, o sistema avisa antes de publicar.

Dica: No simulador as respostas chegam na hora. No WhatsApp o agente mostra "digitando…" antes de cada mensagem, por alguns segundos conforme o tamanho do texto, como uma pessoa.

Ligar o agente a um canal

Para o agente receber todo contato novo, abra Canais → Configurações e ligue o Agente automático. Ele para sozinho assim que um atendente responde.