Como receber notificações de transações de criptomoedas no Slack

Como conectar o Slack ao Cryptanio, encaminhar eventos do Monitoring para o canal desejado, selecionar recebimentos confirmados e verificar a entrega da mensagem.

Atualizado:

As notificações de transações de criptomoedas podem ser enviadas para um canal escolhido do Slack por uma conexão no painel do Cryptanio. Primeiro, você autoriza o envio de mensagens ao Slack; depois, escolhe quais eventos do projeto chegam ao canal. Para notificações comuns, não é necessário ter servidor próprio nem chave API.

Vamos considerar este cenário: uma equipe acompanha transferências recebidas de USDT em um endereço de trabalho e quer ver os recebimentos confirmados em um único canal. O USDT e a rede da transferência precisam ser escolhidos em conjunto: o mesmo ticker não significa a mesma blockchain.

O que você vai precisar

Você precisa de uma conta do Cryptanio com permissões de proprietário ou administrador, de um projeto com o serviço Monitoring ativo e de acesso ao workspace desejado do Slack. Para um canal privado, a pessoa que conecta o aplicativo já deve fazer parte dele.

A instalação de aplicativos pode exigir a aprovação de um administrador do Slack. Isso depende das regras do workspace, não das configurações da transação. Os requisitos estão nas regras de aprovação de aplicativos do Slack. As regras externas do Slack foram verificadas em 13 de novembro de 2026.

1. Conecte o endereço ao Monitoring

Abra o Monitoring e o projeto desejado. Na lista de endereços, clique em “Adicionar endereços”, escolha a rede e adicione o endereço que quer acompanhar. Para o nosso cenário, configure transferências recebidas e o ativo USDT necessário. Use as opções disponíveis para a rede selecionada.

Confirme que o endereço está ativo e que o serviço está em vigor. O catálogo de endereços serve para guardar registros: cadastrar um endereço nele não ativa o monitoramento. Se o endereço já estiver no catálogo, conecte-o ao Monitoring do projeto escolhido.

Pausar o monitoramento e pausar o envio de mensagens são configurações diferentes. Um canal ativo do Slack não permite receber um evento de um endereço cujo monitoramento foi interrompido.

2. Conecte o canal do Slack

Abra “Configurações” → “Notificações” e a aba Slack. Clique em “Conectar Slack”. O painel redireciona você ao Slack: escolha o workspace e o canal desejados, confira as permissões solicitadas e confirme a conexão.

Depois de voltar ao Cryptanio, confira o nome do workspace e do canal na linha da conexão. Isso ajuda a identificar uma escolha incorreta antes de configurar o projeto. Se necessário, renomeie a conexão para que os colegas entendam sua finalidade.

Se, no lugar do botão, aparecer uma mensagem de que a autorização do Slack está indisponível, a conexão não está configurada no momento para esse ambiente do serviço. Não use endereços retirados de outras instruções: consulte o suporte do Cryptanio sobre a disponibilidade.

3. Verifique a entrega da mensagem

Na linha da conexão, clique em “Teste”. O painel informa que uma notificação de teste foi colocada na fila; aguarde a própria mensagem no canal escolhido do Slack. Depois de um envio bem-sucedido, a última entrega aparece na conexão.

O teste verifica o caminho de entrega de uma mensagem. Ele não cria uma transferência de USDT, não confirma o funcionamento do monitoramento do endereço e não significa que um pedido específico foi pago. Para os eventos do endereço, é necessário o próximo passo.

4. Ative a conexão para o projeto

Abra “Notificações” no projeto desejado. Na parte superior está a configuração “Usar configurações de notificação de conta”. Quando a herança está ativada, o projeto usa os canais da conta e não é possível editar as próprias rotas.

Desative a herança para usar rotas próprias do projeto. Encontre a conexão no cartão Slack. Se a rota não existir, clique no botão com sinal de mais “Usar … para este projeto”; caso contrário, vá direto à seleção de eventos. Se ainda não houver configurações próprias salvas, a mudança copia as rotas compartilhadas. 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.

A conexão da conta e a rota do projeto têm funções diferentes: a primeira define para onde enviar as mensagens; a segunda, de qual projeto vêm os eventos enviados. Para outro canal, use “Ligar outro Slack” nas configurações da conta.

5. Escolha os eventos

Para o nosso cenário, a opção adequada é “Pagamentos confirmados”. Se também for importante ver o cancelamento de um recebimento detectado anteriormente devido a uma reversão da blockchain, escolha “Confirmado e rebolo”. O significado das confirmações está no artigo de referência.

A opção “Todos os eventos do projeto” pode gerar mais mensagens. Para um conjunto específico, use “Escolha tipos de eventos”. Por exemplo, transferências enviadas têm um tipo separado, “Transferência de saída confirmada”; a política de pagamentos confirmados não o inclui automaticamente. O próprio endereço também precisa acompanhar a direção desejada das operações.

As alterações na rota e na seleção de eventos são salvas ao executar cada ação. Confira o resultado e o estado “Ativar”. As notificações de segurança e de pagamento dos serviços da conta na aba “Tipos de notificação” não substituem as configurações de eventos do projeto.

Como verificar o cenário completo

Depois da configuração, aguarde uma nova transação compatível. Localize-a em “Eventos” e depois confira o registro correspondente em “Delivery” e a mensagem no Slack. Não trate uma transação antiga como uma forma garantida de reenviar uma mensagem: ativar a rota, por si só, não reproduz o histórico.

Se o evento existe, mas a mensagem não chegou, confira a política escolhida, a pausa da rota e a pausa geral da conexão. Em “Delivery”, verifique as tentativas e o erro. Se o acesso ao Slack tiver sido revogado ou o canal estiver indisponível, use “Reconectar” e faça o teste novamente.

Limitações e segurança

A conexão usa o mecanismo de incoming webhooks do Slack, vinculado ao canal selecionado. Não publique a URL secreta do webhook; no cenário descrito, o Cryptanio realiza a troca de dados durante a autorização. Para outro canal, crie uma conexão separada e atribua a rota desejada.

Os participantes do canal do Slack determinam quem verá as mensagens de pagamento. Conecte um canal de trabalho com acesso adequado. A mensagem sobre a transferência é destinada à equipe; a execução automática de um pedido pago é configurada separadamente por meio da verificação do webhook e do estado da fatura.