Crea tu cuenta
Ve a app.hermes.claynode.com y regístrate. Después de registrarte, serás dirigido al dashboard de tu workspace.
Nota: Hermes está actualmente en acceso por invitación. Contacta a [email protected] para solicitar acceso.
Agrega un dominio de envío
En el dashboard, ve a Dominios → Agregar Dominio e ingresa el dominio desde el que quieres enviar (ej. mail.tuapp.com).
Hermes te mostrará los registros DNS a configurar: 3 registros CNAME de DKIM, 1 registro TXT de SPF y 1 registro TXT de DMARC (5 registros requeridos). También se muestra un registro MX, pero solo es necesario si quieres recibir correo entrante.
Verifica tu dominio
Una vez que hayas agregado los registros DNS, haz clic en Verificar DNS en el dashboard. Hermes comenzará a verificar tu DNS en segundo plano. La verificación DKIM de AWS puede tardar entre 15 minutos y 2 horas; SPF y DMARC suelen resolverse en minutos.
Tip: Si la verificación falla, asegúrate de que los registros CNAME de DKIM no tengan el proxy de Cloudflare (nube naranja) activado — se requiere el modo solo DNS.
Envía tu primer email (dashboard)
Con un dominio verificado, usa Emails → Redactar en el dashboard para enviar un email de prueba. Completa el destinatario, asunto y cuerpo, luego haz clic en Enviar.
Verás el estado de entrega actualizado en tiempo real en la sección Logs.
Enviar vía API
También puedes enviar correos de forma programática usando la API REST. Autentica con tu token de sesión (disponible después del login) como Bearer token:
curl -X POST https://api.hermes.claynode.com/workspaces/{workspace_id}/emails/send \
-H "Authorization: Bearer <tu_access_token>" \
-H "Content-Type: application/json" \
-d '{
"to": "[email protected]",
"subject": "Hola desde Hermes",
"html": "<p>Este es un email de prueba.</p>",
"text": "Este es un email de prueba."
}'Reemplaza {workspace_id} con el ID de tu workspace (visible en la URL del dashboard después del login). La respuesta incluye un campo id que puedes usar para rastrear el estado de entrega.
El campo opcional stream controla la prioridad de la cola: "platform" (predeterminado, alta prioridad) es para emails transaccionales disparados por acciones del usuario; "customer" es para envíos masivos o de marketing.
Configura webhooks (opcional)
Recibe notificaciones de eventos en tiempo real en tu aplicación configurando un endpoint de webhook. Consulta la guía de Webhooks para más detalles.