Criar um agente de IA

Um agente de IA atende sozinho as conversas do WhatsApp e do Instagram, seguindo as instruções que você escreve e o que está no Conhecimento. Use para responder fora do expediente, tirar dúvidas que se repetem ou qualificar quem chega, passando para uma pessoa o que precisa dela.

Antes de começar

• Plano: o módulo de agentes faz parte do Growth e do Scale. O Starter não inclui. Cada organização pode ter até 10 agentes ativos ao mesmo tempo.
• Permissão: criar, editar, testar, publicar e pausar exige Gerenciar agentes de IA. Só com Consultar agentes de IA, a pessoa vê os agentes e o histórico.
• Um canal conectado: pelo menos um número de WhatsApp conectado por QR Code ou uma conta do Instagram. O agente não atende números da API Oficial do WhatsApp nem o Messenger. Veja Conectar o WhatsApp e Conectar o Instagram.
• Conhecimento preenchido: o agente só afirma o que está nas instruções e no Conhecimento.
• Saldo de créditos de IA: cada mensagem que o agente envia consome crédito. Veja créditos de IA.

Passo a passo

1. No menu, abra Agentes de IA e clique em Novo Agente.
2. Em Descreva, conte com as suas palavras o que o agente faz e quando chama a equipe (de 20 a 500 caracteres) e clique em Gerar rascunho com IA. A IA preenche os passos seguintes e você revisa. Se preferir, escolha um modelo (Chatbot inteligente, Qualificador de leads, Suporte ao cliente ou Vendas consultivas) ou use Configurar do zero.
3. Em Identidade, preencha o Nome interno, que só a equipe vê (de 3 a 100 caracteres), e a Área de atuação: Vendas ou Atendimento.
4. Em Persona, defina o que o cliente vê: Nome público, Cargo, Tom de voz (Amigável, Profissional, Casual, Empático, Entusiasmado, Formal ou Personalizado), Formalidade, Emojis e Estilo de escrita.
5. Em Instruções, escreva o que ele deve fazer, em linguagem natural (até 6.000 caracteres). Memória, Mensagem de abertura, Quando não souber e Regras de ação são opcionais, e dá para completar depois.
6. Em Canais e comportamento, marque os números e contas em que ele responde, escolha até onde ele vai e quando entra na conversa (detalhes abaixo).
7. Em Revisão, confira o resumo e clique em Publicar agente. Para guardar sem ativar, use Salvar rascunho.
8. Clique em Abrir o agente, depois em Testar Agente, e escreva como se fosse um cliente. O Simulador usa o agente como está configurado, sem mandar nada a ninguém.

Até onde ele vai

Em Atendimento, você escolhe uma destas opções:

Sem passo a passo que valha para o agente, Resolver funciona como Tirar dúvidas.

Em Vendas, em Como ele vende, você escolhe o Método de venda (o da empresa ou um pronto), até que etapa ele conduz (Conduz até) e Como passa para a equipe: Transfere ou Marca reunião. Sem método, o agente só qualifica e passa quando o cliente parece pronto.

Reunião marcada pelo agente vira uma tarefa do tipo Reunião para a pessoa responsável, em horário livre dentro do horário comercial. Não há link de vídeo nem convite por e-mail.

Quando ele entra na conversa

• Sempre ativo atende a qualquer hora. Fora do horário comercial atende só depois do expediente definido para a organização (veja Horário e SLA).
• Na hora: o agente assume toda conversa sem atendente. Depois de um tempo: se ninguém da equipe assumir em 5 segundos a 1 hora (você define), ele entra. Só quando transferido: ele fica parado até alguém passar a conversa para ele.

Como funciona

• Transferência: o agente decide para quem passar pelas suas instruções. Escreva, por exemplo, "Orçamento de painel vai para a Ana. Reclamação vai para a equipe Suporte". Para uma pessoa, a conversa vai para a fila dela; para uma equipe, para a fila da equipe. Sem indicação, segue o dono do cliente, depois a equipe do canal e, por último, a fila geral. Depois de transferir, o agente não responde mais até alguém assumir ou concluir.
• Limites por agente: em Avançado, Máx. mensagens por conversa/dia (de 5 a 200, padrão 50) e Créditos por dia (padrão 5.000, até 100.000, ou Ilimitado). Ao atingir o limite, o agente para até o dia seguinte. Prioridade (0 a 100) desempata quando mais de um agente pode assumir a mesma conversa.
• Ferramentas: na aba Ferramentas você escolhe, fonte por fonte, o que o agente pode consultar e fazer: as do SocialSell, as das integrações conectadas e as de servidores MCP que a organização conectar. Consultas só leem; ações mudam algo no sistema e começam desligadas nas integrações. Transferir para a equipe está sempre ligado.
• Acompanhar: na lista, cada agente mostra o estado (Ativo, Pausado ou Rascunho) e tem Histórico, Desempenho, Pausar ou Ativar, Duplicar e Excluir. No histórico, você avalia cada atendimento de 1 a 5 estrelas e aponta o problema, como Informação errada.
• Parada total: em Agentes de IA › Mais ações › Ativar parada total (confirmando com a palavra pedida), ou em Configurações › IA, toda a IA da organização para na hora. Ao retomar, os agentes que estavam ativos voltam.

Dúvidas comuns

O agente não respondeu uma conversa. Por quê?

Confira, nesta ordem: o agente está Ativo; a parada total está desligada; o número ou a conta daquela conversa está marcado em Canais e Ativação; o canal não é a API Oficial do WhatsApp; a conversa não está com o atendimento automático desativado (veja IA na conversa); o horário bate com Quando atuar; há saldo e o limite diário não foi atingido.

Gerar o rascunho e usar o Simulador gastam créditos?

No código atual, nenhum dos dois debita do saldo. Só as mensagens de atendimentos reais consomem.

Dá para ter vários agentes?

Sim, até 10 ativos. Para tirar uma conversa de um agente, use Conversas que este agente não atende, em Canais e Ativação.