WhatsApp e Telegram (números e bots da agência)

Em WhatsApp e Telegram ficam os números de WhatsApp e os bots de Telegram da sua agência que enviam avisos e relatórios. Eles ficam num lugar só, fora da página do cliente: um número serve a agência inteira.

Onde fica

Na barra lateral, vá em Infra → Conexões → WhatsApp e Telegram. A tela mostra três cartões, cada um com o logo da plataforma:

• WhatsApp Lite: o número comum da agência, conectado pelo QR Code. É o que funciona hoje.
• WhatsApp Oficial: a Cloud API da Meta, para conectar um número oficial em um clique, com selo verificado. Está marcado Em breve e ainda não conecta.
• Telegram: o bot global da Uniafy ou um bot seu.

Abaixo dos cartões ficam as conexões já feitas, com o estado de cada uma: Conectado, Conectando, Desconectado ou Erro.

O que sai por cada canal, e para quem, se escolhe em Ajustes → Avisos (veja Onde configurar seus avisos).

Conectar um WhatsApp Lite

1. Clique em Conectar número no cartão WhatsApp Lite.
2. Dê um nome à conexão (por exemplo, "WhatsApp Comercial") e, se quiser, atribua a um gestor. Clique em Gerar QR Code.
3. No celular, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o QR Code da tela.

Em poucos segundos a tela mostra Número conectado! com o número pareado, no formato de discagem (ex.: +55 48 99195-4799). Clique em Concluir.

O QR Code se renova sozinho enquanto a tela está aberta. Se ele expirar sem ser escaneado, aparece O QR Code expirou. Gere outro. — use Gerar novo QR Code.

Conectar sem escanear: código de pareamento

Na mesma janela, a aba Código conecta digitando um código no celular, sem câmera. Informe o número com DDD (ex.: 11 98765-4321) e clique em Gerar código. No celular: WhatsApp → Aparelhos conectados → Conectar um aparelho → Conectar com número de telefone, e digite o código que apareceu na tela.

Testar o envio

Na linha da conexão conectada, Testar abre o Enviar mensagem de teste. A mensagem sai do número conectado e avisa que é um teste do Uniafy enviado pela sua agência.

Por segurança, o teste vai só para dois destinos — nunca para um número digitado, para a mensagem não sair do WhatsApp da agência para um desconhecido:

• Este número: o próprio número conectado. A mensagem aparece no celular conectado, na conversa "Você" (mensagem para si mesmo).
• Meu WhatsApp: o seu WhatsApp, se você já o confirmou com o aceite em Ajustes → Avisos → Meus avisos. Sem ele confirmado, essa opção não aparece.

O botão mostra o número de destino antes de enviar (Enviar para +55 …). Depois do envio, a janela mostra a hora, o número que recebeu e onde conferir. Cada conexão aceita até 5 testes por hora.

No Telegram, o teste funciona com bot próprio: informe o chat_id numérico que vai receber a mensagem. Com o bot global da Uniafy, o teste ainda não está disponível (veja a seção Telegram abaixo).

Usar o número para os avisos

Para que os avisos pessoais por WhatsApp saiam por esse número, o dono ou o head escolhe a conexão em Ajustes → Avisos → Avisos da organização → Canais → WhatsApp de avisos. Cada pessoa liga os avisos que quer receber por WhatsApp em Meus avisos, depois de informar o número e dar o aceite.

Quando o WhatsApp cai

Se o celular perder a conexão, o Uniafy tenta religar o número sozinho por alguns minutos. Se ele não voltar em 30 minutos, a conexão passa para Desconectado e o responsável por ela recebe o aviso WhatsApp desconectado, no sino e por e-mail (dá para ligar ou desligar em Ajustes → Avisos → Meus avisos → Tráfego → WhatsApp e Telegram). Enquanto estiver desconectado, nada sai por esse número.

Para reconectar, remova a conexão e conecte de novo pelo QR Code.

Remover uma conexão

O ícone de lixeira na linha da conexão pede confirmação (Remover conexão? → Remover). No WhatsApp, a sessão é encerrada e o aparelho some da lista de Aparelhos conectados do celular. Os avisos que saíam por essa conexão deixam de ser enviados.

Telegram

Clique em Conectar Telegram. Você pode Usar bot global da Uniafy (um clique) ou colar o Token do bot de um bot seu, criado no @BotFather.

O bot global é um só para todas as agências que usam o Uniafy. Por isso, ele ainda não envia mensagem de teste: um chat_id sozinho não prova que o chat é da sua agência, e o teste poderia chegar a uma pessoa de outra agência que também iniciou o bot. O teste do bot global chega quando o chat puder ser vinculado à sua agência pelo /start. Ao clicar em Testar numa conexão do bot global, a janela explica isso.

Para testar agora, conecte um bot próprio: no Telegram, crie o bot com o @BotFather, copie o token, cole em Token do bot e use Testar com o chat_id que vai receber a mensagem.

Quem pode mexer

Dono e Head de Tráfego veem e cuidam de todas as conexões da agência. O Gestor conecta e cuida só das conexões dele. Comercial, Financeiro e Visualizador não acessam esta tela. Veja Equipe e papéis.

Problemas comuns

• O número não conectou e o QR sumiu. O QR Code vence depois de algumas tentativas. Clique em Gerar novo QR Code e escaneie logo em seguida.
• O teste não chegou. Confira se a conexão está Conectado. No teste para Este número, procure a conversa "Você" no celular conectado; no Meu WhatsApp, confira o número em Ajustes → Avisos.
• "O teste pelo bot global da Uniafy ainda não está disponível". É o comportamento esperado no bot global (veja a seção Telegram acima). Para testar, conecte um bot próprio.
• "Limite de 5 testes por hora". Espere a próxima hora para testar de novo.
• Recebi o aviso de WhatsApp desconectado. Abra o WhatsApp no celular para ver se ele ainda aparece em Aparelhos conectados. Se não aparecer, remova a conexão no Uniafy e conecte de novo.