Per iniziare
Guida rapida
Crea una chiave, verifica un dominio e invia un'email controllata con una richiesta sicura da ritentare.
Prima di iniziare
Crea un workspace SendHQ e tieni aperta la dashboard. I nuovi workspace ricevono una prova di integrazione controllata: finché non è attivo un abbonamento a pagamento, le consegne possono andare solo all'email dell'account o a un indirizzo del simulatore di AWS SES.
1. Crea una chiave API
Apri Chiavi API nella dashboard, scegli un nome descrittivo come Production e copia la chiave quando viene mostrata. Conservala in un secret manager lato server. SendHQ non restituisce mai più il valore completo.
SENDHQ_API_KEY=re_your_key_here2. Aggiungi un dominio di invio
Apri Domini, aggiungi un dominio che controlli e pubblica i record DKIM, SPF, DMARC e di verifica SES restituiti. Chi usa Cloudflare può autorizzare una configurazione DNS una tantum; SendHQ elimina il token OAuth dopo il callback.
include:amazonses.com al valore v=spf1 esistente.3. Attendi la verifica
Usa la dashboard o POST /domains/:id/verify. Il DNS può passare per pending, checking e propagating prima che SES segnali l'identità come verified.
4. Invia un messaggio controllato
curl https://sendhq.cc/api/v1/emails \
-H "Authorization: Bearer $SENDHQ_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: onboarding-user-42" \
-d '{"from":"Acme <hello@example.com>","to":["owner@example.com"],"subject":"SendHQ is connected","html":"<h1>It works</h1><p>Your first controlled message was accepted.</p>","text":"It works. Your first controlled message was accepted."}'Una richiesta riuscita restituisce l'ID email SendHQ, l'ID messaggio del provider e l'ID del thread della conversazione. Salva l'ID SendHQ insieme all'evento applicativo che ha generato l'email.
5. Gestisci gli esiti
Una richiesta API accettata non equivale alla consegna al destinatario. Recupera /emails/:id/events o usa la dashboard per consultare gli eventi di consegna, bounce, segnalazione di spam, rifiuto, apertura e clic.