# Mail

> Tes e-mails, newsletters et formulaires, envoyés depuis ton adresse.

Chaque page existe en Markdown à la même adresse suivie de `.md`. `llms-full.txt` contient toute la documentation en un seul fichier.

## Démarrer

- [Mail](https://mail.hgdc.ch/docs/index.md): Tes e-mails, newsletters et formulaires, envoyés depuis ton propre domaine, suivis du départ à l'ouverture.
- [Premier e-mail](https://mail.hgdc.ch/docs/demarrer/premier-e-mail.md): Du compte vide à un e-mail reçu depuis ton propre domaine, en une dizaine de minutes.
- [Premier envoi depuis Node.js](https://mail.hgdc.ch/docs/demarrer/premier-envoi-node.md): Copier le client Mail, poser ta clé dans une variable d'environnement, envoyer un premier e-mail et gérer la réponse, en TypeScript ou en JavaScript.

## Guides

- [Ajouter un domaine d'envoi](https://mail.hgdc.ch/docs/guides/ajouter-un-domaine.md): Relier ton nom de domaine pour envoyer en ton nom, avec Cloudflare, un fichier de zone ou à la main.
- [Identité visuelle](https://mail.hgdc.ch/docs/guides/identite-visuelle.md): Reprendre le nom, le logo, les couleurs et la police de ton site, puis les retoucher pour tous tes e-mails.
- [Importer des contacts](https://mail.hgdc.ch/docs/guides/importer-des-contacts.md): Ajouter tes contacts depuis un tableur ou un par un, et les ranger en listes.
- [Inviter ton équipe](https://mail.hgdc.ch/docs/guides/inviter-ton-equipe.md): Donner accès à l'espace Mail à tes collaborateurs, et régler leur rôle depuis Account.
- [Ton compte et tes organisations](https://mail.hgdc.ch/docs/guides/ton-compte.md): Se connecter à Mail, changer d'organisation, le thème, la palette de commandes et les raccourcis clavier.
- [Créer une campagne](https://mail.hgdc.ch/docs/guides/creer-une-campagne.md): Écrire une newsletter ou une annonce, la vérifier, puis l'envoyer à une liste.
- [Personnaliser un e-mail](https://mail.hgdc.ch/docs/guides/personnaliser-un-email.md): Construire un message bloc par bloc, le déplacer, le régler, lui donner ta marque.
- [Vérifier les liens et envoyer un essai](https://mail.hgdc.ch/docs/guides/liens-images-et-essais.md): Relire tous les liens d'un message, suivre les visites, et l'essayer dans de vraies boîtes.
- [Modèles](https://mail.hgdc.ch/docs/guides/modeles.md): Garder un message à réutiliser, en faire une campagne ou l'envoyer depuis ton logiciel.
- [Créer un workflow](https://mail.hgdc.ch/docs/guides/creer-un-workflow.md): Poser des étapes sur le tableau, les relier, puis activer un parcours qui envoie tout seul.
- [Déclencher un workflow depuis ton application](https://mail.hgdc.ch/docs/guides/declencher-un-workflow.md): Faire entrer un contact dans un workflow quand quelque chose se passe chez toi, une commande payée ou un essai terminé, en cURL ou avec le SDK.
- [Relancer qui n'a pas ouvert](https://mail.hgdc.ch/docs/guides/relancer-qui-n-a-pas-ouvert.md): Une recette complète, de l'accueil à la relance automatique deux jours plus tard.
- [Créer un formulaire](https://mail.hgdc.ch/docs/guides/creer-un-formulaire.md): Un formulaire de contact ou d'inscription pour ton site, avec son accusé de réception, l'avis à ton équipe et l'ajout aux contacts de qui l'accepte.
- [Recevoir les réponses d'un formulaire par webhook](https://mail.hgdc.ch/docs/guides/recevoir-les-reponses-par-webhook.md): Faire envoyer chaque réponse de formulaire à ton application, signée, sans qu'elle ait besoin d'une clé d'API de Mail.
- [Envoyer depuis ton logiciel](https://mail.hgdc.ch/docs/guides/envoyer-depuis-ton-logiciel.md): Créer une clé d'API et envoyer un premier e-mail depuis ton site, en cURL ou en Node.
- [Envoyer sans doublon](https://mail.hgdc.ch/docs/guides/envoyer-sans-doublon.md): Utiliser l'en-tête Idempotency-Key pour qu'un envoi rejoué après une coupure ne parte pas deux fois, et savoir quand réessayer ou non.
- [Intégrer avec un agent de code](https://mail.hgdc.ch/docs/guides/integrer-avec-un-agent-de-code.md): Donner à Claude Code, Codex ou Cursor tout ce qu'il faut pour brancher l'envoi d'e-mails dans ton application, proprement et sans fuite de clé.
- [Venir de Resend](https://mail.hgdc.ch/docs/guides/venir-de-resend.md): Ce qui reste identique entre Resend et Mail, ce qui change, et la liste à cocher pour basculer ton code sans casser un envoi.
- [Utiliser l'assistant](https://mail.hgdc.ch/docs/guides/utiliser-l-assistant.md): Demander à l'assistant de répondre à une question ou de faire une manipulation à ta place.

## API

- [Introduction à l'API](https://mail.hgdc.ch/docs/reference/api.md): Envoyer des e-mails et gérer tes contacts, listes, campagnes et modèles par HTTP. Authentification, format, pagination et table des routes.
- [API e-mails](https://mail.hgdc.ch/docs/reference/api-emails.md): Envoyer un e-mail, envoyer un lot de 1 à 100 e-mails et lire le statut d'un envoi, avec les champs, les réponses et les exemples.
- [API contacts](https://mail.hgdc.ch/docs/reference/api-contacts.md): Créer, lire, modifier, lister et supprimer des contacts par HTTP, avec leur statut, leurs propriétés et la pagination.
- [API listes](https://mail.hgdc.ch/docs/reference/api-listes.md): Lister et créer les listes de contacts par HTTP, avec leur nombre de contacts. /segments fonctionne comme /lists.
- [API campagnes](https://mail.hgdc.ch/docs/reference/api-campagnes.md): Créer une campagne d'e-mails pour une liste, la lancer tout de suite ou plus tard, et lire son état par HTTP.
- [API modèles](https://mail.hgdc.ch/docs/reference/api-modeles.md): Lister les modèles de ton espace et lire leur contenu, leurs variables et leur expéditeur par défaut, pour les envoyer depuis ton code.
- [API formulaires](https://mail.hgdc.ch/docs/reference/api-formulaires.md): L'adresse publique qui reçoit un formulaire depuis ton site, ses réponses et ses erreurs, et la lecture des formulaires et des réponses avec une clé.
- [Webhooks](https://mail.hgdc.ch/docs/reference/webhooks.md): Le format des messages que Mail envoie à ton application, leurs en-têtes, la signature à vérifier, les reprises et les événements.
- [SDK TypeScript](https://mail.hgdc.ch/docs/reference/sdk.md): Le client TypeScript de Mail, un seul fichier sans dépendance. Constructeur, méthodes, erreurs et réessais automatiques.

## Référence

- [Statuts des e-mails](https://mail.hgdc.ch/docs/reference/statuts-des-e-mails.md): Ce que veut dire chaque statut affiché dans l'application et renvoyé par l'API.
- [Variables](https://mail.hgdc.ch/docs/reference/variables.md): Les variables remplacées pour chaque contact dans l'objet, le texte d'aperçu et le message.
- [Étapes de workflow](https://mail.hgdc.ch/docs/reference/etapes-de-workflow.md): Chaque type d'étape, ses réglages et ses sorties.
- [Limites](https://mail.hgdc.ch/docs/reference/limites.md): Les plafonds de débit, de taille et de nombre, et ce qui se passe quand on les atteint.
- [Erreurs de l'API](https://mail.hgdc.ch/docs/reference/erreurs.md): La forme des erreurs de l'API, leurs codes, leurs causes, et quand réessayer une requête sans risque de doublon.

## Concepts

- [Délivrabilité](https://mail.hgdc.ch/docs/concepts/delivrabilite.md): Pourquoi un e-mail arrive en boîte de réception ou en indésirables, et ce qui dépend de toi.
- [SPF, DKIM et DMARC](https://mail.hgdc.ch/docs/concepts/spf-dkim-dmarc.md): Ce que fait chacun des trois enregistrements d'authentification, pourquoi les messageries les exigent, et comment Mail les pose pour toi.
- [Rebonds et plaintes](https://mail.hgdc.ch/docs/concepts/rebonds-et-plaintes.md): La différence entre un rebond temporaire et un rebond définitif, ce qu'est une plainte, et les seuils qui protègent ton espace.
- [Désabonnement et blocages](https://mail.hgdc.ch/docs/concepts/desabonnement-et-blocages.md): Comment un contact se désabonne, se réabonne, et pourquoi certaines adresses ne reçoivent plus rien.
- [Données et confidentialité](https://mail.hgdc.ch/docs/concepts/donnees-et-confidentialite.md): Où sont tes données, qui peut les voir, et ce que mesure le suivi des ouvertures et des clics.
- [Questions fréquentes](https://mail.hgdc.ch/docs/concepts/questions-frequentes.md): Les questions qui reviennent le plus souvent sur les domaines, l'envoi, la délivrabilité, les contacts et l'accès au compte, avec la réponse courte et le lien vers le détail.