Mailgun (Pré-visualização)
O Mailgun fornece APIs poderosas para enviar, receber, rastrear e armazenar emails. Use este conector para automatizar a entrega de emails e os fluxos de trabalho de comunicação sem escrever código.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Entrar em contato | |
|---|---|
| Designação | Canal de suporte |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Metadados do conector | |
|---|---|
| Editor | Sinch Suécia AB |
| Sítio Web | https://www.mailgun.com |
| Política de privacidade | https://www.mailgun.com/legal/privacy-policy/ |
| Categorias | Marketing; Vendas e CRM |
Nome do conector
Pistola de correio
Resumo do conector
O conector Mailgun permite aos utilizadores do Power Automate enviar emails, recuperar informações do domínio Mailgun, validar endereços individuais, enviar trabalhos de validação em massa e obter resultados de validação em massa usando a sua conta Mailgun.
Entrar em contato
URL de contacto: https://help.mailgun.com/hc/en-us
Email de suporte/contacto: support@mailgun.com
URL de inscrição: https://signup.mailgun.com/
Requirements
- Uma conta Mailgun. Se não tiver um, inscreva-se em https://signup.mailgun.com/.
- Uma chave API Mailgun ou chave de envio de domínio.
- A região correta da API Mailgun para a sua conta: EUA ou UE.
- Para enviar email, um domínio de envio Mailgun. O envio em produção requer um domínio verificado.
- Para ações de validação, acesso ao Mailgun Validate.
Os domínios sandbox podem ser usados para testes iniciais, mas são limitados a destinatários autorizados.
Como obter credenciais
Este conector utiliza autenticação de chaves API do Mailgun. Inicie sessão no Mailgun Painel de Controlo e crie uma chave API a partir da API Security, ou crie uma chave de API de envio específica para o domínio a partir das definições do seu domínio de envio.
O conector utiliza autenticação Básica com api como nome de utilizador e a chave API do Mailgun como palavra-passe. Durante a configuração da ligação, selecione a região da API do Mailgun que corresponda à sua conta.
Operações suportadas
Este conector suporta as seguintes operações:
-
Send Email: Enviar um email usando um domínio de envio Mailgun. -
Get Domain Information: Recuperar informações do domínio do Mailgun. -
Validate Email Address: Validar um endereço de email individual. -
Submit Bulk Validation Job: Submeter um trabalho de validação de email em massa. -
Get Bulk Validation Results: Recuperar resultados de validação em massa de emails.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Designação | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| chave de API | securestring | A chave privada da API do Mailgun | Verdade |
| Região do Mailgun | cadeia (de caracteres) | Selecione Mailgun US ou Mailgun EU | Verdade |
Ações
| Enviar correio eletrónico |
Envia um email usando a sua conta Mailgun através de campos de formulário multiparte compatíveis com a API de mensagens do Mailgun. |
| Obtenha detalhes do domínio |
Obtém representação JSON de um domínio que inclui detalhes sobre o estado e as definições do domínio. |
| Obtenha resultados de validação em massa |
Recupera o estado da vaga de validação em massa e os resultados resumidos de um trabalho previamente submetido. |
| Obter domínios |
Obtenha a lista de domínios. Pode ser filtrado por estado ou autoridade. A lista é paginada e limitada a 1000 itens por página. |
| Validar e-mail |
Valida um endereço de email usando o serviço de validação da Mailgun e devolve os resultados da entregabilidade. |
| Validação de Emails em Massa |
Carregue um CSV com uma coluna de cabeçalho de email e inicie um trabalho de validação em massa usando a API V4 do Mailgun. |
Enviar correio eletrónico
Envia um email usando a sua conta Mailgun através de campos de formulário multiparte compatíveis com a API de mensagens do Mailgun.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome de Domínio
|
domain_name | True | string |
O domínio a partir do qual enviar o email |
|
De Endereço de Email
|
from | True | string |
O endereço de email de onde a mensagem será enviada. |
|
Para o endereço de email
|
to | True | string |
Endereço de e-mail do destinatário. |
|
Assunto
|
subject | True | string |
O assunto do e-mail. |
|
Corpo do Email (Texto)
|
text | string |
Corpo de texto simples do email. |
|
|
Corpo do Email (HTML)
|
html | html |
Corpo HTML do email. |
|
|
Colocar Endereço de Email em Cópia
|
cc | string |
Endereço de email do destinatário em cópia carbono. |
|
|
Endereço de Email BCC
|
bcc | string |
Endereço de email cega do destinatário. |
|
|
Reply-To Endereço de Email
|
h:Reply-To | string |
Onde as respostas devem ser entregues. |
|
|
Attachment
|
attachment | file |
Anexo de ficheiro para incluir com a mensagem. |
|
|
Tags
|
o:tag | array |
Uma ou mais etiquetas para agrupar e filtrar emails no Mailgun (até 10 por mensagem). |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID da mensagem
|
id | string |
Identificador único atribuído à mensagem em fila |
|
Mensagem de status
|
message | string |
Estado legível para humanos do Mailgun (por exemplo, Em fila. Obrigado.) |
Obtenha detalhes do domínio
Obtém representação JSON de um domínio que inclui detalhes sobre o estado e as definições do domínio.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome de Domínio
|
name | True | string |
O nome do domínio que queres buscar |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
id
|
domain.id | string |
Identificador único do domínio |
|
Designação
|
domain.name | string |
Nome de domínio totalmente qualificado registado na Mailgun |
|
state
|
domain.state | string |
Estado atual de verificação do domínio |
|
tipo
|
domain.type | string |
Classificação do domínio. Os valores possíveis são personalizados ou sandbox |
|
criado_em
|
domain.created_at | string |
Carimbo temporal que indica quando o domínio foi criado em formato RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Indica se o domínio está atualmente desativado |
|
require_tls
|
domain.require_tls | boolean |
Se for verdade, o Mailgun só envia mensagens através de uma ligação TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Se for verdade, o Mailgun não verifica o certificado e o nome do host ao configurar uma ligação TLS |
|
smtp_login
|
domain.smtp_login | string |
Nome de utilizador de login SMTP para o domínio |
|
smtp_password
|
domain.smtp_password | string |
Palavra-passe SMTP opcional para o domínio usado na autenticação SMTP |
|
spam_action
|
domain.spam_action | string |
Ação a tomar quando uma mensagem é assinalada como spam. As opções são desativadas, etiquetadas ou bloqueadas |
|
carácter universal
|
domain.wildcard | boolean |
Indica se o domínio é um domínio coringa e pode receber emails para qualquer subdomínio |
|
subaccount_id
|
domain.subaccount_id | string |
O ID da subconta a que pertence o domínio |
|
tracking_host
|
domain.tracking_host | string |
Host de rastreio personalizado para o domínio usado para rastrear aberturas e cliques |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Se o verdadeiro Mailgun gerir automaticamente a geração de chaves DKIM e a configuração de registos DNS |
|
web_prefix
|
domain.web_prefix | string |
Prefixo de subdomínio usado para rastreamento de abertura e cliques |
|
web_scheme
|
domain.web_scheme | string |
Esquema de protocolo usado para rastreio |
|
archive_to
|
domain.archive_to | string |
URL onde uma cópia de cada mensagem entregue com sucesso será publicada |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Se as verdadeiras mensagens recebidas para este domínio forem encriptadas |
|
message_ttl
|
domain.message_ttl | integer |
Especifica o tempo de vida (TTL) em segundos para recuperar mensagens recebidas e enviadas |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Lista de registos DNS necessários para receber emails |
|
is_active
|
receiving_dns_records.is_active | boolean |
Indica se o registo DNS está atualmente ativo |
|
cacheado
|
receiving_dns_records.cached | array of string |
Lista de valores em cache do Mailgun para o registo DNS |
|
Designação
|
receiving_dns_records.name | string |
Nome do registo DNS, se aplicável |
|
prioridade
|
receiving_dns_records.priority | string |
Valor de prioridade para registos DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Tipo de registo DNS, como MX, TXT ou CNAME |
|
válido
|
receiving_dns_records.valid | string |
Indica se o registo DNS é válido |
|
value
|
receiving_dns_records.value | string |
Valor esperado do registo DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Lista de registos DNS necessários para enviar emails |
|
is_active
|
sending_dns_records.is_active | boolean |
Indica se o registo DNS está atualmente ativo |
|
cacheado
|
sending_dns_records.cached | array of string |
Lista de valores em cache do Mailgun para o registo DNS |
|
Designação
|
sending_dns_records.name | string |
Nome do registo DNS, se aplicável |
|
prioridade
|
sending_dns_records.priority | string |
Valor de prioridade para registos DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Tipo de registo DNS, como MX, TXT ou CNAME |
|
válido
|
sending_dns_records.valid | string |
Indica se o registo DNS é válido |
|
value
|
sending_dns_records.value | string |
Valor esperado do registo DNS |
Obtenha resultados de validação em massa
Recupera o estado da vaga de validação em massa e os resultados resumidos de um trabalho previamente submetido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
ID do trabalho
|
list_id | True | string |
O identificador do trabalho devolvido do pedido de validação em massa. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do trabalho
|
id | string |
Identificador de trabalho |
|
ID do trabalho
|
list_id | string |
Nome da lista de empregos |
|
Situação do Emprego
|
status | string |
Situação atual do trabalho |
|
Criado em
|
created_at | integer |
Quando o trabalho foi criado (carimbo temporal Unix) |
|
CSV Download URL
|
download_url.csv | string |
URL para descarregar todos os resultados como ficheiro CSV |
|
URL de download CSV selecionado
|
download_url.curated_csv | string |
URL para descarregar resultados selecionados como ficheiro CSV |
|
JSON Download URL
|
download_url.json | string |
URL para descarregar todos os resultados como ficheiro JSON |
|
URL de download JSON Curado
|
download_url.curated_json | string |
URL para descarregar resultados curados como ficheiro JSON |
|
Quantidade Total
|
quantity | integer |
Número total de registos no cargo |
|
Registos Processados
|
records_processed | integer |
Número de registos processados até agora |
|
Contagem de entregáveis
|
summary.result.deliverable | integer |
Número de endereços entregáveis |
|
Contagem Não Entregue
|
summary.result.undeliverable | integer |
Número de endereços não entregues |
|
Contagem Geral
|
summary.result.catch_all | integer |
Número de endereços genéricos |
|
Não envie a contagem
|
summary.result.do_not_send | integer |
Número de endereços sinalizados como não enviar |
|
Aceitar todas as contagens
|
summary.result.accept_all | integer |
Número de endereços aceitáveis |
|
Conde Desconhecido
|
summary.result.unknown | integer |
Número de endereços com entregabilidade desconhecida |
|
Contagem de Alto Risco
|
summary.risk.high | integer |
Número de endereços de alto risco |
|
Contagem de Risco Médio
|
summary.risk.medium | integer |
Número de endereços de risco médio |
|
Contagem de Baixo Risco
|
summary.risk.low | integer |
Número de endereços de baixo risco |
|
Contagem de Risco Desconhecida
|
summary.risk.unknown | integer |
Número de endereços com risco desconhecido |
|
Conde Altamente Envolvido
|
summary.engagement.highly_engaged | integer |
Número de discursos altamente envolvidos |
|
Conde Noivo
|
summary.engagement.engaged | integer |
Número de endereços envolvidos |
|
Conde Desengajado
|
summary.engagement.disengaged | integer |
Número de endereços desengajados |
|
Contagem de Bots
|
summary.engagement.bot | integer |
Número de endereços de bots |
|
Contagem de Queixosos
|
summary.engagement.complainer | integer |
Número de endereços do queixoso |
|
Sem contagem de dados
|
summary.engagement.no_data | integer |
Número de endereços sem dados de envolvimento |
Obter domínios
Obtenha a lista de domínios. Pode ser filtrado por estado ou autoridade. A lista é paginada e limitada a 1000 itens por página.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Limit
|
limit | integer |
Número máximo de itens. Max: 1000. Padrão: 100 |
|
|
Pular
|
skip | integer |
Obtenha a lista de itens começando pelo n-ésimo elemento. Padrão: 0 |
|
|
State
|
state | string |
Obtenha apenas domínios com um estado específico. Pode ser ativo, não verificado ou desativado. |
|
|
Ordenar
|
sort | string |
As opções válidas de ordenação são name (asc), name:asc ou name:desc. |
|
|
Autoridade
|
authority | string |
Obtenha apenas domínios com uma autoridade específica. |
|
|
Pesquisa
|
search | string |
Pesquise domínios pelo nome parcial ou completo dado. Não suporta wildcards. |
|
|
Incluir Subcontas
|
include_subaccounts | boolean |
Pesquise em todos os domínios que pertençam a subcontas sob esta conta. Predefinição: false. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
total_count
|
total_count | integer |
Número total de domínios |
|
items
|
items | array of object |
Lista de domínios |
|
id
|
items.id | string |
Identificador único do domínio |
|
Designação
|
items.name | string |
Nome de domínio totalmente qualificado registado na Mailgun |
|
state
|
items.state | string |
Estado atual de verificação do domínio |
|
tipo
|
items.type | string |
Classificação do domínio. Os valores possíveis são personalizados ou sandbox |
|
criado_em
|
items.created_at | string |
Carimbo temporal que indica quando o domínio foi criado em formato RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Indica se o domínio está atualmente desativado |
|
require_tls
|
items.require_tls | boolean |
Se for verdade, o Mailgun só envia mensagens através de uma ligação TLS |
|
skip_verification
|
items.skip_verification | boolean |
Se for verdade, o Mailgun não verifica o certificado e o nome do host ao configurar uma ligação TLS |
|
smtp_login
|
items.smtp_login | string |
Nome de utilizador de login SMTP para o domínio |
|
smtp_password
|
items.smtp_password | string |
Palavra-passe SMTP opcional para o domínio usado na autenticação SMTP |
|
spam_action
|
items.spam_action | string |
Ação a tomar quando uma mensagem é assinalada como spam. As opções são desativadas, etiquetadas ou bloqueadas |
|
carácter universal
|
items.wildcard | boolean |
Indica se o domínio é um domínio coringa e pode receber emails para qualquer subdomínio |
|
subaccount_id
|
items.subaccount_id | string |
O ID da subconta a que pertence o domínio |
|
tracking_host
|
items.tracking_host | string |
Host de rastreio personalizado para o domínio usado para rastrear aberturas e cliques |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Se o verdadeiro Mailgun gerir automaticamente a geração de chaves DKIM e a configuração de registos DNS |
|
web_prefix
|
items.web_prefix | string |
Prefixo de subdomínio usado para rastreamento de abertura e cliques |
|
web_scheme
|
items.web_scheme | string |
Esquema de protocolo usado para rastreio |
|
archive_to
|
items.archive_to | string |
URL onde uma cópia de cada mensagem entregue com sucesso será publicada |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Se as verdadeiras mensagens recebidas para este domínio forem encriptadas |
|
message_ttl
|
items.message_ttl | integer |
Especifica o tempo de vida (TTL) em segundos para recuperar mensagens recebidas e enviadas |
Validar e-mail
Valida um endereço de email usando o serviço de validação da Mailgun e devolve os resultados da entregabilidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Endereço de E-mail
|
address | True | string |
O endereço de e-mail a ser validado. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
Endereço de E-mail
|
address | string |
O endereço de email que foi validado |
|
é válido
|
is_valid | boolean |
Se Mailgun considera o endereço válido |
|
Verificação da Caixa de Correio
|
mailbox_verification | string |
Estado da verificação da caixa de correio |
|
É Endereço Descartável
|
is_disposable_address | boolean |
Se o endereço é de um fornecedor descartável |
|
É o Endereço do Papel
|
is_role_address | boolean |
Se o endereço é baseado em funções |
|
Razão de validação
|
reason | array of string |
Razões de validação devolvidas pelo Mailgun (vazio quando válido) |
|
Nível de Risco
|
risk | string |
Nível de risco atribuído pela Mailgun |
|
Resultado
|
result | string |
Resultado da entregabilidade da pistola de correio (por exemplo, entregável ou não entregável) |
|
Endereço raiz
|
root_address | string |
Endereço raiz normalizado |
|
Nome de Exibição
|
parts.display_name | string |
Parte do nome de exibição do endereço |
|
Domain
|
parts.domain | string |
Porção de domínio do endereço |
|
Parte Local
|
parts.local_part | string |
Parte local do endereço |
Validação de Emails em Massa
Carregue um CSV com uma coluna de cabeçalho de email e inicie um trabalho de validação em massa usando a API V4 do Mailgun.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Nome da Lista de Empregos
|
list_id | True | string |
Parâmetro de caminho que identifica o trabalho de validação em massa. |
|
Arquivo CSV
|
file | True | file |
Ficheiro CSV para carregar. O ficheiro deve incluir um cabeçalho chamado email. |
Devoluções
| Nome | Caminho | Tipo | Descrição |
|---|---|---|---|
|
ID do Trabalho (Nome da Lista)
|
id | string |
Identificador do trabalho (nome da lista) |
|
Mensagem do Servidor
|
message | string |
Mensagem de estado da Mailgun |