Um número de WhatsApp ou uma conta do Instagram costuma receber assuntos muito diferentes: gente querendo comprar, gente com problema no pedido, gente querendo marcar horário. Em vez de um único agente que sabe um pouco de tudo, você pode ter um agente para cada assunto. O roteador fica na frente deles: lê cada mensagem, entende a intenção e passa a conversa para o agente certo.
Tudo fica em IA › Roteadores. O roteador funciona igual nos dois canais.
Quando usar
- Use um roteador quando o mesmo canal precisa de agentes com instruções, ferramentas ou conhecimento diferentes.
- Se um agente dá conta de tudo, não precisa de roteador. Cada número ou conta do Instagram tem ou um agente respondendo direto ou um roteador ativo, nunca os dois.
- Um roteador atende um canal só. Para usar roteador no WhatsApp e no Instagram, crie um para cada canal, cada um com os agentes publicados naquele canal.
Antes de começar
- Escolha o cliente no seletor do topo do painel.
- Cada agente que vai entrar no roteador precisa estar publicado com o mesmo canal em Canal de atendimento, e com uma chave de IA válida. Veja Criar seu primeiro agente.
- O roteador usa uma chave de IA sua para classificar as mensagens. Cadastre e valide a chave em Configurações › Provedores e chaves. Veja Provedores e chaves.
- O Acesso da IA continua valendo: o BotoZap confere se o contato pode ser atendido pela IA antes de chamar o roteador. A página do roteador mostra como está o acesso daquele canal.
Passo a passo: criar o roteador
- Em IA › Roteadores, clique em Criar roteador.
- Preencha:
- Nome: por exemplo, "Recepção da loja".
- Canal: o número de WhatsApp ou a conta do Instagram que o roteador vai atender. Cada opção começa por WhatsApp · ou Instagram ·.
- Credencial do classificador: a chave própria validada que ele usa para ler as mensagens.
- Modelo: escolha na lista sugerida ou digite o modelo do provedor. Um modelo rápido e barato costuma bastar para classificar.
- Confiança mínima (0 a 1): o quanto o roteador precisa ter certeza para escolher uma intenção. O padrão é 0,6.
- Deixe marcada a opção Manter o agente atual quando a classificação não indicar uma mudança confiável de intenção, a não ser que tenha um motivo para desligar. Ela evita que a conversa fique pulando de agente a cada mensagem.
- Em Agentes e intenções, escolha um agente em Selecione um agente para adicionar e clique em Adicionar agente. Para cada agente, preencha:
- Nome da intenção: curto e claro, como "vendas" ou "suporte".
- Quando este agente deve atender: descreva o assunto em uma ou duas frases.
- Exemplos de mensagens (um por linha): frases reais que os clientes mandam sobre esse assunto.
- Agente fixo: fica com a conversa até ela ser fechada: marque quando, depois de escolhido, este agente deve seguir com a conversa até o fim, sem trocar de agente. A linha do agente mostra Fixo. Não marque o agente de fallback: toda conversa ficaria presa nele até ser fechada.
- Em Agente de fallback, escolha quem atende quando nenhuma intenção se encaixa. Ele precisa ser um dos agentes da lista.
- Clique em Salvar configuração.
O roteador é criado Inativo. Nada muda no atendimento até você ativar. Você pode ter até 30 agentes num roteador.
Dica: descrições e exemplos bem diferentes entre si são o que faz o roteador acertar. Se dois agentes têm descrições parecidas, ele vai hesitar entre os dois.
Passo a passo: testar
Antes de ativar, veja como o roteador classifica mensagens reais.
- Abra o roteador e vá à aba Teste de roteamento.
- Em Mensagem, escreva uma mensagem como um cliente escreveria. Para simular o toque num botão do WhatsApp, escreva como o roteador recebe:
Tocou na opção "Comercial". - Para testar uma resposta curta, como "Sim", cole em Última mensagem enviada ao contato (opcional) o que tinha sido perguntado. Na conversa de verdade, o roteador lê essa mensagem sozinho.
- Se quiser simular uma conversa que já estava com um agente, escolha-o em Simular conversa já atendida por.
- Clique em Classificar mensagem.
O resultado mostra o agente escolhido, o que aconteceu (por exemplo Intenção identificada, Agente anterior mantido ou Fallback selecionado), a intenção e a confiança.
O teste usa o classificador de verdade, com a sua chave, e por isso gasta um pouco de uso dela. Ele não envia mensagem a ninguém e não muda o agente de nenhuma conversa.
Importante: a aba de teste só funciona com tudo salvo. Com alterações pendentes, aparece Salve a configuração antes de testar.
Passo a passo: ativar os agentes do roteador
O roteador só passa conversas para agentes que estão em operação. Um agente publicado, mas pausado, aparece na lista como Publicado e pausado. Para ativá-lo dentro do roteador:
- Na lista Agentes e intenções, abra o menu ··· ao lado do agente e escolha:
- Ativar membro em modo assistido: a equipe revisa as ações e as respostas antes do envio.
- Ativar membro automático: o agente age e responde sozinho.
- Clique em Confirmar ativação do membro.
Ativar o membro não entrega o canal a ele: o canal continua com o roteador. Essas opções só aparecem para agentes publicados e pausados, e com a configuração salva.
Passo a passo: ativar o roteador
- Clique em Ativar roteador.
- Leia a confirmação:
- Se o canal estava livre, clique em Confirmar alteração.
- Se um agente já responde direto por esse canal, a tela avisa quem é. Clique em Confirmar troca do responsável pelo canal. O agente perde o vínculo direto com o canal, e o atendimento passa ao roteador e aos agentes da lista dele.
- Se outro roteador já cuida do canal, desative o outro primeiro.
A partir daí, as mensagens novas desse canal passam pelo roteador.
Como o roteador escolhe
A cada mensagem do contato:
- O roteador compara a mensagem com as intenções e dá uma nota de confiança. Ele lê também a última mensagem enviada ao contato, para entender a que ele responde: um "Sim" depois de "Quer que eu te mostre os planos?" fica com o assunto da pergunta.
- Se a confiança atinge o mínimo, a conversa vai para o agente daquela intenção.
- Se a conversa já estava com um agente e a opção de manter o agente atual está ligada, ele só troca quando identifica outra intenção com confiança suficiente. Assim, um "ok, obrigado" não faz a conversa mudar de agente. Se o agente que atende é fixo, o roteador nem classifica a mensagem e não troca mais, mesmo que o contato fale de outro assunto, até a conversa ser fechada e o contato voltar a escrever. Isso vale enquanto o agente fixo estiver em operação: pausado, sem versão publicada ou fora do roteador, ele perde a conversa, e o roteador escolhe de novo.
- O toque num botão ou numa opção de lista conta como mensagem: o roteador lê a opção tocada, como "Comercial", e a classifica como qualquer outra mensagem. Para um menu levar o contato ao agente certo, use o nome de cada opção nos Exemplos de mensagens da intenção correspondente: com a opção de manter o agente atual ligada, a troca de agente só acontece com confiança de 0,85 ou mais.
- Áudio, imagem (mesmo com legenda) e outras mensagens que não são texto nem toque (e, no Instagram, uma menção em story ou uma publicação compartilhada) não são classificadas: ficam com o agente atual ou vão para o fallback.
Quando a equipe fecha a conversa e o contato volta a escrever, o roteador começa do zero: classifica a mensagem como se fosse a primeira, sem manter o agente anterior. O agente escolhido também lê só o que veio depois do fechamento. Veja Fechar e reabrir.
Quando nenhuma intenção se encaixa, ou quando a classificação falha, uma conversa que já estava com um agente continua com ele (se a opção de manter o agente atual estiver ligada). Nos demais casos:
- A conversa vai para o Agente de fallback.
- Se ele não estiver disponível, fica com o agente que já atendia a conversa.
- Se não houver nenhum dos dois, a mensagem fica sem resposta e o BotoZap gera um alerta para a equipe. Não existe um agente genérico de reserva.
Menu de entrada: o contato escolhe o assunto
Para o contato escolher com quem falar, como "Comercial, Financeiro ou Suporte", junte um agente de pré-atendimento, os botões e o agente fixo:
- Crie o agente de pré-atendimento e ligue nele a ferramenta Enviar opções para o contato tocar (botões ou lista), como em Opções para o contato tocar, e publique a versão. No prompt, peça para ele começar perguntando com quem o contato quer falar, com as opções em botões, e para passar para a equipe o que for financeiro ou suporte.
- No roteador, coloque o pré-atendimento como membro, com uma intenção para saudações, financeiro e suporte (por exemplo, "pre_atendimento"), e escolha-o como Agente de fallback.
- Coloque o agente comercial como membro, com a intenção "comercial", "Comercial" nos Exemplos de mensagens e Agente fixo marcado.
Quem toca em Comercial vai para o agente comercial e fica com ele até a equipe fechar a conversa. Quando o contato volta a escrever depois disso, o roteador começa do zero: um "oi" vai para o pré-atendimento, que manda o menu de novo, e um pedido claro, como "quero contratar", vai direto para o comercial.
O que acontece depois
- Salvar uma alteração num roteador ativo pede confirmação em Atualizar roteador em operação: a nova configuração vale para as próximas mensagens.
- Para trocar o Canal, desative o roteador antes.
- Desativar roteador tira o roteador do canal, mas não coloca nenhum agente no lugar. Até você ativar um agente direto no canal, a IA não responde ali.
- Arquivar roteador, no menu ··· ao lado de Salvar configuração, desativa e tira o roteador da lista. O histórico de classificações é mantido.
- Em IA › Evolução, o quadro Decisões de roteamento mostra quantas decisões houve, quantas ficaram Sem agente adequado e quantas falharam. Veja Aprendizado e evolução.
Problemas comuns
O botão "Ativar roteador" está apagado. Há alterações não salvas. Clique em Salvar configuração primeiro.
Não aparecem as opções de ativar o agente no roteador. Elas só aparecem para agentes publicados e pausados, e com a configuração salva. Se o agente mostra Sem versão publicada, publique-o com o mesmo canal em Canal de atendimento.
Deu erro ao ativar ou salvar, com uma mensagem genérica. As causas mais comuns são: um agente da lista sem versão publicada para esse canal, arquivado ou com a chave inválida; a chave do classificador inválida; ou outro roteador já ativo no canal. Confira cada agente em IA › Agentes e a chave em Configurações › Provedores e chaves.
As conversas vão quase sempre para o fallback. A confiança mínima pode estar alta demais para as suas descrições. Use o Teste de roteamento com mensagens reais, melhore as descrições e os exemplos, e só então considere baixar a Confiança mínima.
A conversa troca de agente no meio do atendimento. Isso acontece quando o contato muda de assunto com clareza. Se estiver trocando sem motivo, confira se Manter o agente atual quando a classificação não indicar uma mudança confiável de intenção está marcada. Para um agente não perder a conversa no meio por mudança de assunto, marque Agente fixo nele.
Uma mensagem ficou sem resposta. Nenhuma intenção se encaixou e não havia fallback nem agente anterior disponível. Configure um Agente de fallback que esteja ativo.
