Agentes de IA #

Um Agente de IA é o cérebro por trás do seu bot — sua personalidade, o que ele sabe, seu idioma principal e como ele se comporta em uma conversa. Onde uma campanha costumava agrupar “quem é o bot” com “para quem ele envia mensagens e quando”, um Agente contém apenas a parte de “quem é o bot” — assim, você o cria uma vez e o reutiliza em qualquer lugar. As campanhas foram descontinuadas; um Agente mais uma Transmissão é o que as substituiu.

Pense em um Agente como o membro da equipe que você está treinando: dê a ele um nome, uma personalidade, conhecimento do produto e um conjunto de ferramentas, e ele poderá ser colocado para trabalhar respondendo em qualquer canal e em qualquer Transmissão que aponte para ele.

Para onde foram seus antigos bots de campanha #

O bot de cada campanha agora é um Agente — nada foi perdido e você não precisou fazer nada. Se você tinha campanhas com um bot configurado, cada uma delas tem um Agente correspondente contendo exatamente as mesmas instruções, FAQs e configurações, e esse Agente é onde o bot é editado a partir de agora.

O Agente é a única fonte da verdade. Altere suas instruções e a mudança chega a cada conversa que ele responde, em cada canal, imediatamente — não há nada para copiar em um segundo lugar.

Imagine isto: você atualiza as instruções do seu Agente para mencionar uma nova política de devolução. Cada conversa que esse Agente gerencia recebe a atualização imediatamente.

Links de campanhas antigas ainda funcionam: abrir um leva você ao editor do Agente daquela campanha. Veja Campanhas foram movidas para Transmissões e Agentes.

Onde Encontrar Agentes de IA #

No menu principal no lado esquerdo da tela, em AI Studio, clique em AI Agents. (Em um celular, o menu fica oculto — toque primeiro no ícone de menu ☰ no canto superior e, em seguida, toque em AI Agents.)

A página de Agentes de IA lista todos os Agentes em sua conta, incluindo um nomeado automaticamente após cada um dos bots das suas campanhas antigas, juntamente com um painel Quem responde a novas conversas acima da lista — um resumo de uma linha, ou uma linha por canal conectado, mostrando qual Agente atende um contato totalmente novo nesse canal. Veja Pontos de Entrada → Quem responde a novas conversas para saber como esse painel funciona e o que ele significa para o seu roteamento ao vivo hoje.

O que compõe um Agente #

Um Agente agrupa tudo o que molda como o bot pensa e fala:

Um Agente não mantém uma lista de contatos, uma mensagem de abertura, um canal ou um agendamento de envio — é para isso que serve uma Broadcast. O agendamento de compromissos é definido no Agente, na sua aba Habilidades de IA — veja Sistema de Agendamento.

Criando um Agente #

Clique em Novo agente na parte superior da página Agentes de IA e escolha um ponto de partida — a caixa de diálogo oferece até três:

1. Criar a partir do seu site (a opção padrão e a maneira mais rápida de obter um agente funcional): digite o endereço do seu site e nós criaremos o agente para você. Clique em Encontrar páginas para ver uma lista das páginas do seu site e marque as úteis — algumas páginas relevantes já vêm pré-selecionadas para você — ou pule essa etapa e leremos o endereço que você digitou. Você também pode adicionar documentos (listas de preços, folhetos, perguntas frequentes) para o agente aprender. Dê um nome a ele — um é sugerido com base no seu site —, verifique o idioma e clique em Criar agente.

   A caixa de diálogo permanece na tela enquanto seu agente é criado: ela mostra o que está acontecendo (lendo seu site e, em seguida, escrevendo as instruções) e geralmente leva um ou dois minutos. Quando terminar, você será direcionado ao editor do agente com as instruções e o conhecimento já preenchidos — revise-os, faça os ajustes que desejar e pronto. Não quer esperar? Clique em Continuar em segundo plano e continue com outras tarefas — o agente exibirá um selo Criando… em sua lista até que esteja pronto, e abrirá assim que a escrita for concluída.

   A criação do agente leva um ou dois minutos, mas a importação de cada página que você marcou pode levar mais tempo. Quando você marca mais de 25 páginas ou arquivos, a caixa de diálogo informa isso com uma estimativa de tempo. Você pode abrir e testar o agente antes que a importação seja concluída: ele responde com base nas páginas que já foram incluídas, e o restante é adicionado à medida que cada página termina.

   Se uma compilação não puder ser concluída, a caixa de diálogo informa o motivo em termos simples, em vez de deixar você observando um ícone de carregamento — o site não pôde ser lido, não havia texto suficiente nas páginas para criar um agente ou a conta ficou sem créditos. Corrija o que for indicado e inicie a compilação novamente.

2. Começar do zero: dê um nome ao agente e escolha seu idioma principal, depois clique em Criar agente. Você será direcionado diretamente ao editor dele para preencher as instruções e o conhecimento por conta própria.

Não há escolha de entrada/saída aqui — isso não é uma etapa ausente. As campanhas clássicas faziam você escolher Entrada, Saída ou Combinado logo de início. Um Agente não faz isso, porque essa divisão foi removida do próprio Agente: um Agente é o lado que responde às pessoas que enviam mensagens para você, e entrar em contato primeiro é o que uma Transmissão faz. Portanto, a antiga configuração “Combinado” agora é um Agente mais uma Transmissão que o escolhe como manipulador de resposta — você cria o Agente aqui e, em seguida, cria a Transmissão quando estiver pronto para enviar.

Inglês ou Inglês (Reino Unido). Ambos estão na lista de idiomas. Inglês utiliza a grafia americana. Inglês (Reino Unido) utiliza a grafia e o vocabulário britânicos (colour, organise, mobile, flat), para empresas cujos clientes não devem ouvir uma voz americana. Como qualquer idioma principal, ele não bloqueia o agente: um contato que escreve em outro idioma ainda recebe uma resposta em seu próprio idioma. Qualquer coisa que você escrever sobre como o agente deve falar (tom, palavras a usar ou evitar, um estilo regional) deve ser colocado em Persona e Objetivo ou Comportamento da Conversa na aba Instruções de IA, e o agente seguirá isso além do idioma que você escolheu.

Idiomas mistos escritos com letras latinas. Para contatos que escrevem seu próprio idioma usando letras inglesas misturadas com inglês, escolha a opção correspondente: Singlish (cingalês + inglês), Hinglish (hindi + inglês), Taglish (filipino + inglês), Roman Urdu (urdu + inglês), Banglish (bengali + inglês), Tanglish (tâmil + inglês), Manglish (malaio + inglês) ou Arabizi (árabe em letras latinas). O agente então responde da maneira como esses contatos escrevem, por exemplo “June 26 wala room rates oya select karana room category eka anuwa wenas wenawa”, sempre em letras latinas e nunca na escrita nativa, e segue a mistura própria de cada contato. Um contato que escreve em inglês simples ainda receberá inglês simples. Para todas as opções, exceto Taglish, os resumos de chat, alertas e FAQs gerados são escritos em inglês.

Hindi e Marathi. Ambos estão na lista de idiomas e são escritos no alfabeto Devanagari (हिन्दी, मराठी). Escolha Marathi quando seus contatos escreverem em Marathi, para que o agente abra e preencha as lacunas em Marathi em vez de Hindi. Para contatos que digitam Hindi usando letras latinas misturadas com inglês, escolha Hinglish (Hindi + Inglês).

Filipino, Taglish e Cebuano. Todos os três estão na lista de idiomas. Filipino escreve em filipino formal; Taglish (Filipino + Inglês) escreve a mistura cotidiana de tagalo e inglês que as pessoas realmente digitam em chats. Se seus clientes enviarem mensagens em Taglish, escolha Taglish — um agente configurado para filipino responderá corretamente, mas em um registro mais formal do que o da conversa. Cebuano (Bisaya) é para clientes em Cebu, no restante das Visayas e em grande parte de Mindanao que escrevem em bisaya em vez de tagalo — escolha-o e o agente responderá em cebuano cotidiano em vez de mudar para o filipino.

Procurando por “Extrair de uma campanha”? Isso não existe mais — não restaram campanhas clássicas para extrair. Cada bot de campanha tornou-se um Agente automaticamente.

Editando um Agente #

Abra qualquer Agente da lista de Agentes de IA para acessar seu editor. As etapas seguem pela esquerda, e cada uma é uma parada curta — aqui está o tour em ordem. Um agente que já está ativo abre em sua Visão Geral (seus números); um agente pausado ou novo abre em Instruções de IA, porque é lá que seu trabalho acontece.

1. Visão Geral — o painel do próprio agente: respostas da IA, respostas e taxa de resposta, novos contatos, agendamentos marcados e créditos usados nos últimos 7, 30 ou 90 dias, cada um com uma pequena linha de tendência e, onde houver uma linha de base, a mudança em relação ao período anterior; seu scorecard de prontidão completo com a correção para cada lacuna; os canais nos quais ele responde, seu tempo médio de primeira resposta e a parcela de suas mensagens respondidas pela IA em vez da sua equipe; depois, os mesmos painéis de Resultados da conversa, IA vs humano e Atividade que o Painel mostra, limitados a este agente. Veja Visão geral do Agente.

2. Instruções de IA — o idioma principal, persona, manual, ritmo de resposta, limites de mensagem e configurações de modelo (Velocidade de IA/Qualidade de IA), tudo em uma única aba. É aqui que reside a maior parte da personalidade do seu agente — veja Configuração do Bot de IA para cada campo.

Modo de teste é o primeiro painel nesta aba: ative-o e a IA responderá apenas aos contatos em sua lista de teste, para que você possa experimentar o agente em um canal real com segurança. Veja Modo de teste.

Idioma principal fica no topo desta aba. Altere-o e ele será salvo imediatamente — você não precisa publicá-lo como o restante da aba, e ele entra em vigor em suas conversas ao vivo imediatamente. Ele altera o idioma em que seu agente escreve a partir de agora; tudo o que já foi escrito (suas instruções, seus FAQs) permanece no idioma em que foi escrito, então retraduza-os você mesmo se quiser que todo o agente mude.

3. Horário de Funcionamento — quando o agente tem permissão para responder. Ele começa como Ativo 24/7; desative isso para definir uma agenda semanal. Fora dos horários que você escolher, o agente permanece em silêncio, e tudo o que chegar será respondido automaticamente no momento em que a próxima janela abrir — esses chats aguardam sob o filtro Fora do horário em Chats até lá. Veja Agenda de Disponibilidade do Bot.

4. Mídia — as imagens, vídeos, notas de voz e documentos PDF que o agente pode enviar durante a conversa. A aba abre na mídia deste agente e funciona da mesma forma em um agente novo ou em um já estabelecido: envie um arquivo aqui e ele pertencerá a este agente imediatamente, sem nada para anexar antes. Veja Biblioteca de Mídia.

5. FAQs e Conhecimento — o que o agente sabe: suas FAQs, fontes de conhecimento vinculadas (sites e arquivos), pesquisa na web ao vivo e qualquer contexto extra. Esta é a maior alavanca para a qualidade das respostas — veja Gerenciando FAQs.

Assim que um agente estiver vinculado a algumas centenas de páginas, use a caixa de pesquisa acima da lista de fontes de conhecimento para encontrar uma: ela analisa o site, as pastas dentro dele e as páginas individuais de uma só vez, portanto, digitar parte de um endereço (alternatives, por exemplo, ou pricing) restringe toda a árvore às correspondências e abre as pastas onde elas estão. Cada site então mostra quantas de suas páginas corresponderam. Uma coisa que vale a pena saber: enquanto uma pesquisa estiver ativa, o botão Desvincular tudo de um site ou pasta torna-se Desvincular correspondentes e apenas desvincula as páginas que você pode ver — aquelas filtradas pela sua pesquisa nunca são afetadas.

Para desvincular várias páginas que não compartilham uma pasta, use as caixas de seleção: cada linha de página possui uma, e cada cabeçalho de site e pasta tem uma opção de selecionar tudo que marca tudo o que está dentro (um traço na caixa significa que apenas parte dela está marcada). Assim que algo é marcado, uma barra aparece na parte inferior da tela contando sua seleção, com um único botão Desvincular — você confirma uma vez e toda a seleção é desanexada de uma só vez. O botão de remover por página e o Desvincular tudo ainda funcionam exatamente como antes.

6. Habilidades de IA — o que o agente tem permissão para fazer: agendar reuniões, chamar seus próprios sistemas por meio de Funções Personalizadas, usar ferramentas de servidor MCP, atualizar detalhes de contato e criar tarefas. O painel de Agendamentos aqui é onde você permite que o agente marque reuniões e escolhe quais tipos de evento ele pode agendar — um ou vários, para que um agente possa lidar com todos os serviços que você oferece — veja Sistema de Agendamento.

7. Tags — permitem que o agente rotule contatos enquanto conversa (por exemplo, “Interessado”, “Agendado”, “Não é o perfil”). Descreva quando cada tag deve ser aplicada e o agente cuida do resto — você pode filtrar e segmentar contatos por essas tags mais tarde. Veja Criando Tags. As regras só funcionam enquanto o agente está respondendo, portanto, conversas que já aconteceram — ou que sua equipe gerenciou com a IA pausada — não são marcadas por conta própria: clique em Aplicar a conversas existentes nesta aba para executar as regras sobre elas. Veja Marcando uma conversa sob demanda.

Não quer escrever as regras de tag você mesmo? Clique em Gerar com IA na aba Tags: a plataforma lê as instruções deste agente e o contexto de negócio e propõe um conjunto de tags (geralmente de três a oito) com uma regra de “quando aplicar” pronta para cada uma — estágios do ciclo de vida como Interessado ou Não é adequado, fatos que a conversa revela e motivos de transferência. Ela verifica sua biblioteca de tags existente primeiro e reutiliza uma tag quando uma já significa a mesma coisa, para que você não acabe com duplicatas. Escolha Adicionar às minhas tags para manter o que já está lá e adicionar apenas as novas, ou Substituir todas as tags para começar do zero. Uma execução custa 1 crédito (0,25 no nível Max, gratuito com sua própria chave de IA), e as linhas que a IA escreveu carregam um pequeno marcador IA até que você as edite. Agentes criados a partir de um site ou documentos — no assistente de configuração ou com Novo agente — têm suas tags geradas automaticamente como parte da criação, então esta aba geralmente já está preenchida quando você a abre pela primeira vez.

8. Follow-ups — como este agente persegue contatos que ficam em silêncio: lembretes rápidos nas primeiras 24 horas, ciclos de leads mornos para contatos que interagiram e depois esfriaram, e mensagens para leads frios para contatos que nunca responderam. Desativado por padrão. Escolha o modelo de WhatsApp para cada slot de follow-up da sua biblioteca de modelos. Veja Follow-ups Automatizados para saber o que cada tipo faz e como agendá-los.

Não quer escrever essas mensagens você mesmo? Ative os acompanhamentos e clique em Gerar modelos de IA: a plataforma escreve um conjunto de mensagens de acompanhamento a partir das instruções e do contexto de negócios deste agente, mostra o progresso conforme o processo avança e as envia ao WhatsApp para aprovação. Funciona em qualquer agente — um que você criou há um minuto, uma cópia ou um que já chegou à conta pronto. Consulte Modelos gerados automaticamente.

9. Pontos de Entrada — regras de roteamento para este Agente; consulte Pontos de Entrada para saber o que elas fazem e quando entram em vigor.

10. Testar — um chat de sandbox onde você interpreta o cliente e testa as respostas do agente antes que contatos reais as vejam. Ele é executado diretamente neste agente, portanto, não há nada para anexar antes de poder testar, e cada agente mantém sua própria conversa de teste. Veja Playground de Chat.

Visão geral do Agente #

Todo Agente tem uma etapa de Visão Geral — a primeira etapa em seu editor, e onde um agente ativo abre quando você clica nele na lista de Agentes de IA. É a versão por agente do Painel, da mesma forma que uma Transmissão tem sua própria página de estatísticas.

• Os números. Escolha Últimos 7 dias, Últimos 30 dias ou Últimos 90 dias no topo. Os cartões mostram respostas da IA, respostas (com a taxa de resposta abaixo), novos contatos, agendamentos marcados (apenas quando este agente marcou algum no intervalo) e créditos usados. Cada cartão carrega uma pequena linha de tendência e, onde houver um período anterior para comparar, a mudança desde então. Apenas a atividade deste agente conta — um contato movido para outro agente mais tarde mantém seu histórico onde aconteceu. O que cada cartão conta: Respostas da IA é cada mensagem que a IA enviou por meio deste agente, contada por balão, então uma resposta que a IA divide em três balões adiciona três. Respostas são as mensagens que os contatos enviaram de volta. Novos contatos são contatos criados por meio das conversas deste agente. Agendamentos marcados são os agendamentos que ele fez. Créditos usados é o que suas respostas e chamadas de ferramentas consumiram. Respostas da IA normalmente são várias vezes o número de Respostas, porque uma mensagem de entrada geralmente recebe uma resposta de vários balões e os follow-ups também contam. Passe o mouse sobre o pequeno i em qualquer cartão para ver sua definição exata.
• Prontidão. O scorecard completo: o anel de pontuação, o semáforo, as seis barras de seção e cada verificação em Precisa de atenção ou O que está funcionando, cada um com o botão que o corrige. Veja Pontuação de prontidão para saber o que é pontuado.
• Onde ele responde. Os canais para os quais seus pontos de entrada habilitados o direcionam, seu tempo médio de primeira resposta no intervalo e a parcela de suas mensagens que a IA respondeu em vez da sua equipe. Pontos de entrada abre a etapa de roteamento.
• Resultados da conversa, IA vs humano, Atividade. Os mesmos três painéis do Painel, limitados a este agente: conversas resolvidas sem um humano, escalonamentos, clientes insatisfeitos, as perguntas que ele não conseguiu responder e as vendas deixadas em aberto, a divisão entre IA e humano, e as últimas respostas, agendamentos e alertas.

Nada nesta etapa usa créditos; são apenas contagens simples sobre dados que sua conta já armazena. Um bloco cuja fonte está indisponível informa isso em vez de mostrar zeros.

Pontuação de prontidão #

Cada Agente possui uma pontuação de prontidão de 0 a 100 — uma resposta rápida para “este agente está bem configurado o suficiente para falar com clientes reais?” sem precisar abrir cada etapa e verificar manualmente. Você a vê em três lugares:

• A lista de Agentes de IA possui uma coluna Prontidão que mostra a pontuação de cada agente com um ponto colorido. Clique em uma pontuação para ir diretamente para o scorecard desse agente. Acima da lista, os chips Qualquer prontidão / Pronto / Requer atenção / Ação necessária filtram a lista por cor (com uma contagem em cada), e o seletor de problemas ao lado deles a restringe a uma lacuna específica — agentes sem ponto de entrada, sem FAQs, pausados, nunca testados, agendamentos não configurados, acompanhamentos incompletos, um canal que não está conectado ou instruções ausentes. Agências que gerenciam muitos agentes de clientes podem encontrar aqueles que precisam de trabalho em segundos.
• O cabeçalho do editor do agente mostra a pontuação ao lado da pílula Ativo/Pausado. Clique nela para abrir a Visão geral, onde o scorecard está localizado.
• A etapa de Visão geral (a primeira etapa no editor) contém o scorecard completo abaixo dos números.

O que as cores significam #

• Verde — Pronto (80 ou mais, nada com falha): o agente está configurado, conectado e respondendo.
• Âmbar — Requer atenção (50 a 79, ou uma verificação que falha): o agente funciona, mas algo está faltando ou incompleto.
• Vermelho — Ação necessária (abaixo de 50, ou uma verificação crítica falhando): o agente não consegue realizar seu trabalho. Uma verificação crítica é aquela que interrompe o agente imediatamente — sem ponto de entrada, pausado enquanto conversas ainda são roteadas para ele, agendamentos ativados com linguagem de agendamento mas sem nada para agendar, um canal roteado que não está conectado ou nenhuma instrução.

O que é pontuado #

A pontuação é composta por seis seções, cada uma valendo um número fixo de pontos:

Cada verificação mostra quantos pontos ganhou, uma explicação de uma linha e — quando algo está errado — um botão que leva você à etapa onde você corrige (ou ativa o agente na hora). O scorecard também nomeia a coisa mais valiosa a se fazer em seguida. Clique em uma pontuação na lista de Agentes de IA ou no emblema no cabeçalho do editor e você chegará nela. Verificações que não se aplicam ao seu agente (agendamentos não usados, sem ferramentas externas anexadas) são mostradas para fins de integridade e não custam pontos.

Algumas coisas que vale a pena saber:

• A pontuação analisa o que está ativo. Alterações de rascunho que você ainda não publicou não contam até que você clique em Publicar; o scorecard informa isso, e Verificar novamente o executa novamente após você publicar.
• Um agente usado apenas através do código de incorporação do site não tem uma linha de ponto de entrada, então a verificação de roteamento o sinaliza. A incorporação roteia por conta própria, então você pode ignorar essa verificação para tal agente.
• Um agente que não deveria agendar, mas tem o botão de agendamento ativado (um resquício de uma configuração antiga) mostra “Agendamentos estão ativados, mas não configurados” com um botão Desativar agendamentos. Clique nele e a verificação é limpa; o agente nunca estava agendando nada nesse estado de qualquer maneira.
• Algumas verificações são suposições fundamentadas, e você pode substituí-las. “Agendamento é mencionado, mas não habilitado” procura por instruções de agendamento no texto — “agendar uma chamada”, “oferecer um horário”, “plan een afspraak” — e ignora palavras de agendamento por si sós, descrições do que o produto faz (“a IA agenda compromissos”) e regras negadas (“nunca ofereça uma chamada”); ele ainda pode interpretar mal uma frase incomum. O mesmo vale para “solicita detalhes que não pode salvar” e “preços não mencionados”. Esses três possuem um botão Não relevante para este agente: clique nele e a verificação contará como aprovada a partir de então, mostra uma tag Ignorado em O que está funcionando e tem um link Verificar novamente se você mudar de ideia. Nenhum desses três pode deixar um agente vermelho por conta própria.
• Uma pontuação vermelha não desliga nada. É um relatório, não um bloqueio — o agente continua respondendo exatamente como antes.
• Via API, o mesmo relatório está disponível como GET /v1/agents/health (cada agente) e GET /v1/agents/{agentId}/health (um agente), para que um painel de agência ou um assistente também possa lê-lo.

Procurando pela etapa Campanhas Anexadas? Ela não existe mais. Era uma lista somente leitura das campanhas para as quais um Agente respondia, e nunca houve nada para definir nela — o que decide quais conversas chegam a um Agente são seus Pontos de Entrada, e uma Transmissão escolhe seu próprio manipulador de resposta quando você a cria. Publicar uma alteração no Agente ainda chega a cada conversa que ele responde, imediatamente, exatamente como antes.

Alterações na forma como o agente se comunica, o que significa suas instruções e suas configurações de resposta (velocidade da IA, velocidade de digitação, atrasos na resposta, número máximo de mensagens e similares), são salvas como um rascunho: o chat de teste (Try Out) o utiliza imediatamente, mas as conversas reais continuam sendo executadas com a configuração anterior. Enquanto um rascunho existir, um banner âmbar na parte superior do editor mostra o que não foi publicado — clique em Publicar para o ambiente ativo (Publish to live) quando estiver satisfeito com a forma como o agente responde, ou em Descartar (Discard) para descartar o rascunho e voltar à configuração ativa. Isso significa que você pode ajustar e testar com segurança a redação de um agente ativo sem que os clientes vejam uma alteração inacabada.

Todo o restante é salvo instantaneamente e entra em vigor para seus clientes no momento em que você salva: o nome do agente, ativá-lo ou desativá-lo, seu idioma, modo de teste e sua lista de contatos, FAQs vinculadas, fontes de conhecimento, grupos de conhecimento e pesquisa na web por IA, funções personalizadas, servidores MCP, agendamentos e Odoo, acompanhamentos, tags, biblioteca de mídia e as configurações de resposta do Instagram Story e de compartilhamento. Essas guias e painéis possuem uma pequena etiqueta Salva instantaneamente (Saves instantly) ao lado de seus cabeçalhos, para que você sempre saiba que tipo de alteração está fazendo. O banner diz o mesmo: os rascunhos cobrem instruções e configurações de resposta, e os painéis marcados como Salva instantaneamente entram em vigor imediatamente.

Para ver exatamente o que o rascunho altera, clique em View changes no banner. Cada configuração alterada é listada com o texto ativo em comparação ao rascunho: texto removido em vermelho e tachado, texto adicionado em verde e chaves como On ou Off. Publish to live abre a mesma lista, com uma alternância Show changes em cada configuração, para que você possa verificar o antes e o depois uma última vez antes de confirmar.

Otimizar com IA fica no cabeçalho do painel de chat Testar e está disponível em todos os agentes — uma cópia que você acabou de fazer, um que chegou à conta pronto ou um que você está executando há um ano. Descreva o que deseja melhorar (ou clique no polegar para baixo em uma resposta que não atingiu o objetivo) e as instruções do agente serão reescritas para você, com uma revisão lado a lado de cada alteração proposta antes que qualquer coisa seja mantida. O que você aceita é salvo como um rascunho como qualquer outra edição, para que chegue às conversas reais quando você clicar em Publicar ao vivo — nem um momento antes. Consulte Playground de Chat.

Histórico de versões e desfazer uma alteração #

Toda vez que você clica em Publicar no ambiente ativo, o DM Champ salva uma versão: quais configurações foram alteradas, como estavam antes e como ficaram depois. Uma execução de Otimizar com IA também é registrada, com as alterações propostas por ela. Salvamentos comuns não são registrados, pois um salvamento apenas altera seu rascunho, então a lista permanece como um registro curto das alterações que realmente importaram.

Abra-o com o botão Histórico de versões no canto superior direito do editor de agentes, ao lado de Otimizar com IA. O botão está lá, independentemente de você ter ou não alterações não publicadas pendentes. Cada entrada mostra se ela veio de uma publicação ou de uma otimização por IA, quando aconteceu e quais partes do agente foram afetadas. Clique em Mostrar alterações em uma entrada para ver o que mudou, campo por campo, em linguagem simples. Textos longos, como instruções ou a persona, mostram a redação antiga e a nova linha por linha. Alternadores são lidos como Ligado ou Desligado, e uma configuração vazia é lida como Não definido. Para um grupo de configurações, como as configurações de acompanhamento, apenas as configurações que realmente mudaram são listadas, cada uma com seu valor antigo e novo (por exemplo, Tempos de espera para leads frios: 72h → 72h, 168h). Clique em Mostrar bruto em tal grupo para ver exatamente o que foi armazenado, o que pode ajudar ao falar com o suporte. As 20 entradas mais recentes são carregadas primeiro; clique em Carregar versões mais antigas na parte inferior da lista para ver as anteriores.

Para voltar a uma configuração anterior, clique em Restaurar como rascunho na entrada desejada. Os valores anteriores àquela alteração são carregados no seu rascunho, e nada é publicado imediatamente. A partir daí, o fluxo é o normal: teste o agente em Experimentar, depois clique em Publicar no ambiente ativo quando estiver satisfeito, ou em Descartar para descartar o rascunho restaurado e manter o que está ativo hoje.

Configurações marcadas como Salva instantaneamente nunca passam pelo rascunho. Quando uma dessas configurações é alterada, a lista recebe uma entrada marcada como Alterado ao vivo (Changed live) para que você possa ver o que mudou e quando. Essas entradas não possuem um botão Restaurar como rascunho (Restore as draft), porque não há rascunho para restaurar; em vez disso, altere a configuração de volta no editor.

As alterações que o assistente no aplicativo faz em um agente para você também vão para o rascunho, portanto, elas aparecem no banner âmbar e aguardam que você as publique, exatamente como uma edição que você mesmo digitou.

Ativando ou Desativando um Agente #

Cada Agente aparece como Ativo ou Pausado — na lista de Agentes de IA (veja a captura de tela acima), é um botão de ícone de pausa/reprodução nas ações da linha, e no próprio editor do Agente é um selo de status ao lado do nome. É um interruptor de desligamento total: quando um Agente é desligado, ele para de responder em todos os lugares em que é usado — isso não pode ser substituído por uma configuração de “IA ativada” por contato. Aplica-se a todos os lugares em que esse Agente é usado: cada canal que ele responde e cada Transmissão que aponta para ele.

Modo de teste: Deixe a IA responder apenas aos seus contatos de teste #

O modo de teste permite que você experimente um agente em um número de WhatsApp, conta do Instagram ou qualquer outro canal real sem nenhum risco para seus clientes reais. Enquanto estiver ativado, o agente permanece conectado aos seus canais, mas a IA responde apenas aos contatos que você colocar na lista de teste. Todos os outros são completamente ignorados pela IA.

O que ainda acontece com os contatos que não estão na lista:

• As mensagens deles chegam em Chats normalmente, portanto nada é perdido.
• Você e sua equipe podem respondê-los pessoalmente.
• A IA não responde, não envia acompanhamentos e não responde aos comentários deles no Instagram ou Facebook.

Transmissões, modelos de WhatsApp e mensagens enviadas por você não são afetados pelo modo de teste.

Ativando o modo de teste #

1. Abra o agente na lista de Agentes de IA.
2. Vá para a etapa Instruções de IA. O Modo de teste é o primeiro painel no topo.
3. Ative o Modo de teste.
4. Em Contatos que a IA pode responder, escolha o canal, digite o número de telefone, e-mail ou identificador (handle) e clique em Adicionar. Você pode colar vários de uma vez, separados por vírgulas.

Cada alteração é salva imediatamente e não há nada para publicar. Cada alteração também adiciona uma entrada Alterado ao vivo ao Histórico de versões do agente, para que você possa ver quando o modo de teste foi ativado ou a lista foi alterada. O agente então exibe um selo azul de Modo de teste ao lado de seu status na lista de Agentes de IA e em seu editor, para que ninguém esqueça que ele está ativado.

Se você ativar o modo de teste com uma lista vazia, a IA não responderá a ninguém até que você adicione um contato.

O que colocar na lista #

Escolha o canal primeiro e, em seguida, adicione o que identifica o contato nesse canal:

• Telefone (WhatsApp, SMS): o número de telefone com seu código de país, por exemplo +31 6 1234 5678. Espaços, traços e parênteses não importam, e 0031... também funciona. Um número sem o código do país não corresponde. Um número de telefone conta apenas para WhatsApp e SMS. Um contato do WhatsApp que oculta seu número pode ser adicionado em Telefone pelo seu ID de usuário do WhatsApp (duas letras, um ponto e um código longo, por exemplo US.13491208655302741918).
• Instagram, Messenger, Telegram, LinkedIn e os outros canais: o identificador (com ou sem o @), o e-mail ou o ID da conta que você vê no contato.

Cada entrada conta apenas no canal que você escolheu para ela, porque @john no Instagram e @john no Telegram são duas pessoas diferentes. Para testar a mesma pessoa em dois canais, adicione-a uma vez por canal. A lista mostra o canal ao lado de cada entrada.

Entradas adicionadas antes da existência dos canais mostram Qualquer canal. Elas continuam funcionando em todos os canais, exceto WhatsApp e SMS; remova uma e adicione-a novamente com um canal para limitá-la.

Um contato corresponde quando seu número de telefone, e-mail, identificador ou ID está na lista do canal pelo qual ele enviou a mensagem. A lista comporta até 200 entradas.

Entrando em operação #

Quando estiver satisfeito com o agente, desative o Modo de teste. A partir desse momento, a IA responderá a todos novamente, exatamente como antes. Sua lista de teste é mantida, para que você possa reativar o modo de teste mais tarde sem precisar digitá-la novamente.

Renomeando, duplicando e excluindo um Agente #

• Renomeie um Agente clicando em seu nome na parte superior do editor do Agente — digite o novo nome e pressione Enter. A renomeação é aplicada imediatamente, onde quer que o Agente seja exibido.
• Duplique um Agente com o ícone de cópia (dica de ferramenta Duplicar agente) em sua linha na lista de Agentes de IA para iniciar um novo a partir de uma cópia de suas configurações atuais. A cópia mantém o estado ligado ou desligado do original, portanto, uma cópia de um Agente ativo também estará ativa. Os arquivos na Biblioteca de mídia do original não são copiados: envie aqueles que a cópia deve enviar. A cópia abre no editor com o nome “(cópia)” — clique no nome para dar a ele um próprio. A cópia começa com sua própria conversa de Teste vazia, portanto, os testes da cópia nunca aparecem no chat de teste do original (ou vice-versa).
• Excluir é bloqueado enquanto um Agente ainda estiver sendo usado por uma Transmissão ou um Ponto de entrada — aponte-os para outro Agente (ou remova-os) primeiro e, em seguida, exclua. Um Agente que não está sendo usado por nada é excluído imediatamente. Um Agente que veio de uma campanha antiga junto com uma Transmissão de mesmo nome é um caso especial: essa Transmissão é uma visualização da mesma campanha, portanto, ela não bloqueia a exclusão, e você também pode excluir a própria Transmissão na página de Transmissões (a menos que ela esteja sendo enviada ou agendada no momento). Fique atento aos Pontos de entrada que você não adicionou manualmente: escolher o caso de uso comentar para DM no assistente de configuração cria uma regra de comentário no Instagram e no Facebook no novo Agente, e elas contam como “em uso” até que você as remova na guia Pontos de entrada do Agente.

Ativando ou desativando um Agente a partir da lista #

O ícone de reproduzir e pausar nas ações de uma linha ativa ou desativa esse agente sem abri-lo. A pausa ocorre imediatamente. Ativar um agente pausado solicita uma confirmação primeiro, pois ele começa a responder contatos reais em seus canais imediatamente; em uma linha do WhatsApp Web, esse é o seu próprio número. Teste-o em Experimentar antes de entrar em operação.

Trabalhando com vários agentes ao mesmo tempo #

Cada linha na página de Agentes possui uma caixa de seleção (a caixa de seleção do cabeçalho seleciona tudo o que está sendo exibido no momento). Com os agentes selecionados, uma barra aparece na parte inferior com Ativar, Pausar e Excluir — cada uma solicita confirmação antes que qualquer ação ocorra. A exclusão ignora qualquer agente que ainda esteja em uso por uma Transmissão ou um Ponto de Entrada; libere-os e a próxima exclusão também os removerá. Pressione Esc para limpar uma seleção.

Próximos passos #

• Broadcasts — envie uma mensagem única ou contínua e escolha qual Agente lida com as respostas.
• Entry Points — regras de roteamento que decidem qual Agente atende uma conversa recebida e se eles já estão ativos para sua conta.
• Setting Up Your AI Bot — o guia completo para escrever instruções, manuais e configurações de resposta.
• Managing FAQs — forneça ao seu Agente respostas prontas.