"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
- 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.
- 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.
- 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. - 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}}). - Preencher campos do lead: atualiza os campos personalizados do contato com o que o agente descobriu (ex.: "Convênio: Unimed").
- Criar tarefa: abre uma tarefa para a equipe.
- Registrar venda: registra a venda como pendente, para a equipe confirmar o recebimento depois.
- Agendar na agenda: marca um horário real na Agenda, checando conflitos; se o horário estiver ocupado, o agente recebe alternativas livres.
- Consultar horários livres: devolve os próximos horários disponíveis de um profissional, para o agente oferecer opções concretas.
- Enviar template ao lead (fora da janela): manda um template aprovado da API oficial quando a janela de 24 horas já fechou.
- 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.
- 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.
- 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.
