Thanks for your order.
" } ] }' ``` ```bash title="After: Emailit" curl https://api.emailit.com/v2/emails \ -H "Authorization: Bearer $EMAILIT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "AcmeThanks for your order.
" }' ``` | SendGrid | Emailit | | --- | --- | | `Authorization: Bearer SG.…` | `Authorization: Bearer secret_…` | | `from: { email, name }` | `from: "Name "` | | `personalizations[].to[]` | `to`, une chaîne ou un tableau de 50 adresses au maximum | | `personalizations[].cc[]`, `bcc[]` | `cc`, `bcc` | | `reply_to: { email }` | `reply_to` | | `subject` | `subject` | | `content[]` avec `text/plain` et `text/html` | `text` et `html` | | `template_id` | `template`, un ID ou un alias de modèle | | `personalizations[].dynamic_template_data` | `variables` | | `attachments[]` avec `content`, `filename`, `type`, `content_id` | `attachments[]` avec `content`, `filename`, `content_type`, `content_id`, ou une `url` à la place de `content` | | `headers` | `headers` | | `custom_args`, `categories` | `meta`, un objet de valeurs de type chaîne renvoyé dans les événements webhook | | `send_at` (horodatage Unix) | `scheduled_at`, qui accepte le même horodatage Unix, le format ISO 8601 ou de l’anglais courant | | `tracking_settings.open_tracking` et `click_tracking` | `tracking: { "loads": true, "clicks": true }` | | `asm` (unsubscribe groups) | Non disponible | | `202 Accepted` avec un en-tête `X-Message-Id` | `200` avec un corps JSON : `id`, `status: "accepted"`, et `ids` avec un ID par destinataire | Chaque destinataire d’une requête Emailit devient un e-mail distinct avec son propre ID. Pour envoyer des variables différentes à différentes personnes, ce que SendGrid fait avec plusieurs `personalizations`, envoyez une requête par destinataire. Ajoutez un en-tête `Idempotency-Key` pour sécuriser les relances. Consultez [Envoyer un e-mail](/fr/docs/email-api/send-email/). ## Changer les paramètres SMTP | Paramètre | SendGrid | Emailit | | --- | --- | --- | | Hôte | `smtp.sendgrid.net` | `smtp.emailit.com` | | Port | `587`, `465`, `2525` ou `25` | `587` (STARTTLS), `465` (TLS), `2525`, `2587` ou `25` | | Nom d’utilisateur | `apikey` | `emailit` | | Mot de passe | Votre clé API SendGrid | Votre clé API Emailit | Emailit ne lit pas l’en-tête `X-SMTPAPI`. Supprimez-le et réglez plutôt le suivi au niveau du domaine. Consultez [Paramètres SMTP](/fr/docs/smtp/settings/). ## Faire correspondre les événements webhook | Événement SendGrid | Événement Emailit | | --- | --- | | `processed` | `email.accepted` (API uniquement) | | `deferred` | `email.attempted` | | `delivered` | `email.delivered` | | `bounce` | `email.bounced` | | `dropped` | `email.suppressed` quand le destinataire figure dans la liste d’adresses bloquées | | `open` | `email.loaded` | | `click` | `email.clicked` | | `spamreport` | `email.complained` | | `unsubscribe`, `group_unsubscribe` | `email.unsubscribed`, pour les e-mails de campagne uniquement | | POST Inbound Parse | `email.received`, puis récupérez le contenu avec [`GET /emails/{id}`](/fr/docs/api-reference/emails/get/) | Comme SendGrid, Emailit envoie (POST) un tableau JSON d’événements. Les champs diffèrent : - Le nom de l’événement se trouve dans `type`, et l’e-mail dans `data.object`. Utilisez `data.object.id` (l’ID `em_` de la réponse d’envoi) au lieu de `sg_message_id`, et `data.object.to` au lieu de `email`. - Vos valeurs `meta` reviennent dans `data.object.meta`. - Emailit signe les requêtes avec HMAC-SHA256 au lieu de la clé publique ECDSA de SendGrid. Vérifiez `X-Emailit-Signature` avec votre secret `whsec_`. Consultez [Signature des requêtes](/fr/docs/webhooks/request-signature/). ```javascript for (const event of req.body) { const email = event.data.object; if (event.type === 'email.bounced') markBounced(email.to, email.id); if (event.type === 'email.complained') unsubscribe(email.to); } ``` ## Transférer les adresses bloquées 1. Dans SendGrid, exportez vos **Bounces**, **Spam Reports**, **Invalid Emails** et **Global Unsubscribes**, depuis les pages Suppressions ou avec les endpoints API `/v3/suppression/*`. Les Blocks sont généralement temporaires : vous pouvez les laisser de côté. 2. Constituez un seul CSV avec les colonnes `email,type,reason` : ```csv email,type,reason old-address@example.com,recipient,sendgrid bounce angry@example.com,recipient,sendgrid spam report ``` Utilisez le type `recipient` pour les adresses qui ne doivent jamais recevoir d’e-mail. Il bloque les envois par l’API, par SMTP et par les campagnes. Les types `bounce`, `complaint` et `unsubscribe` n’arrêtent que les campagnes. 3. Dans **Email API → Suppressions**, sélectionnez **Import** et chargez le fichier. Chaque fichier peut contenir 10 000 lignes et peser 8 Mo au maximum : découpez donc les listes plus longues. Les doublons sont ignorés. Pour les désinscriptions de groupe des e-mails marketing, importez ces personnes comme contacts avec **unsubscribed** activé, plutôt que de les bloquer pour tous les e-mails. Consultez [Gérer les adresses bloquées](/fr/docs/suppressions/manage/). ## Transférer les modèles Exportez le HTML de chaque modèle dynamique depuis SendGrid, puis importez-le dans **Email Marketing → Templates** ou créez-le avec l’[API des modèles](/fr/docs/api-reference/templates/create/). Donnez à chaque modèle un alias, comme `receipt`, et envoyez-le avec `"template": "receipt"`. Les deux utilisent des doubles accolades, mais Temple est plus restreint que Handlebars : | SendGrid (Handlebars) | Emailit (Temple) | | --- | --- | | `{{first_name}}` | `{{first_name}}` | | `{{{html_block}}}` | `{{html_block}}`. Temple n’échappe jamais le HTML : échappez vous-même les saisies des utilisateurs. | | `{{insert name "default=there"}}` | `{{name\|"there"}}` | | `{{#if plan}}…{{else}}…{{/if}}` | Identique | | `{{#each items}}…{{/each}}` | Non pris en charge. Générez la liste dans votre code et transmettez-la comme une seule variable. | | `{{#equals plan "pro"}}…{{/equals}}` | Non pris en charge. Transmettez un booléen comme `is_pro` et utilisez `{{#if is_pro}}`. | Consultez [Temple](/fr/docs/templates/temple/) et [Importer et exporter des modèles](/fr/docs/templates/import-export/). ## Modifier le DNS Ajoutez votre domaine dans **Email API → Domains** et publiez les enregistrements Emailit. Ils utilisent leurs propres noms (`emailit._domainkey`, `emailit.