Mailgun (versão prévia)
O Mailgun fornece APIs avançadas para enviar, receber, acompanhar e armazenar emails. Use esse conector para automatizar fluxos de trabalho de comunicação e entrega de email sem escrever código.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - 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 (GCC) – 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 Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Canal de suporte |
| URL | https://help.mailgun.com/hc/en-us |
| support@mailgun.com |
| Metadados do conector | |
|---|---|
| Publicador | Sinch Suécia AB |
| Site | https://www.mailgun.com |
| Política de privacidade | https://www.mailgun.com/legal/privacy-policy/ |
| Categories | Marketing; Vendas e CRM |
Nome do conector
Mailgun
Resumo do conector
O conector mailgun permite que Power Automate usuários enviem emails, recuperem informações de domínio do Mailgun, validem endereços de email individuais, enviem trabalhos de validação de email em massa e recuperem resultados de validação em massa usando sua conta do Mailgun.
Contato
URL de contato: https://help.mailgun.com/hc/en-us
Email de suporte/contato: support@mailgun.com
URL de inscrição: https://signup.mailgun.com/
Requirements
- Uma conta do Mailgun. Se você não tiver um, inscreva-se em https://signup.mailgun.com/.
- Uma chave de API do Mailgun ou chave de envio de domínio.
- A região correta da API do Mailgun para sua conta: EUA ou UE.
- Para enviar email, um domínio de envio do Mailgun. O envio de produção requer um domínio verificado.
- Para ações de validação, acesse o Mailgun Validate.
Os domínios de área restrita podem ser usados para testes iniciais, mas são limitados a destinatários autorizados.
Como obter credenciais
Esse conector usa a autenticação de chave da API do Mailgun. Entre no Mailgun Painel de Controle e crie uma chave de API com base na Segurança da API ou crie uma chave de API de envio específica do domínio das configurações de domínio de envio.
O conector usa a autenticação Básica com api o nome de usuário e a chave da API do Mailgun como a senha. Durante a instalação da conexão, selecione a região da API do Mailgun que corresponde à sua conta.
Operações com suporte
Esse conector dá suporte às seguintes operações:
-
Send Email: envie um email usando um domínio de envio do Mailgun. -
Get Domain Information: recuperar informações de domínio do Mailgun. -
Validate Email Address: valide um endereço de email individual. -
Submit Bulk Validation Job: envie um trabalho de validação de email em massa. -
Get Bulk Validation Results: recuperar resultados de validação de email em massa.
Criando uma conexão
O conector dá suporte aos 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| chave de API | securestring | A chave de API privada do Mailgun | True |
| Região do Mailgun | cadeia | Selecione Mailgun US ou Mailgun UE | True |
Ações
| Enviar um email |
Envia um email usando sua conta do Mailgun por meio de campos de formulário de várias partes compatíveis com a API de mensagens do Mailgun. |
| Obter detalhes do domínio |
Busca a representação JSON de um domínio que inclui detalhes sobre o estado e as configurações do domínio. |
| Obter domínios |
Obtenha a lista de domínios. Pode ser filtrado por estado ou autoridade. A lista é paginada e limitada a 1.000 itens por página. |
| Obter resultados de validação em massa |
Recupera o status do trabalho de validação em massa e os resultados de resumo de um trabalho enviado anteriormente. |
| Validar Email |
Valida um endereço de email usando o serviço de validação do Mailgun e retorna resultados de entrega. |
| Validação de email 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 um email
Envia um email usando sua conta do Mailgun por meio de campos de formulário de várias partes compatíveis com a API de mensagens do Mailgun.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de domínio
|
domain_name | True | string |
O domínio do qual enviar o email |
|
No endereço de email
|
from | True | string |
O endereço de email do qual a mensagem será enviada. |
|
Para o endereço de email
|
to | True | string |
Endereço de e-mail do destinatário. |
|
Subject
|
subject | True | string |
O assunto do email. |
|
Corpo do Email (Texto)
|
text | string |
Corpo de texto sem formatação do email. |
|
|
Corpo do Email (HTML)
|
html | html |
Corpo HTML do email. |
|
|
Endereço de email CC
|
cc | string |
Endereço de email do destinatário da cópia de carbono. |
|
|
Endereço de email do BCC
|
bcc | string |
Endereço de email do destinatário de cópia de carbono cego. |
|
|
Endereço de email Reply-To
|
h:Reply-To | string |
Onde as respostas devem ser entregues. |
|
|
Anexo
|
attachment | file |
Anexo de arquivo a ser incluído com a mensagem. |
|
|
Tags
|
o:tag | array |
Uma ou mais marcas para agrupar e filtrar emails no Mailgun (até 10 por mensagem). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da mensagem
|
id | string |
Identificador exclusivo atribuído à mensagem na fila |
|
Mensagem de status
|
message | string |
Status legível por humanos do Mailgun (por exemplo, Enfileirado. Obrigado.) |
Obter detalhes do domínio
Busca a representação JSON de um domínio que inclui detalhes sobre o estado e as configurações do domínio.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome de domínio
|
name | True | string |
O nome do domínio que você deseja buscar |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
domain.id | string |
Identificador exclusivo do domínio |
|
nome
|
domain.name | string |
Nome de domínio totalmente qualificado registrado no Mailgun |
|
estado
|
domain.state | string |
Status de verificação atual do domínio |
|
tipo
|
domain.type | string |
Classificação do domínio. Os valores possíveis são personalizados ou área restrita |
|
criado_em
|
domain.created_at | string |
Carimbo de data/hora que indica quando o domínio foi criado no formato RFC1123 |
|
is_disabled
|
domain.is_disabled | boolean |
Indica se o domínio está desabilitado no momento |
|
require_tls
|
domain.require_tls | boolean |
Se o Mailgun verdadeiro enviar apenas mensagens por meio de uma conexão TLS |
|
skip_verification
|
domain.skip_verification | boolean |
Se o Mailgun verdadeiro não verificar o certificado e o nome do host ao configurar uma conexão TLS |
|
smtp_login
|
domain.smtp_login | string |
Nome de usuário de logon do SMTP para o domínio |
|
smtp_password
|
domain.smtp_password | string |
Senha SMTP opcional para o domínio usado para autenticação SMTP |
|
spam_action
|
domain.spam_action | string |
Ação a ser tomada quando uma mensagem é sinalizada como spam. As opções estão desabilitadas, marca ou bloco |
|
curinga
|
domain.wildcard | boolean |
Indica se o domínio é um domínio curinga e pode receber emails para qualquer subdomínio |
|
subaccount_id
|
domain.subaccount_id | string |
A ID de subcontagem à qual o domínio pertence |
|
tracking_host
|
domain.tracking_host | string |
O host de acompanhamento personalizado para o domínio usado para acompanhamento é aberto e clica |
|
use_automatic_sender_security
|
domain.use_automatic_sender_security | boolean |
Se o True Mailgun gerenciar automaticamente a geração de chaves DKIM e a configuração de registro DNS |
|
web_prefix
|
domain.web_prefix | string |
Prefixo de subdomínio usado para abrir e clicar no acompanhamento |
|
web_scheme
|
domain.web_scheme | string |
Esquema de protocolo usado para acompanhamento |
|
archive_to
|
domain.archive_to | string |
URL na qual uma cópia de cada mensagem entregue com êxito será postada |
|
encrypt_incoming_message
|
domain.encrypt_incoming_message | boolean |
Se as mensagens de entrada verdadeiras para esse domínio forem criptografadas |
|
message_ttl
|
domain.message_ttl | integer |
Especifica a TTL (vida útil) em segundos para recuperar mensagens de entrada e saída |
|
receiving_dns_records
|
receiving_dns_records | array of object |
Lista de registros DNS necessários para receber emails |
|
is_active
|
receiving_dns_records.is_active | boolean |
Indica se o registro DNS está ativo no momento |
|
armazenado em cache
|
receiving_dns_records.cached | array of string |
Lista de valores armazenados em cache do Mailgun para o registro DNS |
|
nome
|
receiving_dns_records.name | string |
Nome do registro DNS, se aplicável |
|
prioridade
|
receiving_dns_records.priority | string |
Valor de prioridade para registros DNS MX |
|
record_type
|
receiving_dns_records.record_type | string |
Tipo de registro DNS, como MX, TXT ou CNAME |
|
válido
|
receiving_dns_records.valid | string |
Indica se o registro DNS é válido |
|
valor
|
receiving_dns_records.value | string |
Valor esperado do registro DNS |
|
sending_dns_records
|
sending_dns_records | array of object |
Lista de registros DNS necessários para enviar emails |
|
is_active
|
sending_dns_records.is_active | boolean |
Indica se o registro DNS está ativo no momento |
|
armazenado em cache
|
sending_dns_records.cached | array of string |
Lista de valores armazenados em cache do Mailgun para o registro DNS |
|
nome
|
sending_dns_records.name | string |
Nome do registro DNS, se aplicável |
|
prioridade
|
sending_dns_records.priority | string |
Valor de prioridade para registros DNS MX |
|
record_type
|
sending_dns_records.record_type | string |
Tipo de registro DNS, como MX, TXT ou CNAME |
|
válido
|
sending_dns_records.valid | string |
Indica se o registro DNS é válido |
|
valor
|
sending_dns_records.value | string |
Valor esperado do registro DNS |
Obter domínios
Obtenha a lista de domínios. Pode ser filtrado por estado ou autoridade. A lista é paginada e limitada a 1.000 itens por página.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Limite
|
limit | integer |
Contagem máxima de itens. Máximo: 1000. Padrão: 100 |
|
|
Ignorar
|
skip | integer |
Obtenha a lista de itens começando no elemento nth. Padrão: 0 |
|
|
State
|
state | string |
Obtenha somente domínios com um estado específico. Pode ser ativo, não verificado ou desabilitado. |
|
|
Classificar
|
sort | string |
As opções de classificação válidas são nome (asc), name:asc ou name:desc. |
|
|
Autoridade
|
authority | string |
Obtenha somente domínios com uma autoridade específica. |
|
|
Pesquisa
|
search | string |
Pesquise domínios pelo nome parcial ou completo fornecido. Não dá suporte a curingas. |
|
|
Incluir subcontões
|
include_subaccounts | boolean |
Pesquise em todos os domínios que pertencem a quaisquer subcontões nessa conta. Padrão: falso. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
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 exclusivo do domínio |
|
nome
|
items.name | string |
Nome de domínio totalmente qualificado registrado no Mailgun |
|
estado
|
items.state | string |
Status de verificação atual do domínio |
|
tipo
|
items.type | string |
Classificação do domínio. Os valores possíveis são personalizados ou área restrita |
|
criado_em
|
items.created_at | string |
Carimbo de data/hora que indica quando o domínio foi criado no formato RFC1123 |
|
is_disabled
|
items.is_disabled | boolean |
Indica se o domínio está desabilitado no momento |
|
require_tls
|
items.require_tls | boolean |
Se o Mailgun verdadeiro enviar apenas mensagens por meio de uma conexão TLS |
|
skip_verification
|
items.skip_verification | boolean |
Se o Mailgun verdadeiro não verificar o certificado e o nome do host ao configurar uma conexão TLS |
|
smtp_login
|
items.smtp_login | string |
Nome de usuário de logon do SMTP para o domínio |
|
smtp_password
|
items.smtp_password | string |
Senha SMTP opcional para o domínio usado para autenticação SMTP |
|
spam_action
|
items.spam_action | string |
Ação a ser tomada quando uma mensagem é sinalizada como spam. As opções estão desabilitadas, marca ou bloco |
|
curinga
|
items.wildcard | boolean |
Indica se o domínio é um domínio curinga e pode receber emails para qualquer subdomínio |
|
subaccount_id
|
items.subaccount_id | string |
A ID de subcontagem à qual o domínio pertence |
|
tracking_host
|
items.tracking_host | string |
O host de acompanhamento personalizado para o domínio usado para acompanhamento é aberto e clica |
|
use_automatic_sender_security
|
items.use_automatic_sender_security | boolean |
Se o True Mailgun gerenciar automaticamente a geração de chaves DKIM e a configuração de registro DNS |
|
web_prefix
|
items.web_prefix | string |
Prefixo de subdomínio usado para abrir e clicar no acompanhamento |
|
web_scheme
|
items.web_scheme | string |
Esquema de protocolo usado para acompanhamento |
|
archive_to
|
items.archive_to | string |
URL na qual uma cópia de cada mensagem entregue com êxito será postada |
|
encrypt_incoming_message
|
items.encrypt_incoming_message | boolean |
Se as mensagens de entrada verdadeiras para esse domínio forem criptografadas |
|
message_ttl
|
items.message_ttl | integer |
Especifica a TTL (vida útil) em segundos para recuperar mensagens de entrada e saída |
Obter resultados de validação em massa
Recupera o status do trabalho de validação em massa e os resultados de resumo de um trabalho enviado anteriormente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
list_id | True | string |
O identificador de trabalho retornado da solicitação de validação em massa. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do trabalho
|
id | string |
Identificador de trabalho |
|
ID do trabalho
|
list_id | string |
Nome da lista de trabalhos |
|
Status do Trabalho
|
status | string |
Status do trabalho atual |
|
Criado em
|
created_at | integer |
Quando o trabalho foi criado (carimbo de data/hora unix) |
|
CSV Download URL
|
download_url.csv | string |
URL para baixar todos os resultados como um arquivo CSV |
|
URL de download do CSV com curadoria
|
download_url.curated_csv | string |
URL para baixar resultados coletados como um arquivo CSV |
|
JSON Download URL
|
download_url.json | string |
URL para baixar todos os resultados como um arquivo JSON |
|
URL de Download JSON com curadoria
|
download_url.curated_json | string |
URL para baixar resultados coletados como um arquivo JSON |
|
Quantidade Total
|
quantity | integer |
Número total de registros no trabalho |
|
Registros processados
|
records_processed | integer |
Número de registros processados até agora |
|
Contagem de entregas
|
summary.result.deliverable | integer |
Número de endereços que podem ser entregues |
|
Contagem não entregue
|
summary.result.undeliverable | integer |
Número de endereços não entregues |
|
Capturar Toda a Contagem
|
summary.result.catch_all | integer |
Número de endereços catch-all |
|
Não Enviar Contagem
|
summary.result.do_not_send | integer |
Número de endereços sinalizados como não enviados |
|
Aceitar Todas as Contagens
|
summary.result.accept_all | integer |
Número de endereços de aceitação de todos |
|
Contagem Desconhecida
|
summary.result.unknown | integer |
Número de endereços com entrega 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 riscos desconhecidos
|
summary.risk.unknown | integer |
Número de endereços com risco desconhecido |
|
Contagem altamente engajada
|
summary.engagement.highly_engaged | integer |
Número de endereços altamente envolvidos |
|
Contagem engajada
|
summary.engagement.engaged | integer |
Número de endereços envolvidos |
|
Contagem desengajada
|
summary.engagement.disengaged | integer |
Número de endereços desengajados |
|
Contagem de bots
|
summary.engagement.bot | integer |
Número de endereços de bot |
|
Contagem de reclamantes
|
summary.engagement.complainer | integer |
Número de endereços do reclamante |
|
Sem contagem de dados
|
summary.engagement.no_data | integer |
Número de endereços sem dados de participação |
Validar Email
Valida um endereço de email usando o serviço de validação do Mailgun e retorna resultados de entrega.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Endereço de e-mail
|
address | True | string |
O endereço de email a ser validado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Endereço de e-mail
|
address | string |
O endereço de email que foi validado |
|
É válido
|
is_valid | boolean |
Se o Mailgun considera o endereço válido |
|
Verificação de caixa de correio
|
mailbox_verification | string |
Status de verificação da caixa de correio |
|
É endereço descartável
|
is_disposable_address | boolean |
Se o endereço é de um provedor descartável |
|
É o endereço da função
|
is_role_address | boolean |
Se o endereço é um endereço baseado em função |
|
Motivo da validação
|
reason | array of string |
Motivos de validação retornados pelo Mailgun (vazio quando válido) |
|
Nível de risco
|
risk | string |
Nível de risco atribuído pelo Mailgun |
|
Result
|
result | string |
Resultado da entrega do Mailgun (por exemplo, entregue ou não entregue) |
|
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 |
|
Domínio
|
parts.domain | string |
Parte do domínio do endereço |
|
Parte Local
|
parts.local_part | string |
Parte local do endereço |
Validação de email 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 | Description |
|---|---|---|---|---|
|
Nome da Lista de Trabalhos
|
list_id | True | string |
Parâmetro de caminho que identifica o trabalho de validação em massa. |
|
Arquivo CSV
|
file | True | file |
Arquivo CSV a ser carregado. O arquivo deve incluir um cabeçalho chamado email. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do trabalho (nome da lista)
|
id | string |
Identificador de trabalho (nome da lista) |
|
Mensagem do servidor
|
message | string |
Mensagem de status do Mailgun |