Saltar al contenido

Primeros pasos

Crea tu cuenta, conecta tu dominio, genera una clave de API y envía tu primer email con Vemudo en unos minutos.

Por Equipo Vemudo · Actualizado el

Esta guía te lleva de cero al primer email enviado: cuenta, dominio, clave de API y una petición curl. Todo lo que ves aquí funciona igual desde cualquier lenguaje, porque la API es HTTP y JSON.

1. Crea tu cuenta

Pide acceso desde la página principal y verifica tu email. Tu cuenta es una organización: dentro de ella están tus dominios, claves, plantillas, contactos y campañas. Mientras la organización está en revisión puedes probar la API con claves test (ver más abajo); las claves live exigen que la organización esté activa.

2. Conecta tu dominio

Para enviar desde [email protected] tienes que demostrar que el dominio es tuyo.

  1. En el panel, abre Dominios y añade el dominio.
  2. Vemudo te muestra 6 registros DNS: 3 de DKIM, 2 del dominio de rebotes (bounce.tu-dominio.com) y 1 de DMARC. Cópialos en el panel de tu proveedor de DNS, o envía las instrucciones a quien lo gestione.
  3. Vemudo comprueba los registros solo, con esperas crecientes durante 72 horas, y te avisa cuando el dominio queda verificado.

Los detalles, los estados y qué pasa si un registro desaparece están en Dominios y DNS.

3. Crea una clave de API

En el panel, abre las claves de API y crea una. Elige:

  • Entorno: test para probar sin enviar correo real, live para enviar de verdad.
  • Permisos (scope): send para enviar, read para consultar, full para todo.

El secreto empieza por vm_test_ o vm_live_ y se muestra una sola vez. Guárdalo en una variable de entorno o en un gestor de secretos; no lo pongas en código ni en el navegador. Más detalles en Autenticación y claves.

bash
export VEMUDO_API_KEY="vm_test_..."

4. Comprueba la clave

bash
curl https://api.vemudo.com/v1/me \
  -H "Authorization: Bearer $VEMUDO_API_KEY"

Si responde con tu organización y la clave, ya estás autenticado.

5. Envía tu primer email

bash
curl -X POST https://api.vemudo.com/v1/emails \
  -H "Authorization: Bearer $VEMUDO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: primer-envio-1" \
  -d '{
    "from": "Tienda <[email protected]>",
    "to": "[email protected]",
    "subject": "Tu pedido está en camino",
    "html": "<p>Gracias por tu compra.</p>"
  }'

La respuesta es 202 con el identificador del email, porque el envío es asíncrono:

json
{ "id": "..." }

Consulta su estado con GET /v1/emails/{id}. Verás cómo pasa de accepted a queued, submitted y delivered.

Claves test y live

testlive
Correo realNo: la entrega se simula y no sale ningún emailSí
Dominio del remitenteCualquier dominio de tu organizaciónDominio verificado y sin pausar
Cuenta de la organizaciónActiva o en revisiónActiva
Cuota del planNo cuentaCuenta

Con una clave test obtienes los mismos estados, eventos y webhooks que con una live, así que puedes probar tu integración completa antes de enviar nada. Para provocar rebotes y reintentos en pruebas usa el dominio de simulación que se explica en Enviar emails.

Siguientes pasos