Telegram e alertas de administrador

Onde no admin: System › Settings › Admin alerts (/settings/alerts). Atalhos de suporte: Customers › Support › Tickets (/support/tickets), aba Settings.

O que faz

O NexCMP avisa você — o operador — quando algo precisa de atenção e quando um cliente se cadastra ou um depósito é creditado. Os alertas vão para um ou mais canais: Telegram, webhook ou e-mail.

Os eventos enviados para os canais de administrador incluem: falha de implantação, VM ausente, rede caída, IPs livres abaixo de 30, item prestes a expirar (aviso de 1 hora), disputa no Stripe, worker inativo, RAM do cluster acima do limite, novo cadastro de cliente e depósitos creditados. Os eventos de clientes são enfileirados de forma durável e tentados novamente com atraso crescente (de 30 segundos a 1 hora) até que o Telegram os aceita.

Requisitos

Item	Requisito
Telegram	Um bot criado com @BotFather (token) e o chat ID do grupo ou usuário que deve receber as mensagens
Rede	HTTPS de saída para api.telegram.org
Webhook (alternativo)	Um endpoint HTTPS que aceita o payload do alerta

Preparar o Telegram

1. No Telegram, abra @BotFather, envie /newbot, escolha um nome e copie o bot token (123456789:AA...).
2. Crie um grupo, adicione o bot a ele e envie qualquer mensagem.
3. Encontre o chat ID: abra https://api.telegram.org/bot<token>/getUpdates em um navegador e leia chat.id (os IDs de grupo começam com -).

Conectar no NexCMP

1. Abra System › Settings › Admin alerts.
2. Em Add channel, escolha Type: Telegram, defina Destination como o chat ID e Secret (bot token) como o token. Clique em Add.
3. Certifique-se de que a opção Send admin Telegram (VM module) esteja ativada; a linha VM module status (read-only) mostra "on".

Verificar

O canal aparece em Configured channels. Dispare um evento (por exemplo, registre um cliente de teste) e a mensagem chegará ao grupo. Se nenhum canal estiver configurado, a página avisará "Without a channel, attacks will go unnoticed" e, no log, os eventos do Telegram serão registrados apenas localmente.

Atalhos de suporte para clientes

O widget de suporte ao cliente pode exibir botões do Telegram e Zalo. Eles ficam ocultos até serem configurados nas configurações de suporte: insira um link https://t.me/... para o Telegram e o link ou QR do Zalo. Apenas links https:// são aceitos. O chat de suporte também pode notificar seu grupo do Telegram com a pergunta e uma resposta preliminar — consulte AI Chat.

Limites e observações

• O token do bot é armazenado com o canal e nunca mais é exibido.
• Os eventos do Telegram usam o primeiro canal do Telegram ativado que possui um destino e um token.

Resolução de problemas

Sintoma	Causa	Correção
Nenhuma mensagem chega	Chat ID incorreto, bot não está no grupo ou o bot nunca recebeu mensagens	Verifique novamente o ID com getUpdates; envie uma mensagem para o bot ou grupo primeiro.
Funciona por um tempo e depois para	Token revogado no BotFather	Crie um novo token e atualize o canal.
Telegram: no channel nos logs	Nenhum canal do Telegram ativado	Adicione um conforme descrito acima.