Mailgun (anteprima)
Mailgun offre API potenti per inviare, ricevere, tenere traccia e archiviare la posta elettronica. Usare questo connettore per automatizzare i flussi di lavoro di recapito e comunicazione della posta elettronica senza scrivere codice.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Class | Regioni |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Canale di supporto |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Metadati del connettore | |
|---|---|
| Server di pubblicazione | Sinch Svezia AB |
| Sito web | https://www.mailgun.com |
| Informativa sulla privacy | https://www.mailgun.com/legal/privacy-policy/ |
| Categorie | Marketing; Vendite e CRM |
Nome del connettore
Mailgun
Riepilogo del connettore
Il connettore Mailgun consente Power Automate gli utenti di inviare messaggi di posta elettronica, recuperare le informazioni sul dominio Mailgun, convalidare i singoli indirizzi di posta elettronica, inviare processi di convalida della posta elettronica in blocco e recuperare i risultati della convalida bulk usando il proprio account Mailgun.
Contatto
URL contatto: https://help.mailgun.com/hc/en-us
Indirizzo di posta elettronica di supporto/contatto: support@mailgun.com
URL di iscrizione: https://signup.mailgun.com/
Requisiti
- Un account Mailgun. Se non è disponibile, iscriversi all'indirizzo https://signup.mailgun.com/.
- Chiave API mailgun o chiave di invio del dominio.
- Area dell'API Mailgun corretta per l'account: Stati Uniti o UE.
- Per l'invio di messaggi di posta elettronica, un dominio di invio mailgun. L'invio di produzione richiede un dominio verificato.
- Per le azioni di convalida, accedere a Mailgun Validate.
I domini sandbox possono essere usati per i test iniziali, ma sono limitati ai destinatari autorizzati.
Come ottenere le credenziali
Questo connettore usa l'autenticazione della chiave API Mailgun. Accedere al Pannello di controllo Mailgun e creare una chiave API da Sicurezza API oppure creare una chiave API specifica del dominio dalle impostazioni del dominio di invio.
Il connettore usa l'autenticazione di base con api come nome utente e la chiave API Mailgun come password. Durante la configurazione della connessione, selezionare l'area dell'API Mailgun corrispondente all'account.
Operazioni supportate
Questo connettore supporta le operazioni seguenti:
-
Send Email: inviare un messaggio di posta elettronica usando un dominio di invio Mailgun. -
Get Domain Information: recuperare le informazioni sul dominio Mailgun. -
Validate Email Address: convalidare un singolo indirizzo di posta elettronica. -
Submit Bulk Validation Job: inviare un processo di convalida della posta elettronica in blocco. -
Get Bulk Validation Results: recupera i risultati della convalida della posta elettronica in blocco.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Descrizione | Required |
|---|---|---|---|
| API key | securestring | Chiave API privata mailgun | True |
| Area mailgun | corda | Selezionare Mailgun US o Mailgun EU | True |
Azioni
| Convalida della posta elettronica in blocco |
Caricare un file CSV con una colonna di intestazione di posta elettronica e avviare un processo di convalida in blocco usando l'API V4 di Mailgun. |
| Convalida messaggio di posta elettronica |
Convalida un indirizzo di posta elettronica usando il servizio di convalida di Mailgun e restituisce i risultati del risultato finale. |
| Invia un messaggio e-mail |
Invia un messaggio di posta elettronica usando l'account Mailgun tramite campi modulo multipart compatibili con l'API messaggi di Mailgun. |
| Ottenere domini |
Ottenere l'elenco dei domini. Può essere filtrato in base allo stato o all'autorità. L'elenco è impaginato e limitato a 1000 elementi per pagina. |
| Ottenere i dettagli del dominio |
Recupera la rappresentazione JSON di un dominio che include dettagli sullo stato e le impostazioni del dominio. |
| Ottenere i risultati della convalida bulk |
Recupera lo stato del processo di convalida bulk e i risultati di riepilogo per un processo inviato in precedenza. |
Convalida della posta elettronica in blocco
Caricare un file CSV con una colonna di intestazione di posta elettronica e avviare un processo di convalida in blocco usando l'API V4 di Mailgun.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome elenco processi
|
list_id | True | string |
Parametro path che identifica il processo di convalida bulk. |
|
CSV File
|
file | True | file |
File CSV da caricare. Il file deve includere un'intestazione denominata email. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID processo (nome elenco)
|
id | string |
Identificatore processo (nome elenco) |
|
Server Message
|
message | string |
Messaggio di stato da Mailgun |
Convalida messaggio di posta elettronica
Convalida un indirizzo di posta elettronica usando il servizio di convalida di Mailgun e restituisce i risultati del risultato finale.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Indirizzo di posta elettronica
|
address | True | string |
Indirizzo di posta elettronica da convalidare. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Indirizzo di posta elettronica
|
address | string |
Indirizzo di posta elettronica convalidato |
|
Valido
|
is_valid | boolean |
Indica se Mailgun considera valido l'indirizzo |
|
Verifica della cassetta postale
|
mailbox_verification | string |
Stato di verifica della cassetta postale |
|
Indirizzo eliminabile
|
is_disposable_address | boolean |
Indica se l'indirizzo proviene da un provider eliminabile |
|
Indirizzo ruolo
|
is_role_address | boolean |
Indica se l'indirizzo è un indirizzo basato su ruoli |
|
Motivo di convalida
|
reason | array of string |
Motivi di convalida restituiti da Mailgun (vuoto quando valido) |
|
Livello di rischio
|
risk | string |
Livello di rischio assegnato da Mailgun |
|
Result
|
result | string |
Risultato della consegna di Mailgun (ad esempio, risultato finale o non recapitabile) |
|
Indirizzo radice
|
root_address | string |
Indirizzo radice normalizzato |
|
Nome visualizzato
|
parts.display_name | string |
Parte del nome visualizzato dell'indirizzo |
|
Domain
|
parts.domain | string |
Parte del dominio dell'indirizzo |
|
Parte locale
|
parts.local_part | string |
Parte locale dell'indirizzo |
Invia un messaggio e-mail
Invia un messaggio di posta elettronica usando l'account Mailgun tramite campi modulo multipart compatibili con l'API messaggi di Mailgun.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome dominio
|
domain_name | True | string |
Dominio da cui inviare il messaggio di posta elettronica |
|
Dall'indirizzo di posta elettronica
|
from | True | string |
L'indirizzo di posta elettronica da cui verrà inviato il messaggio. |
|
Indirizzo di posta elettronica
|
to | True | string |
Indirizzo di posta elettronica del destinatario. |
|
Subject
|
subject | True | string |
Oggetto del messaggio di posta elettronica. |
|
Corpo del messaggio di posta elettronica (testo)
|
text | string |
Corpo del testo normale del messaggio di posta elettronica. |
|
|
Corpo del messaggio di posta elettronica (HTML)
|
html | html |
Corpo HTML del messaggio di posta elettronica. |
|
|
Indirizzo di posta elettronica CC
|
cc | string |
Indirizzo di posta elettronica del destinatario della copia di carbonio. |
|
|
Indirizzo di posta elettronica BCC
|
bcc | string |
Indirizzo di posta elettronica del destinatario della copia di carbonio cieco. |
|
|
indirizzo di posta elettronica Reply-To
|
h:Reply-To | string |
Dove devono essere recapitate le risposte. |
|
|
Allegato
|
attachment | file |
Allegato di file da includere con il messaggio. |
|
|
Tags
|
o:tag | array |
Uno o più tag per raggruppare e filtrare i messaggi di posta elettronica in Mailgun (fino a 10 per messaggio). |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID messaggio
|
id | string |
Identificatore univoco assegnato al messaggio in coda |
|
Messaggio di stato
|
message | string |
Stato leggibile da Mailgun (ad esempio, In coda. Grazie. |
Ottenere domini
Ottenere l'elenco dei domini. Può essere filtrato in base allo stato o all'autorità. L'elenco è impaginato e limitato a 1000 elementi per pagina.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Numero massimo di elementi. Max: 1000. Valore predefinito: 100 |
|
|
Salta
|
skip | integer |
Ottenere l'elenco di elementi a partire dall'n° elemento. Predefinito: 0 |
|
|
State
|
state | string |
Ottiene solo i domini con uno stato specifico. Può essere attivo, non verificato o disabilitato. |
|
|
Sort
|
sort | string |
Le opzioni di ordinamento valide sono name (asc), name:asc o name:desc. |
|
|
Autorità
|
authority | string |
Ottenere solo i domini con un'autorità specifica. |
|
|
Ricerca
|
search | string |
Eseguire ricerche nei domini in base al nome parziale o completo specificato. Non supporta i caratteri jolly. |
|
|
Includi account secondari
|
include_subaccounts | boolean |
Cercare in ogni dominio che appartiene a qualsiasi account secondario con questo account. Valore predefinito: false. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
total_count
|
total_count | integer |
Numero totale di domini |
|
items
|
items | array of object |
Elenco di domini |
|
id
|
items.id | string |
Identificatore univoco del dominio |
|
nome
|
items.name | string |
Nome di dominio completo registrato con Mailgun |
|
state
|
items.state | string |
Stato di verifica corrente del dominio |
|
digitare
|
items.type | string |
Classificazione del dominio. I valori possibili sono personalizzati o sandbox |
|
creato_il
|
items.created_at | string |
Timestamp che indica quando il dominio è stato creato nel formato RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Indica se il dominio è attualmente disabilitato |
|
require_tls
|
items.require_tls | boolean |
Se true Mailgun invierà messaggi solo tramite una connessione TLS |
|
skip_verification
|
items.skip_verification | boolean |
Se true Mailgun non verificherà il certificato e il nome host durante la configurazione di una connessione TLS |
|
smtp_login
|
items.smtp_login | string |
Nome utente dell'account di accesso SMTP per il dominio |
|
smtp_password
|
items.smtp_password | string |
Password SMTP facoltativa per il dominio usato per l'autenticazione SMTP |
|
spam_action
|
items.spam_action | string |
Azione da eseguire quando un messaggio viene contrassegnato come posta indesiderata. Le opzioni sono disabilitate, tag o blocchi |
|
carattere jolly
|
items.wildcard | boolean |
Indica se il dominio è un dominio con caratteri jolly e può ricevere messaggi di posta elettronica per qualsiasi sottodominio |
|
subaccount_id
|
items.subaccount_id | string |
ID dell'account secondario a cui appartiene il dominio |
|
tracking_host
|
items.tracking_host | string |
L'host di rilevamento personalizzato per il dominio usato per il rilevamento si apre e fa clic |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Se true Mailgun gestisce automaticamente la generazione di chiavi DKIM e la configurazione dei record DNS |
|
web_prefix
|
items.web_prefix | string |
Prefisso del sottodominio usato per aprire e fare clic sul rilevamento |
|
web_scheme
|
items.web_scheme | string |
Schema di protocollo usato per il rilevamento |
|
archive_to
|
items.archive_to | string |
URL in cui verrà inviata una copia di ogni messaggio recapitato correttamente |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Se i messaggi in ingresso true a questo dominio verranno crittografati |
|
message_ttl
|
items.message_ttl | integer |
Specifica la durata (TTL) in secondi per il recupero dei messaggi in ingresso e in uscita |
Ottenere i dettagli del dominio
Recupera la rappresentazione JSON di un dominio che include dettagli sullo stato e le impostazioni del dominio.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Nome dominio
|
name | True | string |
Nome del dominio da recuperare |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
domain.id | string |
Identificatore univoco del dominio |
|
nome
|
domain.name | string |
Nome di dominio completo registrato con Mailgun |
|
state
|
domain.state | string |
Stato di verifica corrente del dominio |
|
digitare
|
domain.type | string |
Classificazione del dominio. I valori possibili sono personalizzati o sandbox |
|
creato_il
|
domain.created_at | string |
Timestamp che indica quando il dominio è stato creato nel formato RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Indica se il dominio è attualmente disabilitato |
|
require_tls
|
domain.require_tls | boolean |
Se true Mailgun invierà messaggi solo tramite una connessione TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Se true Mailgun non verificherà il certificato e il nome host durante la configurazione di una connessione TLS |
|
smtp_login
|
domain.smtp_login | string |
Nome utente dell'account di accesso SMTP per il dominio |
|
smtp_password
|
domain.smtp_password | string |
Password SMTP facoltativa per il dominio usato per l'autenticazione SMTP |
|
spam_action
|
domain.spam_action | string |
Azione da eseguire quando un messaggio viene contrassegnato come posta indesiderata. Le opzioni sono disabilitate, tag o blocchi |
|
carattere jolly
|
domain.wildcard | boolean |
Indica se il dominio è un dominio con caratteri jolly e può ricevere messaggi di posta elettronica per qualsiasi sottodominio |
|
subaccount_id
|
domain.subaccount_id | string |
ID dell'account secondario a cui appartiene il dominio |
|
tracking_host
|
domain.tracking_host | string |
L'host di rilevamento personalizzato per il dominio usato per il rilevamento si apre e fa clic |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Se true Mailgun gestisce automaticamente la generazione di chiavi DKIM e la configurazione dei record DNS |
|
web_prefix
|
domain.web_prefix | string |
Prefisso del sottodominio usato per aprire e fare clic sul rilevamento |
|
web_scheme
|
domain.web_scheme | string |
Schema di protocollo usato per il rilevamento |
|
archive_to
|
domain.archive_to | string |
URL in cui verrà inviata una copia di ogni messaggio recapitato correttamente |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Se i messaggi in ingresso true a questo dominio verranno crittografati |
|
message_ttl
|
domain.message_ttl | integer |
Specifica la durata (TTL) in secondi per il recupero dei messaggi in ingresso e in uscita |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Elenco dei record DNS necessari per la ricezione di messaggi di posta elettronica |
|
is_active
|
receiving_dns_records.is_active | boolean |
Indica se il record DNS è attualmente attivo |
|
Memorizzati nella cache
|
receiving_dns_records.cached | array of string |
Elenco dei valori memorizzati nella cache di Mailgun per il record DNS |
|
nome
|
receiving_dns_records.name | string |
Nome del record DNS, se applicabile |
|
priorità
|
receiving_dns_records.priority | string |
Valore di priorità per i record DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Tipo di record DNS, ad esempio MX, TXT o CNAME |
|
valido
|
receiving_dns_records.valid | string |
Indica se il record DNS è valido |
|
value
|
receiving_dns_records.value | string |
Valore previsto del record DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Elenco dei record DNS necessari per l'invio di messaggi di posta elettronica |
|
is_active
|
sending_dns_records.is_active | boolean |
Indica se il record DNS è attualmente attivo |
|
Memorizzati nella cache
|
sending_dns_records.cached | array of string |
Elenco dei valori memorizzati nella cache di Mailgun per il record DNS |
|
nome
|
sending_dns_records.name | string |
Nome del record DNS, se applicabile |
|
priorità
|
sending_dns_records.priority | string |
Valore di priorità per i record DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Tipo di record DNS, ad esempio MX, TXT o CNAME |
|
valido
|
sending_dns_records.valid | string |
Indica se il record DNS è valido |
|
value
|
sending_dns_records.value | string |
Valore previsto del record DNS |
Ottenere i risultati della convalida bulk
Recupera lo stato del processo di convalida bulk e i risultati di riepilogo per un processo inviato in precedenza.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID lavoro
|
list_id | True | string |
Identificatore del processo restituito dalla richiesta di convalida bulk. |
Valori restituiti
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID lavoro
|
id | string |
Identificatore processo |
|
ID lavoro
|
list_id | string |
Nome elenco processi |
|
Stato del processo
|
status | string |
Stato del processo corrente |
|
Data di creazione
|
created_at | integer |
Quando il processo è stato creato (timestamp Unix) |
|
CSV Download URL
|
download_url.csv | string |
URL per scaricare tutti i risultati come file CSV |
|
URL di download CSV curato
|
download_url.curated_csv | string |
URL per scaricare i risultati curati come file CSV |
|
JSON Download URL
|
download_url.json | string |
URL per scaricare tutti i risultati come file JSON |
|
URL di download JSON curato
|
download_url.curated_json | string |
URL per scaricare i risultati curati come file JSON |
|
Quantità totale
|
quantity | integer |
Numero totale di record nel processo |
|
Record elaborati
|
records_processed | integer |
Numero di record elaborati finora |
|
Conteggio risultati finali
|
summary.result.deliverable | integer |
Numero di indirizzi finali |
|
Conteggio non recapitabile
|
summary.result.undeliverable | integer |
Numero di indirizzi non recapitabili |
|
Catch All Count
|
summary.result.catch_all | integer |
Numero di indirizzi catch-all |
|
Non inviare conteggio
|
summary.result.do_not_send | integer |
Numero di indirizzi contrassegnati come non inviati |
|
Accetta tutto il conteggio
|
summary.result.accept_all | integer |
Numero di indirizzi accept-all |
|
Conteggio sconosciuto
|
summary.result.unknown | integer |
Numero di indirizzi con risultato finale sconosciuto |
|
Conteggio dei rischi elevati
|
summary.risk.high | integer |
Numero di indirizzi ad alto rischio |
|
Conteggio medio dei rischi
|
summary.risk.medium | integer |
Numero di indirizzi a medio rischio |
|
Conteggio dei rischi bassi
|
summary.risk.low | integer |
Numero di indirizzi a basso rischio |
|
Conteggio dei rischi sconosciuto
|
summary.risk.unknown | integer |
Numero di indirizzi con rischio sconosciuto |
|
Conteggio altamente impegnato
|
summary.engagement.highly_engaged | integer |
Numero di indirizzi altamente coinvolti |
|
Conteggio occupato
|
summary.engagement.engaged | integer |
Numero di indirizzi coinvolti |
|
Conteggio dissentato
|
summary.engagement.disengaged | integer |
Numero di indirizzi non gestiti |
|
Conteggio bot
|
summary.engagement.bot | integer |
Numero di indirizzi bot |
|
Conteggio dei lamentati
|
summary.engagement.complainer | integer |
Numero di indirizzi del reclamo |
|
Nessun conteggio dati
|
summary.engagement.no_data | integer |
Numero di indirizzi senza dati di engagement |