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 conectado e ativo neste cliente. Números de teste da Meta não recebem atendimento automático e não aparecem na lista.
- 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 que o agente vai atender (ou Definir depois (fica em rascunho)). 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 preferir abrir o número de outro jeito, use Abrir Acesso da IA. O passo a passo está em Liberar o acesso da 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 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 pelo número.
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. 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 do número. 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 número) 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.
O que acontece depois
- O agente responde às mensagens que chegam no número escolhido, só para quem estiver liberado em Acesso da IA.
- 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 não aparece em Canal de atendimento. Só aparecem números ativos deste cliente. Números inativos e números de teste da Meta ficam de fora, porque não recebem atendimento automático.
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 número sem nenhum número de teste. 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 tem um só responsável. Pause o outro agente ou, se o número usa um roteador, adicione este agente ao roteador. Veja Roteadores.
O agente está Em operação e não responde. Quase sempre é o acesso. Veja Problemas comuns.