A criação guiada monta um agente pronto para testar em poucos minutos: você conta quem é o negócio, o que o agente deve fazer e como ele deve falar, e o BotoZap escreve as instruções iniciais e liga as proteções. O agente nasce como rascunho e só começa a atender depois de quatro coisas: passar no diagnóstico, ser publicado, ter a operação ativada e ter o acesso liberado para os contatos.
Antes de começar
- Cadastrar uma chave de IA nova no passo Inteligência com a sua chave é só para Administrador, que é você se criou a conta. Se já houver uma chave validada, basta escolhê-la.
- Escolha o cliente no seletor do topo do painel.
- Tenha um número de WhatsApp ou uma conta do Instagram conectados e ativos neste cliente. Canais de teste, como os números de teste da Meta, não recebem atendimento automático e não aparecem na lista. Para conectar o Instagram, veja Conectar e atender pelo Instagram.
- Tenha em mãos a chave do seu provedor de IA. Se ainda não cadastrou, dá para cadastrar no meio da criação. Veja Provedores e chaves.
- Opcional: cadastre antes os materiais que o agente deve consultar (preços, perguntas frequentes) em Conhecimento.
Passo a passo
1. Abra a criação guiada
Em IA › Agentes, clique em Novo agente.
Dica: o botão Criar só com o nome cria um rascunho vazio, sem instruções nem proteções prontas. Use só se você já sabe configurar tudo no editor completo.
2. Preencha os seis passos
- Passo 1, O negócio. Nome do negócio, Nome do agente e, se quiser, O que o negócio faz. Sem essa descrição, o agente usa só o nome do negócio e nunca inventa o ramo.
- Passo 2, Objetivo. Escolha um: Tirar dúvidas e resolver solicitações, Atender interessados e registrar oportunidades ou Ajudar a marcar horários. O objetivo define as instruções iniciais e as ferramentas que o agente recebe. Em Orientações adicionais você escreve detalhes do seu jeito de trabalhar, como "sempre pergunte o bairro para verificar a área de entrega".
- Passo 3, Jeito de falar. Acolhedor, Profissional ou Direto.
- Passo 4, Regras da empresa. O que nenhum agente pode fazer, como "não oferecemos desconto acima de 10%". Essas regras valem para todos os agentes deste cliente que usam memória. Deixar em branco mantém as regras que já existem.
- Passo 5, Inteligência com a sua chave. Escolha a Credencial e o Modelo. Se ainda não tem chave, clique em Cadastrar nova chave, preencha Provedor, Nome da credencial e Chave da API e clique em Cadastrar e validar. Se o provedor aceitar, a chave já aparece na lista para você escolher. Se recusar, o motivo aparece logo abaixo e a chave fica salva como inválida: cole a chave certa e clique em Validar e substituir chave.
- Passo 6, Canal e materiais. Em Canal de atendimento, escolha o número de WhatsApp ou a conta do Instagram que o agente vai atender (ou Definir depois (fica em rascunho)). Cada opção começa pelo canal, WhatsApp · ou Instagram ·, seguido do nome. Em Fontes de conhecimento, marque os materiais que ele pode consultar.
No fim, o quadro O que o rascunho recebe mostra o que o agente poderá fazer e as proteções já ligadas: identificação como assistente virtual, transferência para a equipe, abertura de casos e ferramentas sensíveis desligadas.
Clique em Criar rascunho e diagnosticar, no topo da tela. Nada é publicado nem enviado a contatos nesta etapa.
3. Leia o diagnóstico
O agente abre com o painel Diagnóstico ao lado. Cada item recebe Ok, Atenção, Bloqueia ou Não verificado. Os itens marcados com Bloqueia ou Não verificado impedem a publicação. Cada pendência tem um botão que leva a onde ela se resolve, como Abrir Provedores e chaves ou Escolher credencial e modelo.
O mais comum na primeira vez é Elegibilidade para atender com Bloqueia: todo número começa em Somente números de teste, e sem nenhum número de teste a IA não responde a ninguém. Resolva ali mesmo: digite o seu celular com DDI e DDD em Número de teste em (nome do número) e clique em Cadastrar número de teste. Se o canal é uma conta do Instagram, o campo é Testador em (nome da conta): digite o @usuário do seu perfil, como @minhaloja.teste, e clique em Cadastrar testador. Se preferir abrir o número de outro jeito, use Abrir Acesso da IA. O passo a passo está em Liberar o acesso da IA.
Itens com Atenção não impedem a publicação, mas mostram algo que o agente não vai fazer como você espera: por exemplo, fontes de conhecimento escolhidas sem a ferramenta que as consulta, áudios que ele não vai conseguir ouvir ou o seu próprio número do WhatsApp na lista de teste. Com o agente Em operação, esses avisos também aparecem no topo da página, na faixa Atenção no atendimento, com o botão Ver no diagnóstico. O que cada um quer dizer está em Problemas comuns com a IA.
4. Teste antes de publicar
- No topo do agente, clique em Testar.
- Em Versão, deixe o rascunho selecionado.
- Escreva como se fosse um cliente em Mensagem de teste e clique em Testar mensagem.
- Continue a conversa ou clique em Nova conversa de teste para recomeçar.
O teste é de verdade: usa a sua chave e o modelo escolhido, consulta os materiais, a memória e as habilidades liberadas. Por isso ele pode gerar custo no seu provedor. Já as ações que mudariam dados ou mandariam mensagens (mover no funil, marcar horário, transferir) são só simuladas. Nenhum contato recebe nada.
Se algo não ficou bom, ajuste na aba Configuração. Ela é dividida em Comportamento, O que ele pode fazer, Quando responde, Conhecimento e Avançado. Ao mudar qualquer coisa, aparece a barra Rascunho com alterações: clique em Salvar rascunho antes de testar de novo.
5. Faça a prova de geração (recomendado)
No painel Diagnóstico, em Prova de geração real, clique em Fazer prova de geração e depois em Confirmar prova. A prova não é obrigatória para publicar, mas evita descobrir só com um cliente esperando que falta saldo na chave.
Por que isso existe: a chave aparecer como validada só quer dizer que o provedor a reconheceu. A prova faz uma resposta pequena de verdade, com a chave e o modelo deste agente, e confirma que há saldo e que o modelo funciona. Ela custa uma chamada mínima e aparece em Uso e orçamento. Quando der certo, o selo muda para Aprovada. Se você trocar a chave ou o modelo depois, a prova fica Desatualizada e precisa ser refeita.
6. Publique
- No topo do agente, clique em Publicar versão. O mesmo botão aparece no Diagnóstico, em Publicação.
- A janela mostra o que muda nesta versão e confere o diagnóstico do rascunho na hora (Conferindo o diagnóstico do rascunho…).
- Se houver pendência, a janela lista cada uma, com o botão que leva a onde ela se resolve, e Confirmar publicação fica desativado. O número de teste (ou o testador, no Instagram) pode ser cadastrado ali mesmo.
- Sem pendências, clique em Confirmar publicação.
Os itens em Avisos (não impedem a publicação) e a prova de geração não travam a publicação: leia e decida.
A publicação transforma o rascunho numa versão fixa. O status do agente passa a Publicado, aguardando ativação: ele ainda não atende.
Importante: o painel e a integração seguem a mesma regra. Se alguma verificação bloquear, a publicação é recusada, mesmo que alguém tente publicar por outro caminho.
7. Ative a operação
No Diagnóstico, escolha o modo e clique em Ativar operação. O modo já vem em Assistido (a equipe revisa antes de enviar), que é o recomendado para começar. Também dá para ativar pelo botão de status ao lado do nome do agente, em Ativar agente.
O status muda para Em operação. É nesse momento que o agente passa a ser o responsável pelos canais dele.
8. Libere o acesso (o passo que todo mundo esquece)
Importante: mesmo em operação, o agente só responde aos números de teste. Os seus contatos de verdade continuam sem resposta da IA até você abrir o acesso em Configurações › Acesso da IA. Isso é proposital: você testa com o seu celular sem risco de o agente falar com um cliente antes da hora.
Converse com o agente pelo celular que você cadastrou como teste (no Instagram, mande um direct do perfil cadastrado como testador). Quando estiver satisfeito, abra o acesso para os contatos autorizados ou para todos. Veja Liberar o acesso da IA.
Modo automático ou assistido
- Assistida: o agente prepara a resposta e ela fica esperando revisão. Na conversa aparece Resposta da IA aguardando aprovação, com os botões Aprovar e enviar e Rejeitar. Também dá para decidir na aba Execuções do agente. Veja Execuções e aprovação.
- Automática: o agente responde sozinho, dentro do que você permitiu.
Para trocar, clique no botão de status ao lado do nome do agente (por exemplo, Em operação · Assistida) e escolha Assistida ou Automática em Modo de operação. A troca vale na hora.
Pausar, retomar e arquivar
- Pausar agente, no mesmo botão de status, para de responder em todas as conversas dos canais do agente. Retomar agente volta a atender.
- Para parar a IA só numa conversa, use Pausar IA nesta conversa no menu da própria conversa.
- No menu Mais ações do agente ficam Duplicar agente (a cópia nasce como rascunho, sem canal) e Arquivar agente (para a operação e guarda o histórico). Um agente arquivado pode voltar com Restaurar agente; ele volta pausado.
Mudar um agente que já atende
- Na aba Configuração, faça as mudanças e clique em Salvar rascunho. A versão publicada continua atendendo normalmente.
- Teste o rascunho em Testar.
- Clique em Publicar versão. A janela mostra o que mudou em relação à versão em uso e confere o diagnóstico de novo.
Na aba Histórico você vê todas as versões. Comparar mostra as diferenças, Restaurar como rascunho traz uma versão antiga para editar e Restaurar e publicar volta a uma versão anterior na hora, desde que o diagnóstico não aponte pendência. Se apontar, a versão fica restaurada como rascunho e a mensagem diz o que resolver.
Opções para o contato tocar
O agente pode mandar escolhas prontas junto com a resposta, quando há poucas opções claras: confirmar um horário, escolher entre manhã e tarde, dizer o tipo de atendimento. Para isso, ligue Enviar opções para o contato tocar (botões ou lista) em O que ele pode fazer › Ferramentas e acesso ao CRM, no pacote Atender e responder, e publique a versão.
- No WhatsApp, as opções saem embaixo do último trecho da resposta: até 3 botões, ou uma lista com até 10 opções que abre por um botão.
- No Instagram, só botões (até 3), que aparecem como respostas rápidas no Direct. O Instagram não tem lista.
- Só com a janela de 24 horas aberta, como qualquer resposta do agente.
- O texto das opções passa pelas mesmas proteções da resposta, como a conferência de preços e descontos. Se algo for barrado, a resposta fica retida para aprovação em Execuções.
- Quando o contato toca numa opção, o toque aparece na conversa com ✓ Tocou · (opção), e o agente recebe a escolha como a próxima mensagem do contato.
- No Testar, a ferramenta aparece como Simulada: o teste mostra que o agente quis mandar opções, mas a resposta do teste é só o texto.
- O Operador não usa esta ferramenta, porque ele não fala com o contato.
Agente no Instagram
Um agente que atende uma conta do Instagram segue as regras do Direct:
- Responde só dentro de 24 horas desde a última mensagem do contato. No modo Assistida, aprove as respostas dentro desse prazo: passadas as 24 horas, a resposta não sai, e a conversa só volta a aceitar resposta quando o contato escrever de novo.
- Cada mensagem vai até 1.000 bytes. Acentos e emoji ocupam mais de um byte. Uma resposta maior sai dividida em várias mensagens, mesmo com Dividir respostas longas em mensagens desligado.
- Menção em story e publicação compartilhada contam como mensagem do contato. O agente sabe que o contato mencionou a conta num story ou compartilhou uma publicação, mas não vê o conteúdo do story.
Veja as regras completas do canal em Conectar e atender pelo Instagram.
Um agente no WhatsApp e no Instagram
O mesmo agente pode atender o número de WhatsApp e a conta do Instagram do cliente, com as mesmas instruções, materiais e ferramentas. Não é preciso criar uma cópia do agente para cada canal.
- Abra o agente e, na aba Configuração, em Quando responde, marque os canais em Canais de atendimento.
- Salve o rascunho e clique em Publicar versão. Se o agente já está Em operação, ele passa a atender os canais marcados na hora da publicação. Se não está, passa a atender quando você ativar ou retomar. Um agente que atende só como parte de um roteador segue o roteador.
- Libere o acesso de cada canal em Acesso da IA. Cada número e cada conta do Instagram têm o seu modo e a sua lista de teste.
- O diagnóstico mostra os itens de cada canal, com o nome dele. Um canal que ainda não está pronto, como o Instagram sem testador, aparece como aviso e não impede publicar enquanto outro canal estiver pronto.
- Se outro agente ou um roteador já atende um dos canais, esse canal fica de fora e os outros passam a ser atendidos. O diagnóstico e o aviso no topo do agente mostram qual canal ficou de fora. Para ligar esse canal depois, pause o outro agente ou desative o roteador (ou inclua este agente nele), e use Pausar agente e Retomar agente neste.
- Em cada conversa, o agente sabe por qual canal o contato escreveu e segue as regras daquele canal. No Instagram, valem as 24 horas e o limite de 1.000 bytes.
- Desmarcar um canal e publicar faz o agente deixar de atender nele. Se nenhum dos canais que ficaram marcados estiver livre, o agente continua no canal antigo, e o aviso Canal fora da versão mostra isso até você liberar um canal da versão e usar Pausar agente e Retomar agente.
Fotos, PDFs e vídeos que o contato manda
Na aba Configuração, em O que ele pode fazer, abra Ler arquivos recebidos. Ali você escolhe o que o agente lê: Interpretar imagens, Ler documentos PDF e Interpretar vídeos. Depois de mudar, salve o rascunho e publique.
- Ligado: a IA lê o arquivo e passa para o agente o que encontrou, marcado como leitura do arquivo. Assim o agente sabe que o contato mandou uma foto ou um documento, e não que escreveu aquele texto. A legenda da foto continua sendo a mensagem do contato.
- Desligado: o agente sabe que chegou uma imagem, um PDF ou um vídeo, mas não vê o conteúdo e não comenta o que há nele. Ele segue as suas instruções. Use assim quando você só quer receber o documento, sem o agente avaliar. Por exemplo, nas Instruções do agente: "Peça foto do documento de identidade, frente e verso. Quando chegar, agradeça e diga que a equipe vai conferir."
- Várias fotos de uma vez: o agente espera o contato terminar de mandar e responde uma vez só. Ele lê até 5 arquivos por resposta; se chegarem mais, sabe que eles chegaram, mas não vê o conteúdo dos mais antigos.
- Se a leitura não der certo (arquivo ilegível ou num formato que o agente não lê, como um documento do Word): o agente não tenta adivinhar o conteúdo. Ele responde do jeito dele e pode pedir para o contato reenviar ou passar a conversa para a equipe. Em IA › Casos aparece o alerta O agente não conseguiu ler um arquivo do contato.
O que acontece depois
- O agente responde às mensagens que chegam nos canais escolhidos, só para quem estiver liberado em Acesso da IA.
- Antes de responder, o agente espera uns 8 segundos para ver se o contato ainda vai mandar mais alguma coisa. Se o contato mandar várias mensagens ou fotos seguidas, o agente responde uma vez só, depois que ele parar, já lendo tudo o que chegou. Áudio e vídeo continuam tendo resposta própria.
- Quando o agente vai responder sozinho, o contato vê a mensagem como lida e o aviso "digitando…" no WhatsApp e no Instagram, até a resposta chegar.
- Ele segue o que está em Quando responde: palavras de acionamento, janela de atendimento e o que fazer fora do horário. Mensagens enviadas por você e mensagens de grupos são ignoradas.
- Quando alguém da equipe responde manualmente uma conversa, o agente se pausa nela. A conversa mostra IA pausada nesta conversa · a equipe responde e o botão Devolver à IA.
- Para conferir: na lista de IA › Agentes, o status deve ser Em operação. Cada resposta do agente fica registrada na aba Execuções dele.
Problemas comuns
O botão Criar rascunho e diagnosticar não habilita. Escolha uma Credencial e um Modelo no Passo 5. Sem eles o rascunho não é criado.
A lista de modelos mostra "Nenhum modelo compatível nesta chave". A chave não tem modelos de conversa disponíveis. Revalide a chave em Configurações › Provedores e chaves ou use a chave de outro provedor.
Meu número ou minha conta do Instagram não aparece em Canal de atendimento (ou em Canais de atendimento, na configuração do agente). Só aparecem canais ativos deste cliente. Canais inativos e de teste ficam de fora, porque não recebem atendimento automático. No Instagram, confira em Configurações › Canais se a conta está Conectado.
Confirmar publicação continua desativado. A janela de Publicar versão lista cada pendência com o botão para resolver. Os motivos mais comuns são a chave ainda não validada, o modelo fora do catálogo da chave e o canal sem nenhum número de teste ou testador. Se Publicar versão nem abre, salve as alterações do rascunho primeiro.
Ao ativar, aparece "O canal já possui outro agente ativo." Cada número ou conta do Instagram tem um só responsável. Pause o outro agente ou, se o canal usa um roteador, adicione este agente ao roteador. Veja Roteadores. Com vários canais marcados, esse aviso só aparece quando nenhum está livre. Se algum estiver, os ocupados ficam de fora e os livres passam a ser atendidos.
O agente está Em operação e não responde. Quase sempre é o acesso. Veja Problemas comuns.
Completar a base e refazer uma pergunta no teste
Em Testar agente, cada resposta tem Fontes quando há trechos consultados. Você vê o nome, o trecho e a busca feita, sem percentual. Consultar um trecho não garante que ele entrou na resposta. Se não houver trechos, isso sozinho não indica falta de informação.
- Clique em Completar a base para editar uma fonte ou adicionar texto sem sair do Studio. Também pode abrir Fontes › Abrir fonte na resposta.
- Confira o aviso de agentes publicados: editar uma fonte compartilhada afeta todos os agentes que a usam. Fontes importadas mantêm a atualização pela origem; texto lido de PDF escaneado precisa de revisão.
- Salve o conteúdo. Cancelar a criação não adiciona fonte nem muda o agente.
- Se a fonte for nova, clique em Vincular ao rascunho e salvar. Criar a fonte não autoriza sua consulta automaticamente. Não é preciso publicar para testar.
- Espere a versão salva terminar a preparação. Fonte inativa, falha, chave ausente ou revisão pendente bloqueiam o reteste; a versão antiga ainda disponível não libera o botão.
- Clique em Refazer última pergunta. A nova resposta aparece junto da anterior para comparar, e cada uma mantém seus próprios trechos. Cada nova resposta pode gerar custo no provedor. Nada é refeito automaticamente.
A sugestão Se faltou informação, adicione uma fonte aparece após um encaminhamento concluído ou uma busca concluída sem resultados. Pedir atendente também pode ter outros motivos: confira antes de mudar a base. Falha técnica continua aparecendo como falha.
A sessão fica preservada ao atualizar a página nesta aba. Trocar conta, cliente, agente ou versão, alterar a revisão do agente ou escolher Nova conversa de teste invalida o reteste pendente.
