UltronChatUltronChat Docs
Agente de IA

Avisos por WhatsApp

Receba no celular, em ate 3 numeros, quando um cliente pedir atendimento humano ou quando uma conexao parar de funcionar.

Quando a IA transfere uma conversa para um humano, o UltronChat sempre avisou por e-mail. O problema e o canal: um lead que pede atendente esfria em minutos, e quase ninguem fica olhando e-mail em tempo real.

Os avisos por WhatsApp resolvem isso — a mensagem chega no seu celular (e no de ate mais 2 pessoas do time) segundos depois da escalacao.

Configure em Avisos, no menu lateral (/dashboard/settings/alerts).

O que dispara um aviso

EventoQuando acontece
Pedido de atendimento humanoA IA acionou o atendimento humano — o cliente pediu um atendente ou a IA nao conseguiu resolver. Exige o toggle Atendimento humano ligado no agente.
Conexao com token expiradoUma conexao parou de funcionar porque o token da Meta expirou ou foi revogado.

O aviso vale para escalacoes de qualquer canal: WhatsApp, Instagram e Messenger. A configuracao e da sua conta inteira, nao de uma conexao — voce cadastra os numeros uma vez so.

Por que preciso de um template aprovado

Para o WhatsApp mandar uma mensagem para alguem que nao falou com voce nas ultimas 24 horas, a Meta exige um template aprovado. O seu proprio numero se encaixa nessa regra, entao o aviso precisa ser um template.

1. Crie o template

Va em Templates na conexao de WhatsApp que vai enviar os avisos e crie um na categoria Utilidade. Na tela de Avisos ha um modelo pronto para copiar:

UltronChat · atendimento humano solicitado. Cliente: {{1}} ({{2}}). Canal: {{3}}. Resumo: {{4}} Sugestao: {{5}} Responda o quanto antes.

Duas regras da Meta que reprovam a maioria dos templates:

  • Nao use quebras de linha no corpo.
  • Nao comece nem termine o corpo com uma variavel. (E por isso que o modelo acima termina com "Responda o quanto antes." em vez de {{5}}.)

Os exemplos que a Meta exige para cada variavel sao preenchidos automaticamente a partir do rotulo que vem antes dela no proprio texto — em Resumo: {{4}}, por exemplo, o revisor da Meta ve um resumo de conversa de verdade, e nao um "Exemplo4". Isso ajuda na aprovacao.

A aprovacao costuma levar de minutos a algumas horas.

2. Cadastre os numeros

Em Avisos, ligue Avisar por WhatsApp e adicione ate 3 numeros com DDI e DDD (ex.: 5511999998888). Eles precisam ter WhatsApp ativo.

Voce nao pode usar o proprio numero da conexao que envia — a Meta aceita e descarta a mensagem em silencio, entao o sistema bloqueia antes.

3. Escolha o template e o que vai em cada variavel

Para cada evento, selecione a conta que envia, o template aprovado e o que preenche cada {{n}}. As opcoes disponiveis mudam conforme o evento:

Pedido de atendimento humano: nome do cliente, contato (numero ou @), telefone so com digitos (para montar um wa.me), link direto para o cliente, resumo da conversa (gerado pela IA), sugestao de acao (gerada pela IA), motivo, urgencia, canal, conta, nome do agente e link do Live Chat.

Conexao com token expirado: conta, canal, tipo do problema e link da pagina de conexoes.

Tambem da para fixar um texto que nao muda, escolhendo Texto fixo....

4. Envie um teste

Clique em Enviar teste no card do evento. O aviso de exemplo chega nos numeros cadastrados. Faca isso sempre depois de mudar a configuracao — sem o teste, um erro so apareceria na primeira escalacao real.

Custo

Cada aviso e uma conversa cobrada pela Meta. Com 3 numeros cadastrados, cada evento gera 3 conversas. Para evitar surpresa, existe um limite de seguranca: rajada de 6 avisos e reposicao de 6 por hora, com teto diario.

Se o limite for atingido, o aviso e pulado (o e-mail continua chegando) e o motivo fica registrado no historico. Muitas escalacoes numa janela curta geralmente significam que a IA esta escalando demais — vale revisar as instrucoes do agente.

E o e-mail?

Continua funcionando, com toggle proprio. Os dois canais sao independentes: se o template for reprovado ou um numero bloquear o remetente, o e-mail ainda chega — e vice-versa. Recomendamos manter os dois ligados.

Requisitos

  • Plano Pro.
  • Pelo menos uma conta de WhatsApp conectada (mesmo que a escalacao venha do Instagram ou do Messenger).
  • Um template aprovado pela Meta.
  • Para o evento de atendimento humano: toggle Atendimento humano ligado na aba Avancado do agente.

Se o aviso nao chegar

  1. Confirme que o toggle esta ligado e ha pelo menos um numero salvo.
  2. Confirme que o template esta aprovado — templates reeditados voltam para analise e os avisos param ate a nova aprovacao.
  3. Use Enviar teste para separar problema de configuracao de problema de escalacao.
  4. Confirme que o numero de destino tem WhatsApp ativo.

On this page