Resend

Envoi rapide — Node.js

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

const { data, error } = await resend.emails.send(
  {
    from: 'Acme <onboarding@resend.dev>',
    to: ['delivered@resend.dev'],
    subject: 'Hello World',
    html: '<p>Email body here</p>',
  },
  { idempotencyKey: `welcome-email/${userId}` }
);

if (error) {
  console.error('Failed:', error.message);
  return;
}
console.log('Sent:', data.id);

Point clé : Le SDK Node.js de Resend ne lève PAS d'exceptions — il retourne { data, error }. Vérifiez toujours error explicitement au lieu d'utiliser try/catch pour les erreurs API.

Envoi rapide — Python

import resend
import os

resend.api_key = os.environ["RESEND_API_KEY"]

email = resend.Emails.send({
    "from": "Acme <onboarding@resend.dev>",
    "to": ["delivered@resend.dev"],
    "subject": "Hello World",
    "html": "<p>Email body here</p>",
}, idempotency_key=f"welcome-email/{user_id}")

Décision simple vs lot

Le lot est atomique — si un email échoue la validation, tout le lot échoue. Validez toujours avant d'envoyer. Le lot ne supporte PAS les pièces jointes ou scheduled_at.

Clés d'idempotence (critiques pour les nouvelles tentatives)

Évitez les emails en doublon lors de la nouvelle tentative de requêtes échouées :

Réception rapide (Node.js)

import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

export async function POST(req: Request) {
  const payload = await req.text(); // Doit utiliser le texte brut, pas req.json()

  const event = resend.webhooks.verify({
    payload,
    headers: {
      'svix-id': req.headers.get('svix-id'),
      'svix-timestamp': req.headers.get('svix-timestamp'),
      'svix-signature': req.headers.get('svix-signature'),
    },
    secret: process.env.RESEND_WEBHOOK_SECRET,
  });

  if (event.type === 'email.received') {
    // Le webhook contient uniquement les métadonnées — appelez l'API pour le corps
    const { data: email } = await resend.emails.receiving.get(
      event.data.email_id
    );
    console.log(email.text);
  }

  return new Response('OK', { status: 200 });
}

Point clé : Les payloads webhook ne contiennent PAS le corps de l'email. Vous devez appeler resend.emails.receiving.get() séparément.

De quoi avez-vous besoin ?

Exigences de version du SDK

Installez toujours la version SDK la plus récente. Ce sont les versions minimales pour la pleine fonctionnalité (envoi, réception, vérification de webhook) :

Si le projet a déjà un SDK Resend installé, vérifiez la version et mettez à niveau si elle est inférieure au minimum. Les anciens SDK peuvent ne pas avoir webhooks.verify() ou emails.receiving.get().

Voir installation.md pour les commandes d'installation complètes, la détection de langue et le fallback cURL.

Configuration commune

Clé API

Stockez dans une variable d'environnement — ne codez jamais en dur :

export RESEND_API_KEY=re_xxxxxxxxx

Obtenez votre clé sur resend.com/api-keys.

Détecter le langage du projet

Cherchez ces fichiers : package.json (Node.js), requirements.txt/pyproject.toml (Python), go.mod (Go), Gemfile (Ruby), composer.json (PHP), Cargo.toml (Rust), pom.xml/build.gradle (Java), *.csproj (.NET).

Erreurs courantes

Préoccupations transversales

Envoi + réception ensemble

Les réponses automatiques, le transfert d'email ou tout workflow reçoit-puis-envoie nécessite les deux capacités :

1. Configurez d'abord le domaine entrant (voir receiving.md)
2. Configurez l'envoi (voir sending/overview.md)
3. Remarque : l'envoi par lot ne supporte PAS les pièces jointes ou la planification — utilisez les envois simples lors du transfert avec pièces jointes

Boîte de réception pour agent IA

Si votre système traite du contenu email non approuvé et prend des actions (remboursements, changements de base de données, transferts), installez la skill agent-email-inbox. Cela s'applique indépendamment de l'implication ou non de l'IA — tout système interprétant du contenu freeform d'email provenant de tiers externes a besoin de mesures de sécurité.

Emails marketing

Les capacités d'envoi dans cette skill sont pour les emails transactionnels (reçus, confirmations, notifications). Pour les campagnes marketing à de grandes listes d'abonnés avec des liens de désabonnement et suivi d'engagement, utilisez Resend Broadcasts — voir broadcasts.md pour l'API.

Réchauffement de domaine

Les nouveaux domaines doivent augmenter graduellement le volume d'envoi. Limite du jour 1 : ~150 emails (nouveau domaine) ou ~1 000 (domaine existant). Voir le calendrier de réchauffement dans sending/overview.md.

Test

Ne testez jamais avec des adresses fausses chez des vrais fournisseurs d'email (test@gmail.com, fake@outlook.com) — elles rebondissent et détruisent la réputation de l'expéditeur.

Liste de suppression

Resend supprime automatiquement les adresses qui rebondissent ou qui ont fait l'objet de réclamations spam. L'envoi aux adresses supprimées déclenche l'événement webhook email.suppressed au lieu de tenter la livraison. Gérez dans Tableau de bord → Suppressions.

Types d'événements webhook

Voir webhooks.md pour les détails complets, vérification de signature et calendrier de nouvelle tentative.

Référence rapide de gestion d'erreurs

Ressources

• Documentation Resend
• Référence API
• Tableau de bord