Si ya usas n8n para automatizar flujos — inscripciones, envíos de email, notificaciones de WhatsApp — probablemente tengas al menos un caso donde sería útil generar una imagen personalizada para cada usuario o participante, sin procesos manuales.
Este tutorial muestra cómo hacerlo desde cero: crear una tarjeta personalizada vía API de Vecsy dentro de un flujo n8n y compartir la imagen generada. El ejemplo usa el escenario de inscripción a un evento, pero la lógica se aplica a certificados, tarjetas de bienvenida, publicaciones en redes sociales y cualquier otro caso donde necesites imagen + dato de usuario.
Qué necesitarás
- Cuenta en Vecsy con acceso a la API (accede en Automation → API dentro de tu cuenta)
- Una plantilla creada y en estado Ready en Vecsy, con los campos dinámicos definidos
- n8n funcionando — self-hosted o vía n8n Cloud
- Un token de API de Vecsy
Visión general del flujo
El flujo que construiremos tiene tres etapas:
- Trigger — un webhook recibe los datos del participante (nombre, foto, email)
- Generar la tarjeta — un nodo HTTP Request llama a la API de Vecsy y recibe la URL de la imagen
- Compartir — un nodo de email o mensajería envía la imagen al participante
Paso 1 — Configura la plantilla en Vecsy
Antes que nada, la plantilla debe estar lista. En el editor de Vecsy, crea una plantilla con los campos dinámicos que variarán por participante. En nuestro ejemplo:
name — nombre del participante (campo de texto)photo — foto del participante (campo de imagen)
Anota el UUID de la plantilla — lo necesitarás en la llamada a la API. Aparece en la URL de la plantilla o en la sección de API dentro de la plataforma.
Paso 2 — Crea el Webhook Trigger en n8n
En n8n, crea un nuevo workflow y añade el nodo Webhook como trigger.
Configura así:
- Método HTTP: POST
- Ruta:
/inscripcion (o cualquier nombre que tenga sentido para tu flujo) - Modo de respuesta: Respond with another node (si quieres devolver algo a quien llamó) o Last node
Activa el webhook y copia la URL generada. Tendrá el formato:
https://tu-n8n.com/webhook/inscripcion
Esta URL es el punto de entrada del flujo. En tu sitio o plataforma de inscripción, configura para enviar un POST con los datos del participante al completar el registro.
Ejemplo de payload esperado:
json
{
"name": "Ana Souza",
"photo": "https://ejemplo.com/fotos/ana.jpg",
"email": "ana@ejemplo.com"
}
Paso 3 — Llama a la API de Vecsy con HTTP Request
Añade un nodo HTTP Request después del webhook.
Configura los campos:
CampoValorMethodPOSTURLhttps://www.vecsy.co/api/generate-imageAuthenticationHeader AuthHeader nameAuthorizationHeader valueBearer TU_TOKEN_AQUIBody Content TypeJSON
En el cuerpo de la solicitud, mapea los valores dinámicos que vienen del webhook:
json
{
"template_uuid": "18cc03b9-68c9-4aaf-ad74-17c8c76e0827",
"file_format": "png",
"name": "{{ $json.name }}",
"photo": "{{ $json.photo }}"
}
Sustituye template_uuid por el UUID de tu plantilla y los nombres de los campos (name, photo) por los que configuraste en el editor de Vecsy.
Respuesta esperada de la API:
json
{
"url": "https://…",
"key": "uploads/api/generate-image/…",
"format": "png"
}
El campo url contiene el enlace temporal para descargar la imagen generada. Usa este valor en los siguientes nodos del flujo.
Atención: el enlace devuelto es temporal. Si tu flujo necesita almacenar la imagen por más tiempo, descárgala y guárdala en un almacenamiento propio (S3, Google Drive, etc.) antes de continuar.
Paso 4 — Comparte la imagen
Con la URL de la imagen en mano, el siguiente paso es enviarla al participante. Aquí las dos opciones más comunes.
Opción A — Envío por email
Añade el nodo Send Email (o Gmail, si prefieres) y configura:
- Para:
{{ $('Webhook').item.json.email }} - Asunto:
¡Tu tarjeta está lista, {{ $('Webhook').item.json.name }}! - Cuerpo (HTML):
html
Hola, {{ $('Webhook').item.json.name }}!
Tu tarjeta ha sido generada. Haz clic en el enlace abajo para descargarla:
Descargar mi tarjeta
Opción B — Envío por WhatsApp (vía Evolution API o Twilio)
Si tu flujo incluye WhatsApp, añade otro nodo HTTP Request apuntando a tu instancia de WhatsApp y pasa la URL de la imagen como medio:
json
{
"number": "{{ $('Webhook').item.json.phone }}",
"mediaUrl": "{{ $json.url }}",
"caption": "Aquí está tu tarjeta, {{ $('Webhook').item.json.name }}! 🎉"
}
Manejo de errores
La API de Vecsy devuelve errores estandarizados en JSON. Los más comunes que puedes encontrar:
- 401 — Token inválido o ausente. Verifica que el header
Authorization esté correcto. - 400 — Algún campo dinámico de la plantilla falta o tiene formato inválido. Revisa que todos los campos de la plantilla se estén enviando en la solicitud.
- 404 — La plantilla no fue encontrada o no está en estado Ready. Verifica el UUID y el estado de la plantilla en Vecsy.
Para manejar esto en n8n, añade un nodo IF después del HTTP Request verificando el código de estado:
- Si
{{ $json.url }} existe → continúa al envío - Si no → dispara una alerta al equipo o registra el error en un log
Resultado final del flujo
[Webhook] → [HTTP Request: Vecsy API] → [IF: ¿éxito?]
↓ sí
[Send Email / WhatsApp]
↓ no
[Log de error / Alerta]
Con este flujo, cada nueva inscripción genera automáticamente una tarjeta personalizada y la entrega al participante sin intervención manual — sin importar el volumen.
Próximos pasos
Con la integración básica funcionando, algunas extensiones naturales:
- Almacenar la imagen en Google Drive o S3 antes de enviar, para tener un historial
- Disparar en otros momentos — finalización de curso, confirmación de asistencia, cumpleaños del usuario
- Agregar aprobación humana — insertar un nodo de espera para revisar la tarjeta antes del envío automático
Para cualquiera de estos casos, la estructura base es la misma: trigger → llamada a la API de Vecsy → acción con la URL retornada.
¿Quieres probar la integración? Accede a la documentación completa de la API o habla con el equipo de Vecsy para configurar tu acceso. Solicita acceso a la API →
