Saltar al contenido principal

Mailgun

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu cuenta de Mailgun a Nirvai para automatizar el envío de emails, gestionar campañas y rastrear la entrega de emails.

Métodos de Autenticación Soportados​

  • API Key - Con configuración de región y dominio

Requisitos Previos​

  • Una cuenta de Mailgun
  • Un dominio de envío verificado
  • API Key del dashboard de Mailgun

Instrucciones de Configuración​

Configuración de API Key​

  1. Inicia sesión en tu Dashboard de Mailgun
  2. Ve a Settings > API Keys (o API Security)
  3. Copia tu Private API key (o crea una nueva)
  4. Anota tu dominio de envío verificado (ej., mg.tudominio.com)
  5. Identifica tu región de API:
    • Región US: api.mailgun.net (default)
    • Región EU: api.eu.mailgun.net
  6. En Nirvai, ingresa:
    • API Key: Tu clave Private API de Mailgun
    • API Region: Selecciona US o EU según tu cuenta
    • Email Sending Domain: Tu dominio verificado

Crear una API Key​

Si necesitas una nueva API key:

  1. Ve a Settings > API Keys
  2. Haz clic en Create API Key
  3. Agrega una descripción (ej., "Integración Nirvai")
  4. Selecciona el tipo de clave y permisos
  5. Copia la clave inmediatamente

Campos de Configuración​

CampoDescripciónEjemplo
API KeyClave Private API de Mailgunkey-xxxxx...
API RegionRegión US o EUapi.mailgun.net
Email DomainDominio de envío verificadomg.tudominio.com

Selección de Región​

Tu cuenta de Mailgun está vinculada a una región específica:

  • Región US: api.mailgun.net - Más común
  • Región EU: api.eu.mailgun.net - Para residencia de datos en EU

Verifica la URL de tu dashboard para identificar tu región:

  • US: app.mailgun.com
  • EU: app.eu.mailgun.com

Operaciones Disponibles​

Con credenciales de Mailgun, puedes:

  • Enviar emails transaccionales
  • Gestionar listas de correo
  • Rastrear entrega de emails
  • Manejar rebotes y quejas
  • Acceder a estadísticas de envío
  • Validar direcciones de email

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: La API key es inválida. Verifica la clave.
  • 403 Forbidden: Dominio no verificado o la clave carece de permisos.
  • Error de Dominio: Asegúrate de usar un dominio de envío verificado.
  • Región No Coincide: Usando clave US con endpoint EU o viceversa.

Verificación de Dominio​

Tu dominio de envío debe estar verificado:

  1. Ve a Sending > Domains
  2. Selecciona tu dominio
  3. Sigue los pasos de verificación DNS
  4. Espera la verificación (puede tomar 24-48 horas)

Dominio Sandbox​

Para pruebas, Mailgun proporciona un dominio sandbox:

  • Limitado a 5 destinatarios autorizados
  • Bueno para desarrollo y pruebas
  • No apto para producción

Tipos de Claves​

Mailgun tiene diferentes tipos de claves:

  • Private API Key: Acceso completo (usa esta)
  • Domain Sending Key: Limitada a dominio específico
  • Validations API Key: Solo para validación de email

Recursos Relacionados​

Adaptado de la documentación de n8n para la plataforma Nirvai

Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.