---
title: Telegram e alertas de administrador
description: Envie alertas operacionais, cadastros e depósitos para Telegram, webhook ou e-mail, e configure os atalhos de suporte exibidos aos clientes.
url: https://nexcmp.com/pt/docs/administration/telegram-notifications/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Telegram e alertas de administrador {#telegram-and-admin-alerts}

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

## O que faz {#what-it-does}

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 {#requirements}

| 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 {#prepare-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 {#connect-in-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".

![A página de alertas de administração com o formulário Add channel configurado para Telegram](https://nexcmp.com/pt/docs/images/administration/telegram-notifications-01-channel.webp)

## Verificar {#verify}

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 {#support-shortcuts-for-customers}

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](https://nexcmp.com/pt/docs/ai/ai-chat/).

## Limites e observações {#limits-and-notes}

- 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 {#troubleshooting}

| 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. |