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.
- 1Cadastra uma integração nova.
- 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.
- 1Gerar com IA: escreve o que o agente deve fazer e uma das suas integrações monta o fluxo.
- 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.
- 3Importar JSON: cola o fluxo que a IA devolveu.
- 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.