Cloudflare Email Service

Qu'est-ce que Cloudflare Email Service ?

Cloudflare Email Service est une couche d'infrastructure pour créer des agents et applications natifs email. Elle permet aux agents d'envoyer, recevoir et traiter des e-mails en utilisant les composants de la plateforme développeurs Cloudflare, pour utiliser la boîte de réception comme interface plutôt que de créer des canaux séparés ou des intégrations personnalisées.

Le service est conçu pour fonctionner avec Cloudflare Agents SDK et les hooks d'agents de type onEmail. Avec Email Routing pour les messages entrants et Email Sending pour les réponses/notifications sortantes, les développeurs peuvent implémenter des workflows email bidirectionnels dans le même environnement Cloudflare.

Fonctionnalités principales

• Email Routing (e-mail entrant vers votre app/agent) : Recevez des e-mails et routez-les vers votre application ou agent pour traitement, activant un modèle d'interaction basé sur la boîte de réception.
• Email Sending (e-mail transactionnel sortant) : Envoyez des réponses ou notifications depuis votre agent/application vers les utilisateurs en délivrant des messages déclenchés dans le cadre de travaux asynchrones.
• Liaison Workers pour Email Sending (bêta publique) : Envoyez des e-mails directement depuis Workers via une liaison native env.EMAIL.send(...) — sans gestion de clés API ou secrets.
• REST API + SDKs pour Email Sending : Envoyez des e-mails depuis n'importe quelle plateforme ou langage via l'API REST Cloudflare, avec support des SDK TypeScript, Python et Go.
• Configuration automatique d'authentification de domaine (SPF/DKIM/DMARC) : Lors de l'ajout de votre domaine à Email Service, Cloudflare configure SPF, DKIM et DMARC pour que les messages soient authentifiés et délivrés, sans configuration manuelle.
• Livraison globale sur le réseau Cloudflare : Email Service est un service global basé sur le réseau Cloudflare pour une livraison à faible latence dans le monde entier.
• Workflows bidirectionnels complets avec Email Routing + Email Sending : Recevez un e-mail, traitez-le dans un Worker et répondez sans quitter Cloudflare.

Comment utiliser Cloudflare Email Service

1. Commencez avec Email Routing pour les messages entrants : Configurez votre agent pour recevoir des e-mails via le hook onEmail du Agents SDK (de première classe pour les e-mails entrants).
2. Utilisez Email Sending pour répondre de manière asynchrone : Pendant la bêta publique, ajoutez Email Sending pour permettre à votre agent d'envoyer des réponses ou notifications sortantes après traitement.
3. Envoyez depuis Workers via la liaison native : Dans votre Worker, appelez env.EMAIL.send avec to, from, subject et contenu du corps d'e-mail.
4. Alternativement, envoyez via REST API et SDKs : Utilisez l'endpoint send de Cloudflare Email Service pour l'envoi côté serveur ou multiplateforme, avec SDKs disponibles (TypeScript, Python, Go).
5. Ajoutez et authentifiez votre domaine d'envoi : Configurez votre domaine dans Email Service pour que Cloudflare mette en place SPF, DKIM et DMARC automatiquement.

Cas d'usage

• Workflow de boîte de réception pour agent support client : Utilisez Email Routing pour recevoir les messages clients, persistez les données de ticket pendant le traitement dans un agent/Worker, et envoyez une réponse asynchrone après achèvement des tâches en arrière-plan.
• Traitement de factures et notifications utilisateur : Créez un pipeline de factures qui reçoit des e-mails entrants (ex. documents ou demandes) et envoie plus tard des notifications de statut ou « terminé » aux utilisateurs une fois le travail fini.
• Flux de vérification de compte : Implémentez des interactions de vérification où l'e-mail est le canal principal面向 utilisateur, y compris l'envoi de messages de vérification depuis la logique d'agent.
• Workflows multi-agents avec escalade et suivi : Coordonnez le travail entre systèmes, programmez des e-mails de suivi et escaladez les cas limites via e-mail sortant une fois les conditions détectées.
• Extension multi-canal d'agent sans nouvelles UI client : Quand les utilisateurs consultent déjà leurs e-mails, exposez l'agent via la boîte de réception au lieu de créer une interface chat personnalisée par canal.

FAQ

• Email Service est-il réservé aux Agents ? Non. La source décrit Email Service comme une couche de la plateforme développeur qui permet aux applications et agents d'envoyer des e-mails pendant la bêta publique.

• Comment recevoir des e-mails des utilisateurs ? La source renvoie à Email Routing pour recevoir les e-mails vers votre application ou agent, qui fonctionne avec le traitement agent sur Cloudflare.

• Les agents peuvent-ils envoyer des e-mails après un travail long ou asynchrone ? Oui. La source oppose les réponses synchrones de type chatbot au comportement des agents qui peuvent traiter le travail dans le temps puis répondre de manière asynchrone via Email Sending.

• Dois-je gérer manuellement les enregistrements SPF, DKIM et DMARC ? La source indique que lorsque vous ajoutez votre domaine à Email Service, Cloudflare configure automatiquement SPF, DKIM et DMARC.

• Comment envoyer des e-mails depuis un Worker ? Utilisez la liaison native Workers décrite dans la source : env.EMAIL.send({ to, from, subject, text }).

Alternatives

• Construire une intégration e-mail personnalisée avec un fournisseur externe : Si vous préférez gérer l'envoi vous-même, vous pouvez utiliser des API e-mail tierces et gérer les entrées via votre propre routage, mais vous devrez construire plus du workflow de bout en bout en dehors de la couche routage/envoi de Cloudflare.
• Utiliser un service dédié de parsing/routage e-mail avec un backend agent séparé : Au lieu de l'Email Routing + Email Sending intégré de Cloudflare, vous pouvez router les e-mails entrants via un autre fournisseur et faire générer les e-mails sortants par votre backend.
• Utiliser des interfaces chat ou ticketing au lieu de workflows natifs e-mail : Pour les équipes axées sur l'interaction temps réel, un système chat/ticketing peut remplacer l'e-mail comme interface principale, mais vous perdez l'expérience inbox décrite dans la source.
• Implémenter uniquement l'e-mail transactionnel sortant (sans routage entrant) : Si vous n'avez besoin que de notifications, vous pouvez utiliser une API e-mail sortante sans construire le workflow bidirectionnel réception-réponse.