Mailgun (versión preliminar)
Mailgun proporciona API eficaces para enviar, recibir, realizar un seguimiento y almacenar el correo electrónico. Use este conector para automatizar los flujos de trabajo de comunicación y entrega de correo electrónico sin escribir código.
Este conector está disponible en los siguientes productos y regiones:
| Service | Clase | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Canal de soporte técnico |
| URL | https://help.mailgun.com/hc/en-us |
| Correo Electrónico | support@mailgun.com |
| Metadatos del conector | |
|---|---|
| Publicador | Sinch Suecia AB |
| Sitio web | https://www.mailgun.com |
| Directiva de privacidad | https://www.mailgun.com/legal/privacy-policy/ |
| Categorías | Marketing; Ventas y CRM |
Nombre del conector
Mailgun
Resumen del conector
El conector Mailgun permite a los usuarios Power Automate enviar correo electrónico, recuperar información de dominio de Mailgun, validar direcciones de correo electrónico individuales, enviar trabajos de validación masiva de correo electrónico y recuperar resultados de validación masiva mediante su cuenta de Mailgun.
Contacto
Dirección URL de contacto: https://help.mailgun.com/hc/en-us
Correo electrónico de soporte técnico/contacto: support@mailgun.com
Dirección URL de registro: https://signup.mailgun.com/
Requisitos
- Una cuenta de Mailgun. Si no tiene una, regístrese en https://signup.mailgun.com/.
- Una clave de API mailgun o una clave de envío de dominio.
- La región correcta de mailgun API para su cuenta: EE. UU. o UE.
- Para enviar correo electrónico, un dominio de envío de Mailgun. El envío de producción requiere un dominio comprobado.
- Para las acciones de validación, acceda a Mailgun Validate.
Los dominios de espacio aislado se pueden usar para las pruebas iniciales, pero se limitan a los destinatarios autorizados.
Obtención de credenciales
Este conector usa la autenticación de clave de API mailgun. Inicie sesión en el Panel de control mailgun y cree una clave de API a partir de API Security o cree una clave de API de envío específica del dominio a partir de la configuración del dominio de envío.
El conector usa la autenticación básica con api como nombre de usuario y la clave de la API mailgun como contraseña. Durante la configuración de la conexión, seleccione la región de la API mailgun que coincida con la cuenta.
Operaciones admitidas
Este conector admite las siguientes operaciones:
-
Send Email: envíe un correo electrónico mediante un dominio de envío de Mailgun. -
Get Domain Information: recupera información de dominio de Mailgun. -
Validate Email Address: valide una dirección de correo electrónico individual. -
Submit Bulk Validation Job: envíe un trabajo de validación masiva de correo electrónico. -
Get Bulk Validation Results: recuperar resultados de validación masiva de correo electrónico.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación Power se comparte con otro usuario, se le solicitará a otro usuario que cree una nueva conexión explícitamente.
| Nombre | Tipo | Descripción | Required |
|---|---|---|---|
| Clave de API | securestring | Clave de API privada de Mailgun | True |
| Región de mailgun | cuerda | Seleccione Mailgun US o Mailgun EU. | True |
Acciones
| Enviar un correo electrónico |
Envía un correo electrónico mediante su cuenta de Mailgun a través de campos de formulario de varias partes compatibles con la API de mensajes de Mailgun. |
| Obtención de detalles del dominio |
Captura la representación JSON de un dominio que incluye detalles sobre el estado y la configuración del dominio. |
| Obtención de resultados de validación masiva |
Recupera el estado del trabajo de validación masiva y los resultados de resumen de un trabajo enviado previamente. |
| Obtener dominios |
Obtenga la lista de dominios. Puede filtrarse por estado o autoridad. La lista está paginada y limitada a 1000 elementos por página. |
| Validación masiva de correo electrónico |
Cargue un CSV con una columna de encabezado de correo electrónico e inicie un trabajo de validación masiva mediante la API V4 de Mailgun. |
| Validar correo electrónico |
Valida una dirección de correo electrónico mediante el servicio de validación de Mailgun y devuelve resultados de entrega. |
Enviar un correo electrónico
Envía un correo electrónico mediante su cuenta de Mailgun a través de campos de formulario de varias partes compatibles con la API de mensajes de Mailgun.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de dominio
|
domain_name | True | string |
Dominio desde el que se va a enviar el correo electrónico |
|
Desde la dirección de correo electrónico
|
from | True | string |
Dirección de correo electrónico desde la que se enviará el mensaje. |
|
Dirección de correo electrónico
|
to | True | string |
Dirección de correo electrónico del destinatario. |
|
Asunto
|
subject | True | string |
Asunto del correo electrónico. |
|
Cuerpo del correo electrónico (texto)
|
text | string |
Cuerpo de texto sin formato del correo electrónico. |
|
|
Cuerpo del correo electrónico (HTML)
|
html | html |
Cuerpo HTML del correo electrónico. |
|
|
Dirección de correo electrónico cc
|
cc | string |
Dirección de correo electrónico del destinatario de copia de carbono. |
|
|
Dirección de correo electrónico de BCC
|
bcc | string |
Dirección de correo electrónico del destinatario de copia de carbono ciego. |
|
|
dirección de correo electrónico de Reply-To
|
h:Reply-To | string |
Dónde deben entregarse las respuestas. |
|
|
Datos adjuntos
|
attachment | file |
Datos adjuntos de archivo que se van a incluir con el mensaje. |
|
|
Tags
|
o:tag | array |
Una o varias etiquetas para agrupar y filtrar correos electrónicos en Mailgun (hasta 10 por mensaje). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. del mensaje
|
id | string |
Identificador único asignado al mensaje en cola |
|
Mensaje de estado
|
message | string |
Estado legible de Mailgun (por ejemplo, En cola). Gracias. |
Obtención de detalles del dominio
Captura la representación JSON de un dominio que incluye detalles sobre el estado y la configuración del dominio.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de dominio
|
name | True | string |
Nombre del dominio que desea capturar |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
domain.id | string |
Identificador único del dominio |
|
nombre
|
domain.name | string |
Nombre de dominio completo registrado con Mailgun |
|
state
|
domain.state | string |
Estado de comprobación actual del dominio |
|
tipo
|
domain.type | string |
Clasificación del dominio. Los valores posibles son personalizados o de espacio aislado |
|
fecha_de_creación
|
domain.created_at | string |
Marca de tiempo que indica cuándo se creó el dominio en formato RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Indica si el dominio está deshabilitado actualmente. |
|
require_tls
|
domain.require_tls | boolean |
Si es true Mailgun solo enviará mensajes a través de una conexión TLS. |
|
skip_verification
|
domain.skip_verification | boolean |
Si true Mailgun no comprobará el certificado y el nombre de host al configurar una conexión TLS |
|
smtp_login
|
domain.smtp_login | string |
Nombre de usuario de inicio de sesión SMTP para el dominio |
|
smtp_password
|
domain.smtp_password | string |
Contraseña SMTP opcional para el dominio usado para la autenticación SMTP |
|
spam_action
|
domain.spam_action | string |
Acción que se debe realizar cuando se marca un mensaje como correo no deseado. Las opciones están deshabilitadas, etiqueta o bloque |
|
comodín
|
domain.wildcard | boolean |
Indica si el dominio es un dominio comodín y puede recibir correos electrónicos para cualquier subdominio. |
|
subaccount_id
|
domain.subaccount_id | string |
El identificador de subcuenta al que pertenece el dominio |
|
tracking_host
|
domain.tracking_host | string |
El host de seguimiento personalizado para el dominio usado para el seguimiento se abre y hace clic en |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Si true Mailgun administra automáticamente la generación de claves DKIM y la configuración del registro DNS |
|
web_prefix
|
domain.web_prefix | string |
Prefijo de subdominio usado para el seguimiento de clics y abiertos |
|
web_scheme
|
domain.web_scheme | string |
Esquema de protocolo usado para el seguimiento |
|
archive_to
|
domain.archive_to | string |
Dirección URL en la que se publicará una copia de cada mensaje entregado correctamente. |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Si los mensajes entrantes verdaderos a este dominio se cifrarán |
|
message_ttl
|
domain.message_ttl | integer |
Especifica el período de vida (TTL) en segundos para recuperar los mensajes entrantes y salientes. |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Lista de registros DNS necesarios para recibir correos electrónicos |
|
is_active
|
receiving_dns_records.is_active | boolean |
Indica si el registro DNS está activo actualmente. |
|
almacenados en caché
|
receiving_dns_records.cached | array of string |
Lista de valores almacenados en caché de Mailgun para el registro DNS |
|
nombre
|
receiving_dns_records.name | string |
Nombre del registro DNS si procede |
|
prioridad
|
receiving_dns_records.priority | string |
Valor de prioridad para los registros DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Tipo de registro DNS, como MX, TXT o CNAME |
|
válido
|
receiving_dns_records.valid | string |
Indica si el registro DNS es válido. |
|
value
|
receiving_dns_records.value | string |
Valor esperado del registro DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Lista de registros DNS necesarios para enviar correos electrónicos |
|
is_active
|
sending_dns_records.is_active | boolean |
Indica si el registro DNS está activo actualmente. |
|
almacenados en caché
|
sending_dns_records.cached | array of string |
Lista de valores almacenados en caché de Mailgun para el registro DNS |
|
nombre
|
sending_dns_records.name | string |
Nombre del registro DNS si procede |
|
prioridad
|
sending_dns_records.priority | string |
Valor de prioridad para los registros DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Tipo de registro DNS, como MX, TXT o CNAME |
|
válido
|
sending_dns_records.valid | string |
Indica si el registro DNS es válido. |
|
value
|
sending_dns_records.value | string |
Valor esperado del registro DNS |
Obtención de resultados de validación masiva
Recupera el estado del trabajo de validación masiva y los resultados de resumen de un trabajo enviado previamente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
list_id | True | string |
Identificador de trabajo devuelto de la solicitud de validación masiva. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. del trabajo
|
id | string |
Identificador de trabajo |
|
Id. del trabajo
|
list_id | string |
Nombre de la lista de trabajos |
|
Estado del trabajo
|
status | string |
Estado actual del trabajo |
|
Fecha de creación
|
created_at | integer |
Cuando se creó el trabajo (marca de tiempo de Unix) |
|
DIRECCIÓN URL de descarga de CSV
|
download_url.csv | string |
Dirección URL para descargar todos los resultados como un archivo CSV |
|
URL de descarga de CSV seleccionada
|
download_url.curated_csv | string |
Dirección URL para descargar los resultados mantenidos como un archivo CSV |
|
DIRECCIÓN URL de descarga de JSON
|
download_url.json | string |
Dirección URL para descargar todos los resultados como un archivo JSON |
|
Dirección URL de descarga de JSON seleccionada
|
download_url.curated_json | string |
Dirección URL para descargar los resultados mantenidos como un archivo JSON |
|
Cantidad total
|
quantity | integer |
Número total de registros en el trabajo |
|
Registros procesados
|
records_processed | integer |
Número de registros procesados hasta ahora |
|
Recuento de resultados
|
summary.result.deliverable | integer |
Número de direcciones de entrega |
|
Recuento no entregable
|
summary.result.undeliverable | integer |
Número de direcciones no entregables |
|
Catch All Count
|
summary.result.catch_all | integer |
Número de direcciones catch-all |
|
No enviar recuento
|
summary.result.do_not_send | integer |
Número de direcciones marcadas como no se envían |
|
Aceptar todo el recuento
|
summary.result.accept_all | integer |
Número de direcciones accept-all |
|
Recuento desconocido
|
summary.result.unknown | integer |
Número de direcciones con entrega desconocida |
|
Recuento de alto riesgo
|
summary.risk.high | integer |
Número de direcciones de alto riesgo |
|
Recuento de riesgos medios
|
summary.risk.medium | integer |
Número de direcciones de riesgo medio |
|
Recuento de bajo riesgo
|
summary.risk.low | integer |
Número de direcciones de bajo riesgo |
|
Recuento de riesgos desconocido
|
summary.risk.unknown | integer |
Número de direcciones con riesgo desconocido |
|
Recuento muy comprometido
|
summary.engagement.highly_engaged | integer |
Número de direcciones muy comprometidas |
|
Recuento de comprometidos
|
summary.engagement.engaged | integer |
Número de direcciones comprometidas |
|
Recuento desconectado
|
summary.engagement.disengaged | integer |
Número de direcciones desconectadas |
|
Número de bots
|
summary.engagement.bot | integer |
Número de direcciones del bot |
|
Recuento de reclamantes
|
summary.engagement.complainer | integer |
Número de direcciones de queja |
|
Sin recuento de datos
|
summary.engagement.no_data | integer |
Número de direcciones sin datos de interacción |
Obtener dominios
Obtenga la lista de dominios. Puede filtrarse por estado o autoridad. La lista está paginada y limitada a 1000 elementos por página.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Recuento máximo de elementos. Máximo: 1000. Valor predeterminado: 100 |
|
|
Omitir
|
skip | integer |
Obtenga la lista de elementos a partir del nº elemento. Valor predeterminado: 0 |
|
|
Estado
|
state | string |
Obtenga solo dominios con un estado específico. Puede estar activo, no comprobado o deshabilitado. |
|
|
Sort
|
sort | string |
Las opciones de ordenación válidas son name (asc), name:asc o name:desc. |
|
|
Autoridad
|
authority | string |
Obtenga solo dominios con una autoridad específica. |
|
|
Search
|
search | string |
Buscar dominios por el nombre parcial o completo especificado. No admite caracteres comodín. |
|
|
Incluir subcuentas
|
include_subaccounts | boolean |
Busque en todos los dominios que pertenezcan a las subcuentas de esta cuenta. Valor predeterminado: false. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
total_count
|
total_count | integer |
Número total de dominios |
|
items
|
items | array of object |
Lista de dominios |
|
id
|
items.id | string |
Identificador único del dominio |
|
nombre
|
items.name | string |
Nombre de dominio completo registrado con Mailgun |
|
state
|
items.state | string |
Estado de comprobación actual del dominio |
|
tipo
|
items.type | string |
Clasificación del dominio. Los valores posibles son personalizados o de espacio aislado |
|
fecha_de_creación
|
items.created_at | string |
Marca de tiempo que indica cuándo se creó el dominio en formato RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Indica si el dominio está deshabilitado actualmente. |
|
require_tls
|
items.require_tls | boolean |
Si es true Mailgun solo enviará mensajes a través de una conexión TLS. |
|
skip_verification
|
items.skip_verification | boolean |
Si true Mailgun no comprobará el certificado y el nombre de host al configurar una conexión TLS |
|
smtp_login
|
items.smtp_login | string |
Nombre de usuario de inicio de sesión SMTP para el dominio |
|
smtp_password
|
items.smtp_password | string |
Contraseña SMTP opcional para el dominio usado para la autenticación SMTP |
|
spam_action
|
items.spam_action | string |
Acción que se debe realizar cuando se marca un mensaje como correo no deseado. Las opciones están deshabilitadas, etiqueta o bloque |
|
comodín
|
items.wildcard | boolean |
Indica si el dominio es un dominio comodín y puede recibir correos electrónicos para cualquier subdominio. |
|
subaccount_id
|
items.subaccount_id | string |
El identificador de subcuenta al que pertenece el dominio |
|
tracking_host
|
items.tracking_host | string |
El host de seguimiento personalizado para el dominio usado para el seguimiento se abre y hace clic en |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Si true Mailgun administra automáticamente la generación de claves DKIM y la configuración del registro DNS |
|
web_prefix
|
items.web_prefix | string |
Prefijo de subdominio usado para el seguimiento de clics y abiertos |
|
web_scheme
|
items.web_scheme | string |
Esquema de protocolo usado para el seguimiento |
|
archive_to
|
items.archive_to | string |
Dirección URL en la que se publicará una copia de cada mensaje entregado correctamente. |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Si los mensajes entrantes verdaderos a este dominio se cifrarán |
|
message_ttl
|
items.message_ttl | integer |
Especifica el período de vida (TTL) en segundos para recuperar los mensajes entrantes y salientes. |
Validación masiva de correo electrónico
Cargue un CSV con una columna de encabezado de correo electrónico e inicie un trabajo de validación masiva mediante la API V4 de Mailgun.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre de lista de trabajos
|
list_id | True | string |
Parámetro path que identifica el trabajo de validación masiva. |
|
Archivo CSV
|
file | True | file |
Archivo CSV que se va a cargar. El archivo debe incluir un encabezado denominado correo electrónico. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Id. de trabajo (nombre de lista)
|
id | string |
Identificador de trabajo (nombre de lista) |
|
Mensaje del servidor
|
message | string |
Mensaje de estado de Mailgun |
Validar correo electrónico
Valida una dirección de correo electrónico mediante el servicio de validación de Mailgun y devuelve resultados de entrega.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección de correo electrónico
|
address | True | string |
Dirección de correo electrónico que se va a validar. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Dirección de correo electrónico
|
address | string |
Dirección de correo electrónico validada |
|
Es válido
|
is_valid | boolean |
Si Mailgun considera que la dirección es válida |
|
Comprobación del buzón
|
mailbox_verification | string |
Estado de comprobación del buzón |
|
Es dirección descartable
|
is_disposable_address | boolean |
Si la dirección procede de un proveedor descartable |
|
Es la dirección del rol
|
is_role_address | boolean |
Si la dirección es una dirección basada en roles |
|
Motivo de validación
|
reason | array of string |
Motivos de validación devueltos por Mailgun (vacío cuando es válido) |
|
Nivel de riesgo
|
risk | string |
Nivel de riesgo asignado por Mailgun |
|
Resultado
|
result | string |
Resultado de la entrega de mailgun (por ejemplo, entregable o no entregable) |
|
Dirección raíz
|
root_address | string |
Dirección raíz normalizada |
|
Nombre para mostrar
|
parts.display_name | string |
Parte del nombre para mostrar de la dirección |
|
Domain
|
parts.domain | string |
Parte del dominio de la dirección |
|
Elemento local
|
parts.local_part | string |
Parte local de la dirección |