Mailgun (préversion)
Mailgun fournit des API puissantes pour envoyer, recevoir, suivre et stocker des e-mails. Utilisez ce connecteur pour automatiser la remise des e-mails et les flux de travail de communication sans écrire de code.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Class | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Canal de support |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Sinch Suède AB |
| Website | https://www.mailgun.com |
| Politique de confidentialité | https://www.mailgun.com/legal/privacy-policy/ |
| Categories | Marketing; Ventes et CRM |
Nom du connecteur
Mailgun
Résumé du connecteur
Le connecteur Mailgun permet à Power Automate utilisateurs d’envoyer des e-mails, de récupérer des informations de domaine Mailgun, de valider des adresses e-mail individuelles, d’envoyer des travaux de validation de courrier en bloc et de récupérer les résultats de validation en bloc à l’aide de leur compte Mailgun.
Contact
URL du contact : https://help.mailgun.com/hc/en-us
Adresse e-mail du support/contact : support@mailgun.com
URL d’inscription : https://signup.mailgun.com/
Exigences
- Un compte Mailgun. Si vous n’en avez pas, inscrivez-vous à https://signup.mailgun.com/.
- Une clé API Mailgun ou une clé d’envoi de domaine.
- Région d’API Mailgun correcte pour votre compte : États-Unis ou UE.
- Pour l’envoi d’e-mails, un domaine d’envoi Mailgun. L’envoi de production nécessite un domaine vérifié.
- Pour les actions de validation, accédez à Mailgun Validate.
Les domaines de bac à sable peuvent être utilisés pour les tests initiaux, mais sont limités aux destinataires autorisés.
Comment obtenir des informations d’identification
Ce connecteur utilise l’authentification par clé API Mailgun. Connectez-vous au Panneau de configuration Mailgun et créez une clé API à partir de la sécurité des API, ou créez une clé API d’envoi spécifique au domaine à partir de vos paramètres de domaine d’envoi.
Le connecteur utilise l’authentification de base avec api le nom d’utilisateur et la clé d’API Mailgun comme mot de passe. Lors de la configuration de la connexion, sélectionnez la région de l’API Mailgun qui correspond à votre compte.
Opérations prises en charge
Ce connecteur prend en charge les opérations suivantes :
-
Send Email: envoyez un e-mail à l’aide d’un domaine d’envoi Mailgun. -
Get Domain Information: Récupérer les informations de domaine Mailgun. -
Validate Email Address: Valider une adresse e-mail individuelle. -
Submit Bulk Validation Job: envoyez un travail de validation de courrier en bloc. -
Get Bulk Validation Results: Récupérer les résultats de validation de courrier en bloc.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Valeur par défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Description | Required |
|---|---|---|---|
| Clé API | Securestring | Clé API privée Mailgun | True |
| Région mailgun | corde | Sélectionner Mailgun US ou Mailgun EU | True |
Actions
| Envoyer un courrier électronique |
Envoie un e-mail à l’aide de votre compte Mailgun via des champs de formulaire multipart compatibles avec l’API messages de Mailgun. |
| Obtenir des domaines |
Obtenez la liste des domaines. Peut être filtré par état ou autorité. La liste est paginé et limitée à 1 000 éléments par page. |
| Obtenir les détails du domaine |
Récupère la représentation JSON d’un domaine qui inclut des détails sur l’état et les paramètres du domaine. |
| Obtenir les résultats de la validation en bloc |
Récupère l’état du travail de validation en bloc et les résultats récapitulatives d’un travail précédemment soumis. |
| Validation par e-mail en bloc |
Chargez un fichier CSV avec une colonne d’en-tête d’e-mail et démarrez un travail de validation en bloc à l’aide de l’API V4 de Mailgun. |
| Valider l’e-mail |
Valide une adresse e-mail à l’aide du service de validation de Mailgun et retourne des résultats de remise. |
Envoyer un courrier électronique
Envoie un e-mail à l’aide de votre compte Mailgun via des champs de formulaire multipart compatibles avec l’API messages de Mailgun.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de domaine
|
domain_name | True | string |
Domaine à partir duquel envoyer l’e-mail à partir de |
|
À partir de l’adresse e-mail
|
from | True | string |
L’adresse e-mail du message est envoyée. |
|
À l’adresse e-mail
|
to | True | string |
Adresse de courrier du destinataire. |
|
Sujet
|
subject | True | string |
Objet de l’e-mail. |
|
Corps de l’e-mail (texte)
|
text | string |
Corps de texte brut de l’e-mail. |
|
|
Corps de l’e-mail (HTML)
|
html | html |
Corps HTML de l’e-mail. |
|
|
Adresse e-mail CC
|
cc | string |
Adresse e-mail du destinataire de copie carbone. |
|
|
Adresse e-mail BCC
|
bcc | string |
Adresse e-mail du destinataire de copie carbone aveugle. |
|
|
adresse e-mail Reply-To
|
h:Reply-To | string |
Où les réponses doivent être remises. |
|
|
Pièce jointe
|
attachment | file |
Pièce jointe de fichier à inclure avec le message. |
|
|
Tags
|
o:tag | array |
Une ou plusieurs balises pour regrouper et filtrer les e-mails dans Mailgun (jusqu’à 10 par message). |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de message
|
id | string |
Identificateur unique affecté au message mis en file d’attente |
|
Message d’état
|
message | string |
État lisible par l’homme à partir de Mailgun (par exemple, Mis en file d’attente. Merci.) |
Obtenir des domaines
Obtenez la liste des domaines. Peut être filtré par état ou autorité. La liste est paginé et limitée à 1 000 éléments par page.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Limite
|
limit | integer |
Nombre maximal d’éléments. Max : 1000. Valeur par défaut : 100 |
|
|
Ignorer
|
skip | integer |
Obtenez la liste des éléments commençant par le nième élément. Valeur par défaut : 0 |
|
|
State
|
state | string |
Obtenez uniquement des domaines avec un état spécifique. Peut être actif, non vérifié ou désactivé. |
|
|
Trier
|
sort | string |
Les options de tri valides sont nom (asc), name :asc ou name :desc. |
|
|
Autorité
|
authority | string |
Obtenez uniquement des domaines avec une autorité spécifique. |
|
|
Search
|
search | string |
Recherchez les domaines par le nom partiel ou complet donné. Ne prend pas en charge les caractères génériques. |
|
|
Inclure des sous-comptes
|
include_subaccounts | boolean |
Recherchez sur chaque domaine qui appartient à n’importe quel sous-compte sous ce compte. Valeur par défaut : false. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
Nombre total de domaines |
|
items
|
items | array of object |
Liste des domaines |
|
id
|
items.id | string |
Identificateur unique du domaine |
|
nom
|
items.name | string |
Nom de domaine complet inscrit auprès de Mailgun |
|
state
|
items.state | string |
État de vérification actuel du domaine |
|
type
|
items.type | string |
Classification du domaine. Les valeurs possibles sont personnalisées ou bac à sable |
|
date_de_création
|
items.created_at | string |
Horodatage indiquant quand le domaine a été créé au format RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Indique si le domaine est actuellement désactivé |
|
require_tls
|
items.require_tls | boolean |
Si true Mailgun envoie uniquement des messages via une connexion TLS |
|
skip_verification
|
items.skip_verification | boolean |
Si true Mailgun ne vérifie pas le certificat et le nom d’hôte lors de la configuration d’une connexion TLS |
|
smtp_login
|
items.smtp_login | string |
Nom d’utilisateur de connexion SMTP pour le domaine |
|
smtp_password
|
items.smtp_password | string |
Mot de passe SMTP facultatif pour le domaine utilisé pour l’authentification SMTP |
|
spam_action
|
items.spam_action | string |
Action à entreprendre lorsqu’un message est marqué comme courrier indésirable. Les options sont désactivées, balise ou bloc |
|
caractère générique
|
items.wildcard | boolean |
Indique si le domaine est un domaine générique et peut recevoir des e-mails pour n’importe quel sous-domaine |
|
subaccount_id
|
items.subaccount_id | string |
ID de sous-compte auquel appartient le domaine |
|
tracking_host
|
items.tracking_host | string |
L’hôte de suivi personnalisé pour le domaine utilisé pour le suivi s’ouvre et clique |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Si true Mailgun gère automatiquement la génération de clés DKIM et la configuration des enregistrements DNS |
|
web_prefix
|
items.web_prefix | string |
Préfixe de sous-domaine utilisé pour l’ouverture et le suivi des clics |
|
web_scheme
|
items.web_scheme | string |
Schéma de protocole utilisé pour le suivi |
|
archive_to
|
items.archive_to | string |
URL vers laquelle une copie de chaque message remis correctement sera publiée |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Si les messages entrants vrais dans ce domaine sont chiffrés |
|
message_ttl
|
items.message_ttl | integer |
Spécifie la durée de vie (TTL) en secondes pour récupérer les messages entrants et sortants |
Obtenir les détails du domaine
Récupère la représentation JSON d’un domaine qui inclut des détails sur l’état et les paramètres du domaine.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de domaine
|
name | True | string |
Nom du domaine que vous souhaitez récupérer |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
id
|
domain.id | string |
Identificateur unique du domaine |
|
nom
|
domain.name | string |
Nom de domaine complet inscrit auprès de Mailgun |
|
state
|
domain.state | string |
État de vérification actuel du domaine |
|
type
|
domain.type | string |
Classification du domaine. Les valeurs possibles sont personnalisées ou bac à sable |
|
date_de_création
|
domain.created_at | string |
Horodatage indiquant quand le domaine a été créé au format RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Indique si le domaine est actuellement désactivé |
|
require_tls
|
domain.require_tls | boolean |
Si true Mailgun envoie uniquement des messages via une connexion TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Si true Mailgun ne vérifie pas le certificat et le nom d’hôte lors de la configuration d’une connexion TLS |
|
smtp_login
|
domain.smtp_login | string |
Nom d’utilisateur de connexion SMTP pour le domaine |
|
smtp_password
|
domain.smtp_password | string |
Mot de passe SMTP facultatif pour le domaine utilisé pour l’authentification SMTP |
|
spam_action
|
domain.spam_action | string |
Action à entreprendre lorsqu’un message est marqué comme courrier indésirable. Les options sont désactivées, balise ou bloc |
|
caractère générique
|
domain.wildcard | boolean |
Indique si le domaine est un domaine générique et peut recevoir des e-mails pour n’importe quel sous-domaine |
|
subaccount_id
|
domain.subaccount_id | string |
ID de sous-compte auquel appartient le domaine |
|
tracking_host
|
domain.tracking_host | string |
L’hôte de suivi personnalisé pour le domaine utilisé pour le suivi s’ouvre et clique |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Si true Mailgun gère automatiquement la génération de clés DKIM et la configuration des enregistrements DNS |
|
web_prefix
|
domain.web_prefix | string |
Préfixe de sous-domaine utilisé pour l’ouverture et le suivi des clics |
|
web_scheme
|
domain.web_scheme | string |
Schéma de protocole utilisé pour le suivi |
|
archive_to
|
domain.archive_to | string |
URL vers laquelle une copie de chaque message remis correctement sera publiée |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Si les messages entrants vrais dans ce domaine sont chiffrés |
|
message_ttl
|
domain.message_ttl | integer |
Spécifie la durée de vie (TTL) en secondes pour récupérer les messages entrants et sortants |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Liste des enregistrements DNS requis pour recevoir des e-mails |
|
is_active
|
receiving_dns_records.is_active | boolean |
Indique si l’enregistrement DNS est actuellement actif |
|
Cache
|
receiving_dns_records.cached | array of string |
Liste des valeurs mises en cache Mailgun pour l’enregistrement DNS |
|
nom
|
receiving_dns_records.name | string |
Nom de l’enregistrement DNS le cas échéant |
|
priorité
|
receiving_dns_records.priority | string |
Valeur de priorité pour les enregistrements DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Type d’enregistrement DNS tel que MX, TXT ou CNAME |
|
valide
|
receiving_dns_records.valid | string |
Indique si l’enregistrement DNS est valide |
|
value
|
receiving_dns_records.value | string |
Valeur attendue de l’enregistrement DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Liste des enregistrements DNS requis pour l’envoi d’e-mails |
|
is_active
|
sending_dns_records.is_active | boolean |
Indique si l’enregistrement DNS est actuellement actif |
|
Cache
|
sending_dns_records.cached | array of string |
Liste des valeurs mises en cache Mailgun pour l’enregistrement DNS |
|
nom
|
sending_dns_records.name | string |
Nom de l’enregistrement DNS le cas échéant |
|
priorité
|
sending_dns_records.priority | string |
Valeur de priorité pour les enregistrements DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Type d’enregistrement DNS tel que MX, TXT ou CNAME |
|
valide
|
sending_dns_records.valid | string |
Indique si l’enregistrement DNS est valide |
|
value
|
sending_dns_records.value | string |
Valeur attendue de l’enregistrement DNS |
Obtenir les résultats de la validation en bloc
Récupère l’état du travail de validation en bloc et les résultats récapitulatives d’un travail précédemment soumis.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
list_id | True | string |
Identificateur de travail retourné à partir de la demande de validation en bloc. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de travail
|
id | string |
Identificateur de travail |
|
ID de travail
|
list_id | string |
Nom de la liste des travaux |
|
Statut du travail
|
status | string |
État actuel du travail |
|
Créé à
|
created_at | integer |
Lorsque le travail a été créé (horodatage Unix) |
|
URL de téléchargement CSV
|
download_url.csv | string |
URL pour télécharger tous les résultats sous forme de fichier CSV |
|
URL de téléchargement CSV organisée
|
download_url.curated_csv | string |
URL pour télécharger les résultats organisés en tant que fichier CSV |
|
URL de téléchargement JSON
|
download_url.json | string |
URL pour télécharger tous les résultats sous forme de fichier JSON |
|
URL de téléchargement JSON organisée
|
download_url.curated_json | string |
URL de téléchargement des résultats organisés en tant que fichier JSON |
|
Quantité totale
|
quantity | integer |
Nombre total d’enregistrements dans le travail |
|
Enregistrements traités
|
records_processed | integer |
Nombre d’enregistrements traités jusqu’à présent |
|
Nombre de livrables
|
summary.result.deliverable | integer |
Nombre d’adresses livrables |
|
Nombre non remis
|
summary.result.undeliverable | integer |
Nombre d’adresses nondeliverables |
|
Catch All Count
|
summary.result.catch_all | integer |
Nombre d’adresses catch-all |
|
Ne pas envoyer le nombre
|
summary.result.do_not_send | integer |
Nombre d’adresses signalées comme n’étant pas envoyées |
|
Accepter tout le nombre
|
summary.result.accept_all | integer |
Nombre d’adresses accept-all |
|
Nombre inconnu
|
summary.result.unknown | integer |
Nombre d’adresses avec une remise inconnue |
|
Nombre élevé de risques
|
summary.risk.high | integer |
Nombre d’adresses à haut risque |
|
Nombre moyen de risques
|
summary.risk.medium | integer |
Nombre d’adresses à risque moyen |
|
Nombre faible de risques
|
summary.risk.low | integer |
Nombre d’adresses à faible risque |
|
Nombre de risques inconnus
|
summary.risk.unknown | integer |
Nombre d’adresses présentant un risque inconnu |
|
Nombre hautement engagé
|
summary.engagement.highly_engaged | integer |
Nombre d’adresses hautement engagées |
|
Nombre engagé
|
summary.engagement.engaged | integer |
Nombre d’adresses engagées |
|
Nombre désengagé
|
summary.engagement.disengaged | integer |
Nombre d’adresses désengagées |
|
Nombre de bots
|
summary.engagement.bot | integer |
Nombre d’adresses de bot |
|
Nombre de plaintes
|
summary.engagement.complainer | integer |
Nombre d’adresses de plaignant |
|
Aucun nombre de données
|
summary.engagement.no_data | integer |
Nombre d’adresses sans données d’engagement |
Validation par e-mail en bloc
Chargez un fichier CSV avec une colonne d’en-tête d’e-mail et démarrez un travail de validation en bloc à l’aide de l’API V4 de Mailgun.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la liste des travaux
|
list_id | True | string |
Paramètre de chemin qui identifie le travail de validation en bloc. |
|
Fichier CSV
|
file | True | file |
Fichier CSV à charger. Le fichier doit inclure un en-tête nommé e-mail. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID du travail (nom de la liste)
|
id | string |
Identificateur de travail (nom de liste) |
|
Message du serveur
|
message | string |
Message d’état de Mailgun |
Valider l’e-mail
Valide une adresse e-mail à l’aide du service de validation de Mailgun et retourne des résultats de remise.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Adresse électronique
|
address | True | string |
Adresse e-mail à valider. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Adresse électronique
|
address | string |
Adresse e-mail validée |
|
Est valide
|
is_valid | boolean |
Indique si Mailgun considère l’adresse valide |
|
Vérification de boîte aux lettres
|
mailbox_verification | string |
État de vérification de boîte aux lettres |
|
Adresse jetable
|
is_disposable_address | boolean |
Indique si l’adresse provient d’un fournisseur jetable |
|
Adresse du rôle
|
is_role_address | boolean |
Indique si l’adresse est une adresse basée sur des rôles |
|
Motif de validation
|
reason | array of string |
Raisons de validation retournées par Mailgun (vides lorsqu’elles sont valides) |
|
Niveau de risque
|
risk | string |
Niveau de risque attribué par Mailgun |
|
Résultat
|
result | string |
Résultat de la remise mailgun (par exemple livrable ou non remis) |
|
Adresse racine
|
root_address | string |
Adresse racine normalisée |
|
Nom d’affichage
|
parts.display_name | string |
Partie nom complet de l’adresse |
|
Domaine
|
parts.domain | string |
Partie domaine de l’adresse |
|
Composant local
|
parts.local_part | string |
Partie locale de l’adresse |