Your AI Connector Docs

Pontos de Entrada

Um Ponto de Entrada é uma regra de roteamento: ele diz “quando isso acontecer neste canal, entregue a conversa a este Agente”. Os Pontos de Entrada são a forma como um Agente de IA assume uma conversa da qual ele ainda não fazia parte — um novo contato enviando uma mensagem pela primeira vez, alguém comentando uma palavra-chave em uma publicação ou uma palavra específica aparecendo em uma mensagem recebida.

Não é um construtor de fluxo de trabalho. Um Ponto de Entrada faz apenas uma coisa: corresponde a um evento e atribui um Agente. Não há atrasos, condições, ações de tag ou ramificações — esse nível de automação reside em Automações, uma parte separada da plataforma.


O Roteamento de Pontos de Entrada está ativo

Os Pontos de Entrada decidem quem responde a uma nova conversa em cada conta. Eles nunca movem uma conversa que já está em andamento: para transferir um chat existente para um Agente diferente, use Atribuir Agente de IA no menu do chat, ou a ação Atribuir agente de IA ou campanha em Automações quando quiser que isso aconteça por regra (uma mensagem recebida contendo uma palavra-chave, por exemplo). Passo a passo: Trocar Agente de IA no Meio da Conversa. O painel Quem Responde a Novas Conversas na página de Agentes de IA mostra um selo verde de Ativo quando cada canal conectado tem um Agente selecionado, e uma contagem em âmbar para qualquer canal que ainda não tenha resposta. Um canal sem Ponto de Entrada e sem padrão de canal não recebe resposta automática, e enviamos uma notificação quando uma mensagem chega e não há nada configurado na sua conta para respondê-la.


Tipos de Ponto de Entrada

Tipo O que corresponde Substitui (configuração de campanha clássica)
Padrão do Canal Qualquer mensagem de contato nova e não correspondida em um canal O cartão de Roteamento de Canal para esse canal
Palavra-chave Uma mensagem recebida contendo uma de suas palavras-chave escolhidas Palavras-chave de gatilho em uma campanha
Comentário no Instagram Um comentário contendo uma de suas palavras-chave de comentário, em todas as suas postagens do Instagram ou apenas nas postagens específicas que você listar Monitoramento de comentários no Instagram
Comentário no Facebook Um comentário contendo uma de suas palavras-chave de comentário, em todas as suas postagens da Página do Facebook ou apenas nas postagens específicas que você listar Monitoramento de comentários no Facebook
Seguidor no Instagram Um novo seguidor em sua conta do Instagram. Requer a conexão Instagram (Pessoal) — a conexão oficial de DMs do Instagram (Meta) não consegue ver seguidores, portanto, esta regra só é oferecida quando o Instagram (Pessoal) está conectado Alcance de seguidores

Cada regra se aplica a um ou mais canais e aponta para exatamente um Agente. As regras de palavras-chave e comentários são verificadas primeiro, e um Padrão de Canal só captura o que não foi correspondido por elas — portanto, um Padrão de Canal é sempre seu recurso de reserva, nunca uma regra concorrente.

Na lista de regras, cada chip de canal também nomeia a identidade conectada à qual se aplica — “WhatsApp: +13128654312”, “Email: sales@example.com”, “Instagram: @yourshop” — para que você possa identificar rapidamente qual número, caixa de entrada ou conta uma regra protege.

Uma regra de Palavra-chave também funciona como um filtro por si só: se um canal possui uma regra de Palavra-chave e nenhum Padrão de Canal, as mensagens que não contêm uma das palavras-chave não recebem resposta automática e simplesmente vão para a sua caixa de entrada para um humano — mesmo quando você tem apenas um Agente na conta. Portanto, “responder apenas quando disserem AURUM” é apenas uma regra de Palavra-chave com AURUM como a palavra-chave e nada mais definido para aquele canal.

As regras se aplicam por canal por padrão: se você tiver vários números de WhatsApp conectados a uma conta, eles compartilham as mesmas regras de roteamento. A única exceção é um Padrão de Canal com escopo para um único número — com dois ou mais números de WhatsApp ou WhatsApp Web conectados, você pode atribuir a cada número seu próprio Agente (veja a seção por número abaixo). Para algo mais específico, use regras de Palavra-chave; para manter ramificações ou marcas inteiras totalmente separadas (seus próprios Agentes, contatos e relatórios), use subcontas separadas.

Os dois tipos de comentário possuem três configurações próprias: Palavras-chave de comentário (quais comentários contar — vazio significa todos), Quais publicações (Todas as publicações ou Publicações específicas — clique em Escolher publicações e marque-as em uma lista de suas publicações e reels recentes; colar IDs de publicação ainda é possível para qualquer coisa que a lista não mostrar) e Primeira resposta (IA ou Texto exato com sua própria resposta de comentário público e primeira mensagem de DM). Você também pode definir um atraso em minutos antes que qualquer uma delas seja enviada. Veja Automação de Comentário para DM.


Criando um Ponto de Entrada

Os Pontos de Entrada são gerenciados na aba Pontos de Entrada dentro do editor de um Agente:

  1. Abra o Agente para o qual você deseja que a regra direcione.
  2. Vá para a aba Pontos de Entrada.
  3. Clique em Novo Ponto de Entrada.
  4. Escolha um tipo.
  1. Escolha o(s) canal(is) ao(s) qual(is) isso se aplica (bloqueado para um único canal para regras de Comentário no Instagram, Comentário no Facebook e Seguidor no Instagram).
  2. Preencha os detalhes de correspondência para esse tipo — palavras-chave; as publicações a serem monitoradas (marque-as na lista Escolher publicações ou deixe Todas as publicações selecionado para monitorar cada publicação); e, para regras de comentário, qualquer atraso antes que a resposta automatizada seja enviada.

Para regras de comentários, Palavras-chave de comentário decide quais comentários contam. Adicione a palavra que as pessoas são instruídas a comentar (“LINK”, “INFO”) e apenas esses comentários receberão uma DM. Deixe vazio e cada comentário nas postagens monitoradas receberá uma, o que é o que você deseja em uma postagem criada em torno de uma única chamada para ação, e custoso em uma postagem movimentada onde a maioria dos comentários são apenas conversas.

  1. Para regras de Palavra-chave, Comentário no Instagram e Comentário no Facebook, escolha Primeira Resposta: IA permite que o Agente escreva sua própria resposta inicial, ou Texto Exato envia uma mensagem fixa que você mesmo escreve (além de uma resposta de comentário público separada, para tipos de comentário) — a IA só assume o controle assim que o cliente responde. Você pode personalizar a mensagem de Texto Exato com {{first_name}} — ele é substituído pelo primeiro nome de quem comentou, ou por “lá” quando o nome não estiver disponível (o Instagram geralmente não o compartilha).
  1. Ative a opção Habilitado.
  2. Clique em Salvar.

Você pode habilitar ou desabilitar uma regra a qualquer momento sem excluí-la. Apenas um Padrão de Canal pode ser habilitado por canal — criar um novo desabilita automaticamente qualquer outro padrão habilitado já definido para o mesmo canal, seja ele definido neste Agente ou em outro.


Quem responde a novas conversas

Quem Responde a Novas Conversas é o painel na parte superior da página de Agentes de IA — é onde você define o ponto de entrada Padrão do Canal para cada canal conectado em um só lugar, em vez de um por um dentro de um Agente. Ele é recolhido para um resumo de uma linha quando cada canal já tem uma resposta, e abre automaticamente no momento em que qualquer canal não tiver.

Para cada canal conectado, você verá um seletor para escolher qual Agente deve responder a uma nova conversa não correspondida nele. Se você tiver exatamente um Agente ativo na conta, esse Agente é mostrado automaticamente como a resposta para cada canal (rotulado como “seu único agente”) — o painel está sendo honesto ao dizer que ele irá responder, não sugerindo que você ainda precise configurar algo. A única exceção é um canal com uma regra de Palavra-chave: nele, o Agente responde apenas a mensagens que correspondem a uma palavra-chave, então o painel mostra esse canal apenas como palavra-chave. No momento em que você cria um segundo Agente, qualquer canal sem uma escolha explícita é exibido como não respondido até que você escolha um.

O seletor também oferece Ninguém está respondendo — selecione-o e a IA ficará totalmente fora de novas conversas nesse canal; as mensagens simplesmente chegam à sua caixa de entrada para que sua equipe as gerencie. Isso funciona em todas as contas, incluindo uma com um único Agente: o canal permanece silencioso, embora esse Agente responda em todos os outros lugares, para que você possa manter a IA no WhatsApp enquanto um humano gerencia, por exemplo, o Instagram. Um canal que você silenciou deliberadamente é exibido calmamente com Ninguém está respondendo selecionado — ele não conta como não respondido, não deixa o painel âmbar e nunca aciona a notificação “nada está configurado para responder”. Para devolver o canal à IA, basta selecionar um Agente novamente.

Um Agente por número de WhatsApp

Se você tiver dois ou mais números conectados ao WhatsApp Web ou à API do WhatsApp Business, o painel adiciona um bloco por número abaixo das linhas do canal — uma linha por número conectado, cada uma com seu próprio seletor. Escolha um Agente diferente para cada número e uma nova conversa será respondida pelo Agente que pertence ao número para o qual o cliente escreveu. É assim que uma empresa com várias filiais, marcas ou idiomas gerencia tudo a partir de uma única conta, em vez de uma conta separada por filial: o número de Amsterdã recebe o Agente de Amsterdã, o número de Roterdã o de Roterdã, cada um com suas próprias instruções, perguntas frequentes e configuração de agendamento.

Cada número começa como Igual ao WhatsApp (ou Igual ao WhatsApp Web) — ele simplesmente segue o que você escolheu para o canal acima, portanto, nada muda até que você escolha algo para um número específico. Um número também pode ser definido como Ninguém está respondendo individualmente, o que mantém a IA desativada nesse número enquanto os outros continuam respondendo. Para devolver um número ao Agente do canal, escolha Igual a… novamente. As respostas sempre saem do número para o qual o cliente enviou a mensagem, portanto, um contato que escreveu para o seu segundo número continua falando com esse número e com esse Agente.

A mesma opção está disponível dentro de um Agente: na aba Pontos de Entrada, adicione um Padrão de Canal para WhatsApp ou WhatsApp Web e, quando dois ou mais números estiverem conectados nesse canal, um seletor de Número aparecerá — deixe em Todos os números para o padrão de todo o canal, ou escolha um número para fazer com que este Agente responda apenas a esse número. Uma regra com escopo de número exibe o número como um chip na lista, para que nunca pareça idêntica ao padrão de todo o canal.

Uma escolha por número decide apenas quem atende uma nova conversa. Contatos que já estão falando com um Agente permanecem com ele, e uma regra de Palavra-chave ou Transmissão que corresponda ainda tem prioridade, exatamente como na escolha em nível de canal.

O Agente que você escolhe para um canal aqui é aquele que responde a uma nova conversa não correspondida nesse canal, e essas escolhas entram em vigor imediatamente. Quando cada canal conectado tem uma resposta, o painel é recolhido para um resumo de uma linha com um selo verde Ativo; qualquer canal deixado sem um mostra a cor âmbar, e novos contatos lá não recebem resposta automática até que você escolha um Agente.

Se você ainda não tem nenhum Agente, crie um na página AI Agents primeiro e, em seguida, retorne para definir os padrões de canal.


Próximos passos

  • Agentes de IA — o que é um Agente e como criar ou editar um.
  • Automação de Comentário para DM — transformando comentários do Instagram e Facebook em DMs. Configure-os como Pontos de Entrada de Comentário do Instagram ou Comentário do Facebook no Agente que deve responder.