Mailgun

Mailgun é um serviço poderoso de entrega de e-mail projetado para desenvolvedores e empresas enviarem, receberem e rastrearem e-mails com facilidade. O Mailgun permite aproveitar APIs robustas para e-mail transacional e de marketing confiável, gerenciamento flexível de mailing lists e rastreamento avançado de eventos.

Com o conjunto abrangente de recursos do Mailgun, você pode automatizar operações-chave de e-mail e monitorar de perto a deliverability e o engajamento dos destinatários. Isso o torna uma solução ideal para automação de fluxos de trabalho em que comunicações, notificações e e-mails de campanha são partes centrais dos seus processos.

Principais recursos do Mailgun:

Envio de e-mail transacional: Entregue e-mails de alto volume, como notificações de conta, recibos, alertas e redefinições de senha.
Conteúdo rico de e-mail: Envie e-mails em texto simples e HTML, e use tags para categorizar e rastrear suas mensagens.
Gerenciamento de mailing lists: Crie, atualize e gerencie mailing lists e membros para enviar comunicações em grupo com eficiência.
Informações de domínio: Recupere detalhes sobre seus domínios de envio para monitorar configuração e saúde.
Rastreamento de eventos: Analise deliverability e engajamento com dados detalhados de eventos das mensagens enviadas.
Recuperação de mensagens: Acesse mensagens armazenadas para conformidade, análise ou troubleshooting.

Ao integrar o Mailgun ao Zoen, seus agentes passam a enviar e-mails, gerenciar listas, acessar informações de domínio e monitorar eventos em tempo real de forma programática como parte de fluxos de trabalho automatizados. Isso permite engajamento inteligente e orientado a dados com seus usuários diretamente a partir dos seus processos com IA.

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`domain`	string	Yes	Mailgun sending domain (e.g., mg.example.com)
`from`	string	Yes	Sender email address (e.g., sender@example.com or "Name <sender@example.com>")
`to`	string	Yes	Recipient email address (e.g., user@example.com). Use comma-separated values for multiple recipients
`subject`	string	Yes	Email subject line
`text`	string	No	Plain text body of the email
`html`	string	No	HTML body of the email (e.g., "<h1>Hello</h1><p>Message content</p>")
`cc`	string	No	CC recipient email address (e.g., cc@example.com). Use comma-separated values for multiple recipients
`bcc`	string	No	BCC recipient email address (e.g., bcc@example.com). Use comma-separated values for multiple recipients
`tags`	string	No	Tags for the email (comma-separated)

Output

Parameter	Type	Description
`success`	boolean	Whether the message was sent successfully
`id`	string	Message ID
`message`	string	Response message from Mailgun

`mailgun_get_message`

Retrieve a stored message by its key

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`domain`	string	Yes	Mailgun domain for retrieving messages (e.g., mg.example.com)
`messageKey`	string	Yes	Message storage key

Output

Parameter	Type	Description
`success`	boolean	Whether the request was successful
`recipients`	string	Message recipients
`from`	string	Sender email
`subject`	string	Message subject
`bodyPlain`	string	Plain text body
`strippedText`	string	Stripped text
`strippedSignature`	string	Stripped signature
`bodyHtml`	string	HTML body
`strippedHtml`	string	Stripped HTML
`attachmentCount`	number	Number of attachments
`timestamp`	number	Message timestamp
`messageHeaders`	json	Message headers
`contentIdMap`	json	Content ID map

`mailgun_list_messages`

List events (logs) for messages sent through Mailgun

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`domain`	string	Yes	Mailgun domain for listing events (e.g., mg.example.com)
`event`	string	No	Filter by event type (accepted, delivered, failed, opened, clicked, etc.)
`limit`	number	No	Maximum number of events to return (default: 100)

Output

Parameter	Type	Description
`success`	boolean	Whether the request was successful
`items`	json	Array of event items
`paging`	json	Paging information

`mailgun_create_mailing_list`

Create a new mailing list

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`address`	string	Yes	Mailing list address (e.g., newsletter@mg.example.com)
`name`	string	No	Mailing list name
`description`	string	No	Mailing list description
`accessLevel`	string	No	Access level: readonly, members, or everyone

Output

Parameter	Type	Description
`success`	boolean	Whether the list was created successfully
`message`	string	Response message
`list`	json	Created mailing list details

`mailgun_get_mailing_list`

Get details of a mailing list

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`address`	string	Yes	Mailing list address to retrieve (e.g., newsletter@mg.example.com)

Output

Parameter	Type	Description
`success`	boolean	Whether the request was successful
`list`	json	Mailing list details

`mailgun_add_list_member`

Add a member to a mailing list

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Mailgun API key
`listAddress`	string	Yes	Mailing list address (e.g., list@mg.example.com)
`address`	string	Yes	Member email address to add (e.g., user@example.com)
`name`	string	No	Member name
`vars`	string	No	JSON string of custom variables
`subscribed`	boolean	No	Whether the member is subscribed