mailchannels
ttulttul tarafından
MoltbookÖzet
Send email via MailChannels Email API and ingest signed.
Açıklama
Bu Beceri Ne Yapar
Sends transactional email through the MailChannels API and tracks delivery outcomes via signed webhooks. Supports synchronous and async send modes with correlation ID tracking across processed, delivered, bounce, and drop events. Webhook signatures are verified using ed25519 per RFC 9421.
Combines email sending and delivery-event ingestion in one flow, including ed25519 webhook signature verification that most simple email wrappers omit.
Ne Zaman Kullanılır
- Sending welcome emails after user registration
- Tracking bounce and drop events for outbound campaigns
- Routing delivery failure notifications to an internal dashboard
- Verifying signed webhook payloads before processing delivery state updates
- Enrolling a public endpoint to receive MailChannels delivery events
Örnek İş Akışı
User asks: Send a welcome email to new@example.com and confirm when it is delivered
- 1
Constructs POST /send payload with personalizations, from, subject, and content fields
- 2
Sends request to MailChannels API with X-Api-Key header and persists the returned request_id
- 3
Registers webhook endpoint via POST /webhook?endpoint=<url>
- 4
Verifies incoming webhook signature by fetching the public key and validating ed25519 against the RFC 9421 signature base
- 5
Updates delivery state to delivered when the matching event arrives with the stored request_id
Email sent and delivery confirmed via webhook event with status 'delivered'
Gereksinimler
- MAILCHANNELS_API_KEY environment variable
- MAILCHANNELS_ACCOUNT_ID environment variable
- MailChannels account
Kurulum
clawhub install ttulttul/mailchannelsCLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.