Como verificar a entrega de uma notificação e reenviá-la

Se o evento já apareceu no Cryptanio, mas a mensagem não chegou, abra “Delivery”: ali você encontra o canal, as tentativas e o resultado do envio. Uma entrega concluída pode ser reenviada. Isso cria um novo registro de entrega do mesmo evento; o original permanece no histórico. Nenhuma nova transferência ou evento da blockchain é criado.

Considere esta situação: o servidor da loja deixou de aceitar webhooks temporariamente e depois voltou a funcionar. É preciso encontrar o envio que falhou e transmitir a notificação outra vez. A mesma verificação serve para mensagens em aplicativos de comunicação, embora um envio bem-sucedido não comprove que alguém leu a mensagem.

O que você vai precisar

Você precisa de acesso à conta e ao projeto corretos. Um membro com acesso de leitura pode consultar o histórico; reenviar exige permissão para alterar dados. Tenha o horário do evento, o projeto e o canal. Para um webhook, é útil ter o event_id do registro do seu aplicativo. Ele identifica o evento, não o TXID da transferência.

Se o canal ainda não estiver conectado, siga primeiro a instrução correspondente: Telegram, Discord ou Slack. Aqui verificamos uma entrega já configurada.

1. Encontre primeiro o evento

Abra “Eventos” e confirme que a transferência desejada está registrada no projeto esperado. Compare a rede, o endereço, o ativo, a direção e o identificador da transação. Uma transferência de entrada detectada e uma confirmada são estados diferentes, que podem ter notificações separadas.

Se o evento não existe, reenviar uma entrega não o recupera da blockchain. Confira as regras e a atividade do monitoramento, o estado do serviço e o projeto selecionado. O guia sobre várias carteiras explica como conectar os endereços.

2. Encontre o registro em Delivery

Abra “Delivery”. Selecione “Canal” e “Projeto” e, se necessário, defina a data inicial no campo “De hoje em diante”. Se souber o event_id exato, informe-o em “Identificação do evento”. Clique em “Filtros de aplicação” para aplicar os filtros. Na visualização de um projeto específico, o escopo do projeto já está definido.

Confira o estado do registro: “Em voo” indica um envio em andamento, “Falhou” uma falha e “Entregado” uma entrega realizada. Clique em “Abrir” para ver “Detalhes da entrega”: número de tentativas, “Última resposta” e horários de entrada na fila e conclusão. Em caso de erro, a descrição fica disponível. Um mesmo ID de evento pode ter várias entregas para canais diferentes.

A ausência de um código HTTP, por si só, não comprova uma falha: o resultado depende do canal. Para um webhook, compare a resposta com o registro do seu servidor. O campo de destino pode estar protegido e não mostrar o endereço completo que contém um segredo.

3. Corrija a causa antes de reenviar

Confira a disponibilidade do receptor, as permissões do aplicativo ou o acesso ao canal. Para um aplicativo de mensagens, verifique as pausas da conexão e da rota; se a autorização foi revogada, use “Reconectar” onde esse botão estiver disponível. O teste da conexão envia uma mensagem de serviço separada e não repete o pagamento escolhido.

Para um webhook, confirme que o receptor verifica a assinatura e salva corretamente os eventos aceitos. Veja o guia de confirmação automática de pedidos. Reenviar não corrige um erro no código do destinatário.

4. Coloque outra entrega na fila

Em um registro concluído, clique em “Reenviar”. No diálogo “Reenviar a notificação?”, confirme pelo botão “Entrar outra entrega”, que coloca outra entrega na fila. Enquanto o registro estiver no estado “Em voo”, ou seja, em andamento, o reenvio fica indisponível: aguarde o envio atual em vez de criar envios concorrentes.

O Cryptanio cria um novo ID de entrega e mantém o ID anterior do evento e seu conteúdo salvo. O registro original e seu resultado não são sobrescritos. Também é possível repetir uma entrega bem-sucedida; por isso, a ação pode criar uma duplicata para o destinatário. Emails de uso único com links de acesso não podem ser reenviados dessa forma.

Isso repete uma notificação antiga; não consulta o estado mais recente da fatura nem transfere automaticamente a mensagem para outro canal. Alterar uma rota não recria o conteúdo de um evento antigo.

5. Confira o novo registro

Atualize a lista e encontre a nova entrega do mesmo evento. Aguarde o resultado: estar na fila ainda não significa sucesso. Se houver outra falha, leia a nova causa e confira o destinatário em vez de repetir o mesmo clique várias vezes.

O receptor da loja deve salvar event_id e impedir a entrega duplicada do produto. Mesmo após uma entrega bem-sucedida, a execução do pedido exige o estado atual da fatura. “Entregado” confirma o resultado do envio da notificação, não o pagamento do pedido, a leitura por uma pessoa ou a execução das ações pelo seu aplicativo.