Criar um agente de IA é o passo mais transformador que você dá no Syncro — passa de "atendimento manual" pra "atendimento automatizado 24/7". O wizard de criação tem 5 passos que cobrem desde a identidade visual (avatar, nome) até follow-up automático e tools avançadas. Esse artigo mostra cada passo em detalhe.
Pré-requisitos
Permissão de admin ou manager.
Plano com slot de agente IA disponível (Trial=0, Starter=1, Growth = 5, Scale = 999).
Para WhatsApp: pelo menos uma instância conectada.
Para Instagram: conta Business conectada.
Acessar o wizard
Acesse IA → Agentes no menu lateral (rota
/ia/agentes).Veja a lista de agentes existentes (se houver).
Clique em Criar Agente no canto superior direito.
O wizard de 5 passos abre em fullpage.
Passo 1 — Identidade e Avatar
Define a aparência do agente.
Avatar
Escolha um avatar da galeria pré-definida (gerada por IA).
Ou faça upload de imagem própria (PNG/JPG até 2MB).
O avatar aparece nas mensagens como ícone do agente no chat.
Nome do agente (obrigatório)
Ex: Camila, Victor, Bot de Vendas, Assistente Suporte.
Use placeholder como exemplo: "Ex: Ana, Victor, Bot de Vendas".
Esse nome aparece pro cliente nas mensagens.
Empresa
Nome da sua empresa (ex: Loja do João).
Usado no system prompt do agente pra ele saber em nome de quem responde.
Idioma
Português (Brasil) (default)
Inglês
Espanhol
Define o idioma das respostas do agente.
Passo 2 — Objetivo e Personalidade
Define o "para que serve" e o "como fala".
Objetivo (3 cards)
Vendas — "Captura leads e conduz negociações". Pra fluxos comerciais (qualificação, proposta, fechamento).
Suporte — "Resolve dúvidas e problemas". Pra atendimento técnico, FAQ, troubleshooting.
Geral — "Atendimento sem foco específico". Pra atendimento genérico ou misto.
Estilo de comunicação (3 cards)
Formal — "Profissional e estruturado". "Prezada Maria, tudo bem?...".
Normal — "Natural e cordial" (default). "Oi Maria! Tudo certo?...".
Informal — "Descontraído e amigável". "Eaê Maria, beleza?...".
Indústria
Campo livre pra contextualizar (ex: Imobiliária, Saúde, E-commerce, Educação).
Ajuda o agente a usar vocabulário da área.
Personalidade (descrição)
Texto livre descrevendo a "persona" do agente.
Exemplo: "Você é Ana, uma assistente virtual da Loja do João. É proativa, atenciosa e adora ajudar clientes a encontrar o produto perfeito."
Use isso pra dar alma ao agente — quanto melhor a descrição, mais coerente as respostas.
Comportamento esperado
Regras específicas que o agente deve seguir.
Exemplo: "Sempre cumprimente pelo nome. Nunca prometa prazos sem antes confirmar com o atendente humano. Se o cliente pedir desconto acima de 10%, transfira pra humano."
Coloca limites operacionais.
Passo 3 — Canal e Atribuição
Onde o agente vai atender.
Canal
WhatsApp — atende DMs do WhatsApp.
Instagram — atende DMs do Instagram.
Web Chat — atende widget do site.
Instâncias de WhatsApp
Se canal = WhatsApp, aparecem checkboxes das instâncias conectadas. Marque quais números esse agente atende:
Pode marcar uma ou várias (mesmo agente em múltiplos números).
Pode marcar nenhuma se quer só responder via auto-atribuição de departamento.
Toggles
Agente ativo — "Quando ativado, o agente responderá automaticamente". Liga/desliga o agente sem deletar.
Auto-atribuir para humano — transfere automaticamente após X mensagens sem resolver.
Passo 4 — Conhecimento e Ferramentas
Onde a magia acontece.
Base de Conhecimento
Textarea com placeholder enorme contendo exemplos. Aqui você descreve:
Empresa: nome, missão, valores.
Produtos / serviços: lista com preços, características, diferenciais.
Políticas: troca, devolução, formas de pagamento, prazos.
FAQs: perguntas comuns + respostas.
Limites operacionais: o que o agente PODE e NÃO PODE fazer.
💡 Dica: você pode também subir arquivos (PDF, Word, TXT, imagens) que viram parte da base de conhecimento via RAG. Veja Base de conhecimento (RAG).
Etapas da Conversa
Liste etapas que o agente deve seguir:
Apresentação — "Cumprimentar e identificar o cliente"
Qualificação — "Entender necessidade e perfil"
Apresentação de solução — "Sugerir produto/serviço adequado"
Fechamento — "Confirmar interesse e agendar próximos passos"
Cada etapa tem nome + descrição (placeholder "Ex: Apresentação" e "Descrição...").
Permite o agente se orientar sobre em que momento da conversa está.
Ferramentas (5 toggles)
Habilite as tools que o agente pode executar:
Mover leads entre etapas — agente avança lead no funil quando qualifica.
Adicionar tags — agente categoriza leads automaticamente.
Notificar intenção de compra — alerta equipe quando detecta interesse alto.
Agendar reuniões — cria evento no Google Calendar.
Catálogo de produtos — agente consulta e sugere produtos.
Veja Tools do agente pra detalhes técnicos.
Passo 5 — Follow-up e Avançado
Follow-up automático
Mensagens automáticas se o cliente para de responder.
Follow-up automático (toggle) — ativar/desativar.
Atraso (minutos): tempo entre last msg do cliente e disparo do follow-up. Min 5, max 1440 (24h). Default 40.
Máximo de tentativas: quantos follow-ups consecutivos. Min 1, max 10. Default 3.
Começar em (hora): hora mínima do dia pra disparar follow-up. Default 8h.
Encerrar em (hora): hora máxima. Default 18h.
Veja Follow-up smart/template/off pras estratégias.
Configurações avançadas
Máximo de caracteres por mensagem: tamanho da resposta. Min 50, max 4000. Default 500. Mensagens longas são quebradas em múltiplas bolhas WhatsApp.
Atraso de resposta (segundos): tempo entre cliente terminar de digitar e agente responder. Default 2. Simula tempo humano.
Tempo máx. para digitar (segundos): quanto tempo o agente "espera" o cliente terminar antes de processar. Default 0.
Finalizar
Após o último passo, clique em Criar Agente.
Sistema:
Salva o Agente no .
Cria embeddings da base de conhecimento.
Aparece Agente criado! e você é redirecionado pra lista.
O agente aparece como card na página principal.
Editar agente (sem wizard)
Após criado, edição não usa wizard — vai pro form completo:
Clique no agente na lista.
Acessa
/ia/agentes/{id}/editar.Form único com todas as seções (não dividido em passos).
Edite e salve.
Sincronização com Agno automática.
Testar o agente
Antes de ativar pra clientes reais, teste o agente:
Na página de edição, há chat de teste lateral.
Digite mensagens como cliente.
O agente responde usando configuração atual (mesmo que ainda não salva).
Ajuste a base de conhecimento, persona, tools até ficar bom.
Só depois ative em clientes reais.
Ativar em conversas
Após criar e testar, vincule o agente a conversas:
Forma 1 — Departamento padrão
Em Configurações → Departamentos, edite um departamento.
Em Agente IA Padrão, selecione esse agente.
Conversas que entram nesse departamento ganham o agente automaticamente.
Forma 2 — Atribuição manual
Em uma conversa do
/chats, painel lateral.Em Agente IA, selecione o agente.
IA passa a responder.
Forma 3 — Auto-atribuição da instância
Algumas configurações de instância WhatsApp permitem agente padrão. Veja Gerenciar múltiplos números.
Limites de plano
Plano | Max agentes IA |
|---|---|
Trial | 0 |
Starter | 1 |
Growth | 2 |
Scale | 5 |
Acima do limite: erro "Limite atingido". Faça upgrade.
Próximos passos
Pra subir arquivos de conhecimento, veja Base de conhecimento.
Pra entender as ações que o agente pode executar, veja Tools.
Pra configurar voz, veja Voz com ElevenLabs.