Recevoir des e-mails
Lisez vos e-mails avec l'API
Lisez les e-mails qui arrivent sur votre domaine depuis votre propre code. Listez les conversations, ouvrez les messages, recherchez, libellez, organisez, envoyez et répondez, le tout via un seul endpoint.
- REST
- JSON
- Fils et recherche
- Libellés et dossiers
- Envoyer et répondre
https://g.sendcorex.comFonctionnement
Un token, une boîte aux lettres
Votre token appartient à un expéditeur, et un expéditeur est une boîte aux lettres. Aucun argument ne choisit les e-mails de qui vous lisez : c'est le token qui décide.
Un endpoint pour tout
Lister, lire, rechercher, marquer, déplacer, envoyer et répondre sont des commandes envoyées à POST /v1. Envoyez-en jusqu'à 20 par requête.
Tokens à durée de vie courte
L'access token est valable 1 heure et le refresh token 15 jours. Le refresh token change à chaque utilisation.
Configurez votre boîte aux lettres
À faire une seule fois. Ensuite, chaque requête n'a besoin que de votre token.
- 1
Ajoutez un domaine ou utilisez un domaine partagé
Vérifiez votre propre domaine, ou évitez la configuration DNS en utilisant un domaine partagé.
- 2
Créez un expéditeur
Un expéditeur est une boîte aux lettres. Créez-en un sur votre domaine vérifié ou sur un domaine partagé : sur un domaine partagé, créer l'expéditeur crée la boîte aux lettres.
Si vous avez enregistré votre propre domaine et déjà envoyé un e-mail, l'expéditeur a été créé automatiquement pour vous.
- 3
Pointez votre enregistrement MX
Nécessaire uniquement si vous voulez recevoir des e-mails sur votre propre domaine. Pointez l'enregistrement MX vers l'hôte entrant de Sendcorex.
- 4
Générez vos tokens
Ouvrez le webmail, allez dans Paramètres et générez un access token et un refresh token pour l'expéditeur.
- 5
Appelez l'API
Envoyez votre token dans le header Authorization et votre première commande à POST /v1.
Enregistrement MX
Pour recevoir des e-mails sur votre propre domaine, son enregistrement MX doit pointer vers l'hôte entrant de Sendcorex. Ajoutez cet enregistrement chez votre fournisseur DNS.
- Type
MX - Pointe vers
bounce.emailsbit.com
L'enregistrement MX ne sert qu'à recevoir sur votre propre domaine. Sans lui, vous pouvez toujours envoyer, et lire les bounces et les plaintes qui reviennent dans votre boîte aux lettres.
Ce qui arrive dans la boîte aux lettres
E-mails ordinaires
Tout ce qui est envoyé à l'adresse de votre expéditeur, comme dans n'importe quelle boîte aux lettres.
Messages du return path
Les bounces et autres messages qui reviennent au return path sont aussi enregistrés dans la boîte aux lettres, vous pouvez donc les lire via l'API.
Plaintes
Les plaintes pour spam sont aussi enregistrées dans la boîte aux lettres. Elles ne proviennent que de Microsoft 365 et des services Microsoft en général.
Votre première requête
Listez les conversations non lues de votre INBOX. Remplacez SENDCOREX_TOKEN par l'access token des paramètres du webmail.
curl -X POST 'https://g.sendcorex.com/v1' \
-H "Authorization: $SENDCOREX_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
]
}'Chaque fil a un last_message_uid. Passez-le à Obtenir des messages pour lire l'e-mail, ou à Répondre pour y répondre.
Référence complète
Tout ce qui est marqué CMD est une commande envoyée via POST /v1, jusqu'à 20 par requête. Les routes utilisent leurs propres chemins.
Routes
4Identité
1Dossiers et compteurs
5Lecture
5Indicateurs et libellés
8- CMDDéfinir les indicateursLu, suivi, important
- CMDAjouter des libellésLibellés insensibles à la casse
- CMDRetirer des libellésLibellés insensibles à la casse
- CMDMarquer les images comme chargéesEfface l'indicateur d'images externes
- CMDLister les libellésNoms et couleurs
- CMDCréer un libelléNouveau libellé
- CMDChanger la couleur d'un libelléChange la couleur
- CMDSupprimer un libelléDe tous les messages
Organiser
4Envoi et confiance
9- CMDEnvoyer un e-mailNouveau message, enregistré dans Envoyés
- CMDRépondreMême conversation, garde les libellés
- CMDObtenir la confianceStatut de confiance d'un expéditeur
- CMDDéfinir la confiancePar défaut, fiable ou non fiable
- CMDLister la confianceExpéditeurs avec une décision
- CMDTransférerPièces jointes d'origine incluses
- CMDObtenir le suiviOuvertures et clics des e-mails envoyés
- CMDLister l’activitéQui a ouvert, cliqué ou s’est désinscrit
- CMDCompteurs d’activitéPastilles des dossiers Activité
Pièces jointes
4Programmation
3Brouillons
5Règles
10- CMDLister les règlesDans l'ordre d'exécution, avec les correspondances
- CMDObtenir une règleUne règle
- CMDCréer une règleFiltres pour chaque nouvel e-mail
- CMDMettre à jour une règleRemplace la règle
- CMDSupprimer une règleSupprime une règle
- CMDActiver ou désactiver une règleActivée ou désactivée
- CMDRéordonner les règlesOrdre d'exécution
- CMDOptions des règlesChamps, opérateurs, actions
- CMDTester une règleEssai à blanc sur les e-mails récents
- CMDAppliquer une règleS'exécute sur les e-mails déjà présents
Templates
6Contact et relance
5Contacts et audience
12- CMDLister les contactsPersonnes qui échangent avec cette boîte
- CMDCompter les contactsCombien de personnes correspondent à un filtre
- CMDVoir un contact de la boîteUn contact avec compteurs et confiance
- CMDModifier le nom du contactChanger le nom d’un contact
- CMDTaguer un contactAjouter ou retirer des tags
- CMDVoir l’historique du contactOuvertures, clics et emails d’un contact
- CMDLister les segmentsSegments enregistrés de la boîte
- CMDEnregistrer un segmentCréer ou modifier un segment
- CMDSupprimer un segmentSupprimer un segment
- CMDVoir l’audienceTaille d’une audience avant l’envoi
- CMDVérifier les destinatairesQui s’est désinscrit, avant l’envoi
- CMDVoir le statut de remiseRemise par destinataire d’un email envoyé