"Ações: o que o agente pode fazer"

As ações do agente na aba Ações (mover leads, avisar a equipe, agendar, registrar vendas, coletar documentos e mais) e como configurá-las.

Responder bem é metade do trabalho. A outra metade é agir: mover o lead no funil, avisar o vendedor, marcar o horário. No editor do agente, a aba Ações (antes chamada Ferramentas) reúne tudo o que o agente consegue fazer no CRM.

Como funciona

Na aba Ações, cada botão cria uma ação de um tipo (até 20 por agente). Cada ação tem:

  • Quando usar esta ação: a instrução mais importante. Escreva no imperativo e de forma concreta ("use quando o lead confirmar orçamento e prazo").
  • Identificador: usado só internamente, com letras minúsculas, números e _.
  • Configuração: os detalhes fixos (qual etapa, qual pessoa, qual caixa), definidos por você, nunca pela conversa.

Para encaixar uma ação num passo a passo, use o passo Fazer uma ação na aba Procedimentos. Toda ação pede ao agente um motivo ao ser usada, e esse motivo fica registrado como nota no contato: é a trilha do que a IA fez.

Os tipos de ação

  1. Mover lead no funil: move (ou cadastra) o lead numa etapa que você escolheu. Por padrão, não deixa o agente voltar o lead para uma etapa anterior; se o seu processo precisa disso (ex.: reabrir um caso), marque Permitir voltar etapa. Se o lead tem card em mais de um funil, vale o card do funil da etapa escolhida.
  2. Notificar usuário no CRM: avisa alguém da equipe no ScalaCRM, com a opção de pausar a IA junto (o clássico "chamar uma pessoa"). Você pode fixar o destinatário ou deixar o agente escolher pela conversa.
  3. Notificar via WhatsApp: manda um aviso para um número de WhatsApp. Você pode fixar o número (ex.: o celular do dono) ou deixar o agente informar na hora. No campo do número, escolha o país e digite o número; quem digita com + e o código de outro país é entendido como estrangeiro. Use o botão Enviar teste para receber uma mensagem de verificação antes de salvar (ele também aparece no passo de avisos do fluxo guiado). Se o número estiver errado, a ação passa a falhar e os administradores recebem um alerta: confira o código do país.
  4. Requisição HTTP externa: chama um sistema seu por uma URL que você configura; o agente só preenche os espaços que você deixou (como {{consulta}}).
  5. Preencher campos do lead: atualiza os campos personalizados do contato com o que o agente descobriu (ex.: "Convênio: Unimed").
  6. Criar tarefa: abre uma tarefa para a equipe.
  7. Registrar venda: registra a venda como pendente, para a equipe confirmar o recebimento depois.
  8. Agendar na agenda: marca um horário real na Agenda, checando conflitos; se o horário estiver ocupado, o agente recebe alternativas livres.
  9. Consultar horários livres: devolve os próximos horários disponíveis de um profissional, para o agente oferecer opções concretas.
  10. Enviar template ao lead (fora da janela): manda um template aprovado da API oficial quando a janela de 24 horas já fechou.
  11. Coletar documentos (checklist): uma lista de documentos que o agente pede. Cada arquivo recebido é classificado e aparece na ficha do contato; o agente só usa os itens da lista.
  12. Passar para outro agente: transfere a conversa para outro agente ativo. Use quando muda o que pode ser feito (ações, dados a coletar, etapa), não só o assunto.
  13. Consultar outro agente: pergunta algo a outro agente sem trocar o dono da conversa. O lead nunca vê o agente consultado, e ele só informa, não age. Máximo de 2 consultas por mensagem.

Os dois últimos só aparecem quando a conta tem outro agente.

O que o agente consegue ler e pesquisar

Abaixo das ações ficam os interruptores Pesquisar na internet, Ler imagens, Ler PDFs e Ouvir áudios. Cada item desligado é uma incapacidade real do agente, não só um pedido.

Máximo de vezes por conversa

Toda ação pode ganhar um Máximo de vezes por conversa. Sem limite (padrão), o agente usa quantas vezes precisar. Com limite, ao atingi-lo o agente é avisado de que a ação já foi feita e segue sem repeti-la. Útil para avisos à equipe e consultas externas.

Em Mover lead no funil, o limite olha o que a ação faria:

  • Levar o lead adiante é sempre permitido, mesmo depois do limite. Fechar o card em Ganho ou Perdido também é avanço.
  • O limite vale para mover para a etapa em que o lead já está, voltar etapa, reabrir um card fechado e mudar o lead de funil.
  • Só contam as vezes que ESTE agente moveu. Um agente novo na caixa não herda o limite do antigo.

💡 Dica: comece com 2 ou 3 ações essenciais (mover lead e chamar uma pessoa) e adicione as demais conforme o agente prova que decide bem. Um Quando usar claro vale mais que muitas ações.

⚠️ Atenção: o agente só faz o que as ações configuradas permitem, e os destinos (etapas, pessoas, caixas) vêm sempre da sua configuração, nunca do que o cliente pede na conversa. Uma ação apagada ou apontando para uma etapa que não existe mais aparece na caixa Antes de ativar e impede ativar o agente.

Veja também