Como receber notificações de transações com criptomoedas no Telegram

Para receber no Telegram mensagens sobre entradas na sua carteira, adicione o endereço ao monitoramento do Cryptanio, conecte o chat à conta e selecione-o nas notificações do projeto correspondente. Não é preciso criar um bot nem programar. Os fundos chegam à carteira informada, e o Cryptanio comunica as transferências detectadas e as mudanças de estado.

Vamos usar um cenário comum: você recebe USDT e quer saber das novas entradas sem abrir o explorador da blockchain a cada vez. O mesmo processo permite configurar notificações para outro ativo compatível.

O que você vai precisar

Você precisa de uma conta do Cryptanio com permissão para alterar as configurações, do Telegram e de um endereço público de carteira em uma rede disponível para monitoramento. Para USDT, também será necessário o identificador do token na rede escolhida. Por exemplo, nos tokens que têm endereço de contrato, é esse endereço que distingue o ativo desejado de outros tokens com nomes semelhantes. Os identificadores de USD₮ estão publicados no diretório oficial da Tether.

A chave privada e a frase de recuperação não são necessárias para esse acompanhamento. É possível receber notificações sobre um endereço público sem conectar a carteira para assinar operações.

Escolha o projeto e adicione o endereço

Abra Monitoring no painel do Cryptanio e entre no projeto ao qual a carteira pertence. O projeto ajuda a manter juntos os endereços e as notificações de um site ou de uma área de trabalho.

Se o endereço ainda não foi adicionado, clique em Adicionar endereços. Escolha a rede, cole o endereço público do destinatário e confira se ele pertence exatamente a essa rede. Se quiser, adicione um nome claro, como “Pagamentos de consultoria”.

Para USDT, escolha “Um ativo” e informe em “Ativo” o identificador compatível do token na rede selecionada. O catálogo também reconhece aliases compatíveis, como USDT. Um campo vazio significa a moeda nativa da rede, não USDT. Salve o endereço e confirme que o monitoramento está ativo.

Para receber somente avisos de entradas, habilite “A chegar” e deixe “Saindo” desabilitado. Marque ambos para as duas direções, caso as transferências de saída estejam disponíveis na rede e no modo escolhidos.

Abra as configurações de notificações do projeto

Abra as “Notificações” do projeto correspondente. Confira o nome para enviar ao chat os eventos do conjunto correto de endereços.

“Usar configurações de notificação de conta” determina se o projeto usa o conjunto compartilhado de canais. “Configurações da conta” abre essas configurações; as alterações afetam os projetos que as herdam. Desative a herança no projeto correspondente para escolher destinatários próprios.

Escolha configurações próprias se as mensagens sobre essa carteira precisam chegar a um chat separado. Depois de mudar, confira todos os destinatários: o projeto passa a usar integralmente suas próprias configurações de notificações. Uma conexão nova também é adicionada às notificações compartilhadas da conta. Alterar um projeto não interrompe os envios para esse canal nos outros projetos que herdam as configurações comuns; confira-os separadamente, se necessário.

Conecte o Telegram pelo painel

Abra “Configurações” → “Notificações” e a aba Telegram. Clique em “Conectar Telegram”, depois em “Abrir Telegram” e confirme o início do bot no Telegram. Se o painel mostrar um comando em vez de um link, envie o comando completo ao bot.

O código de vinculação só pode ser usado uma vez e é válido por 15 minutos. Não o envie a outras pessoas: ele serve para conectar o seu chat. Se o código expirar, obtenha um novo pelo painel.

O bot confirma a conexão à conta. /whoami mostra a qual conta o chat está conectado; não seleciona um projeto. Volte ao painel e clique em “Verificar a ligação”. Abra o bot pelo painel para usar o link preparado para sua conexão.

Ative o Telegram para o projeto

Se a rota já existir, vá direto à seleção de eventos; use o botão com sinal de mais somente se a rota estiver ausente. Volte às “Notificações” do projeto com configurações próprias. No cartão Telegram, encontre o chat conectado e clique no botão com sinal de mais “Usar … para este projeto”. Escolha “Pagamentos confirmados” para entradas normais ou “Confirmado e rebolo” para confirmações e reversões. A rota e os eventos são salvos quando alterados.

A conexão define o destinatário; a rota define quais eventos do projeto serão enviados. Não é necessário marcar uma opção Telegram separada no endereço. Nas configurações da conta, “Teste” coloca uma mensagem de teste na fila. O teste não cria uma transferência de criptomoedas nem verifica o monitoramento do endereço.

Para transferências de saída, use “Escolha tipos de eventos” e inclua “Transferência de saída confirmada”: a política de pagamentos confirmados não as inclui automaticamente. As regras do endereço também precisam permitir essa direção, e a rede e o ativo devem corresponder à transferência.

Confira o resultado em uma nova transferência

Para verificar, aguarde a próxima entrada após a ativação do monitoramento. Se fizer uma pequena transferência por conta própria, considere a taxa da rede e confira previamente o endereço, a rede e o token.

Encontre a operação em Eventos e compare-a com a mensagem no Telegram. Confira o valor, o ativo, a rede e o identificador da transação. A mensagem apresenta o status do evento; em algumas redes, há um link para a transação no explorador.

Uma transferência detectada e uma transferência confirmada são etapas diferentes da mesma operação. Receber mensagens sobre uma mudança de estado não significa necessariamente que houve dois pagamentos. O estado também pode mudar se uma transação for revertida. Decida sobre a execução de um pedido pago com base no pagamento confirmado e em seu estado atual.

Se as mensagens não chegarem

Primeiro confira se a operação aparece em “Eventos”. Caso contrário, verifique a rede, o ativo, a direção e o estado do monitoramento. Se o evento existe, confira o projeto, a herança, o chat escolhido, a política de eventos e as pausas da rota e da conexão. As informações de envio estão em “Delivery”.

Se o bot foi silenciado com /mute, envie /unmute. O silenciamento mantém a vinculação e não interrompe o registro dos eventos. Confira também se o bot está bloqueado no Telegram e se as notificações do próprio aplicativo estão permitidas no celular.

Consulte os eventos recentes no painel: /last não está disponível para novas conexões de conta. /unlink desconecta o chat da conta e interrompe os envios por essa conexão, inclusive para os projetos que a usavam. O monitoramento de endereços e os outros canais são mantidos.