Repository navigation
B47: webhooks do Resend — entregue, bounce e spam - #147
Merged
Merged
Conversation
…o endereço Assinatura Svix verificada com janela de 5 minutos, um registro por svix-id, edição descoberta pelo envio e bounce permanente ou reclamação bloqueando o endereço na edição até a organização liberar.
3 of 4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #96
Hoje um envio fica
sentquando o Resend aceita a mensagem. Com este PR, a plataforma passa a saber se o e-mail chegou, voltou ou foi marcado como spam, e para de mandar para endereço que derruba a reputação do domínio.Como funciona
POST /api/v1/webhooks/resend, comthrottle:webhookse sem login.{svix-id}.{svix-timestamp}.{corpo}com o segredowhsec_…deRESEND_WEBHOOK_SECRET(ADR 0006). Aceita várias assinaturas no cabeçalho, compara em tempo constante e só aceita timestamp a até 5 minutos de agora.email_webhook_events.svix-idememail_webhook_events, com unique no banco. A mesma entrega repetida respondeduplicate: truee não repete o efeito.provider_message_id. O webhook acha o envio por esse id e a edição vem do envio. O que o corpo do webhook manda nunca é usado como edição, e há teste comedition_idforjado no corpo. Envio desconhecido fica registrado comoignored.Status de entrega
email.delivereddelivered+delivered_atemail.bouncedpermanentebounced+bounced_at+ motivo, e bloqueia o endereçoemail.bouncedtemporárioprovider_detail; não bloqueiaemail.delivery_delayedemail.complainedcomplained+complained_at, e bloqueia o endereçoBloqueio do endereço
email_suppressions, por edição, com o motivo e o envio que causou. É auditado comonotifications.address_suppressed.suppressed, com o motivo emprovider_detail.GET /emails/suppressions?q=e libera emDELETE /emails/suppressions/{id}, auditado comonotifications.suppression_lifted. Se o endereço continuar inválido, o próximo bounce bloqueia de novo.GET /emails/deliveries) ganhoustatus_label,provider_detail,delivered_at,bounced_atecomplained_at, e o filtro por status aceita os novos.A tela do painel (status novos e liberar endereço) entra com a A23 (Comunicação), que é a tela de e-mails.
Critérios de aceite
suppressed) até a organização liberar.Para configurar em produção
No painel do Resend, crie um webhook para
https://<api>/api/v1/webhooks/resendcom os eventosemail.delivered,email.bounced,email.delivery_delayedeemail.complained, e coloque o segredowhsec_…emRESEND_WEBHOOK_SECRET.Test plan
composer checkpassa: Pint, PHPStan nível 8, Rector e Pest com 1060 testes (2 pulados, de sandbox). São 8 testes novos emResendWebhookTest.