Configurando Integraciones en Drimify (Webhooks & Mailers)

Las integraciones de Drimify te permiten enviar automáticamente datos de los participantes a servicios externos cada vez que un usuario interactúa con tu aplicación. Puedes conectar con una API Personalizada, HubSpot o Salesforce, y para cada integración, puedes especificar exactamente qué campos de datos se transmiten.

Primeros Pasos

Si aún no se ha configurado ninguna integración, verás la pantalla de marcador de posición "Aún no hay integraciones de webhook" o "Aún no hay integraciones de servidor de correo electrónico".
Haz clic en + Añadir Nueva Integración (disponible tanto en la parte superior derecha como en el centro de la página) para abrir el selector de integración.

Integraciones De Webhook

Seleccionando un Tipo de Integración

Aparecerá una ventana modal titulada "Seleccionar Integración de Webhook".
Puedes filtrar por categoría usando el menú desplegable (por defecto es Todos). Las tres integraciones disponibles son:

• API Personalizada — para cualquier punto final de API REST que controles tú
• HubSpot — para automatización de CRM y Marketing a través de HubSpot
• Salesforce — para Salesforce CRM

Haz clic en la tarjeta de integración que deseas configurar.

Integración De API Personalizada

Autenticación

Después de seleccionar API Personalizada, el panel Añadir Integración se abre con los siguientes campos:

• Nombre de la Integración: Una etiqueta para tu propia referencia (por defecto: "Integración API Personalizada"). Puedes renombrarla a algo más descriptivo.
• Punto Final de API: La URL completa de tu receptor de webhook (por ejemplo: https://api.example.com/webhook). Debe ser un punto final HTTPS.
• Método HTTP:

Selecciona el método http usado para enviar la solicitud de webhook a tu punto final.
Opciones disponibles:

• POST — Recomendado para la mayoría de los casos de uso (crea un nuevo recurso o envía datos)
• PUT — Reemplaza completamente un recurso existente
• PATCH — Actualiza parcialmente un recurso existente

Escoge el método que coincida con cómo tu API espera recibir datos.

• Tipo de Autenticación: Elige el método de autenticación usado por tu punto final.

• Cuando se selecciona Autenticación Básica, aparecen dos campos: Login (nombre de usuario) y Password. Introdúcelos tal cual — Drimify construye el encabezado Authorization: Basic por ti automáticamente. No necesitas codificar nada tú mismo.
• Cuando se selecciona Encabezado Personalizado, aparece un campo adicional Nombre del Encabezado Personalizado donde puedes introducir el nombre clave del encabezado.
• Clave API: El valor secreto enviado usando el método de autenticación seleccionado.
• Verificar Conexión: Haz clic en este botón para probar si Drimify puede alcanzar exitosamente tu punto final usando las credenciales proporcionadas antes de guardar.

Obteniendo el token desde un punto final de autenticación (antes de la llamada)

Algunas APIs requieren que te autentiques primero: llamas a un punto final de autenticación con tus credenciales, recibes un token y usas ese token en la llamada real del webhook. Drimify soporta esto automáticamente.

Cuando el tipo de Autenticación es Clave API, Bearer Token o Encabezado Personalizado, aparece una casilla de verificación "Obtener este token desde un punto final de autenticación". Cuando se marca, el campo de credencial estática se reemplaza por los ajustes previos a la llamada a continuación (para Encabezado Personalizado, el campo de nombre de encabezado permanece visible — el token obtenido se envía en ese encabezado).

El token obtenido se coloca según tu tipo de Autenticación:

• Bearer Token → Authorization: Bearer <token>
• clave api → X-API-KEY: <token>
• Encabezado Personalizado → <nombre de tu encabezado>: <token>

Elegir uno de los tres métodos

OAuth2 (client_credentials) — para servidores estándar OAuth2 (p.ej., Keycloak).

• Campos: Token URL, Client ID, Client Secret, Scope (opcional)
• Drimify envía una solicitud estándar OAuth2 client_credentials y lee el token de access_token. La duración del token se toma del expires_in del servidor.

Login JSON — para acceder a endpoints que aceptan un cuerpo JSON y devuelven un token.

• Campos: Auth URL, Body (lista clave/valor), Token path
• Drimify envía un POST con un cuerpo JSON creado a partir de tus filas clave/valor (p.ej., filas email = a@b.com y password = secreto producen {"email":"a@b.com","password":"secreto"}).
• Token path indica a Drimify dónde está el token en la respuesta JSON, usando notación de puntos — p.ej., data.access_token, o simplemente token si está en el nivel superior.

Personalizado — para cualquier cosa que no encaje en los dos métodos anteriores.

• Campos: Auth URL, HTTP method (POST o GET), Headers (lista clave/valor), Body (lista clave/valor), Body encoding (JSON o form-urlencoded), Token path
• Con el método GET, no hay cuerpo de solicitud — pasa parámetros a través de los Headers o del Auth URL.
• Si añades un header Content-Type por tu cuenta, este tendrá prioridad sobre el que implica la codificación del cuerpo.

Listas de clave/valor (Body y Headers)

Cada fila tiene una clave, un valor, y una casilla de "sensible" (marcada por defecto). Las filas se pueden añadir y eliminar, pero no editar en el lugar — para cambiar una fila, elimínala y añádela nuevamente. La bandera de sensible solo puede configurarse al añadir una fila. Los valores sensibles están ocultos después de guardar y nunca se exponen nuevamente, ni en el formulario ni en los registros.

Caché de tokens y reintentos

• Los tokens OAuth2 se almacenan en caché por la duración indicada en expires_in.
• Para Acceder JSON y Personalizado, establece la Validez del token (minutos) — por defecto son 60 minutos si queda vacío.
• Los tokens almacenados en caché se conservan por un máximo de 7 días.
• Si tu endpoint devuelve 401 mientras un token en caché está en uso, Drimify descarta el token, vuelve a autenticarse y reintenta la llamada una vez.
• Si la pre-llamada falla (error, tiempo de espera, o no se encuentra token en el Token path), el webhook no se envía sin autenticar — la entrega falla, se registra y se reintenta por la cola de entrega como de costumbre.

Verificar Conexión con una pre-llamada

El botón Verificar Conexión soporta completamente la pre-llamada: primero se autentica contra tu endpoint de auth, luego realiza la llamada de prueba con el token obtenido.

Integración con HubSpot

Después de seleccionar HubSpot, el panel muestra:

• Nombre de Integración: Por Defecto: "Integración HubSpot".
• Clave API / Token de Acceso: Pega aquí tu Token de Acceso de App Privada de HubSpot. HubSpot dejó de usar las claves API heredadas en 2022, por lo que debes usar un token de App Privada generado desde tu cuenta de HubSpot bajo: Configuración → Integraciones → Apps Privadas
• Verificar Conexión: Prueba el token contra la API de HubSpot antes de guardar.

Integración con Salesforce

Después de seleccionar Salesforce, el panel muestra:

• Nombre de Integración: Por Defecto: "Integración Salesforce".
• Dominio de Salesforce: La URL de tu instancia de Salesforce (por ejemplo: tuempresa.my.salesforce.com).
• Consumer Key y Consumer Secret: Obtenidos desde una App Conectada configurada en Salesforce bajo: Setup → Administrador De Aplicaciones → Nueva App Conectada. Drimify usa el flujo de Credenciales de Cliente OAuth 2.0.
• ID de campo externo Nombre: El nombre API del campo usado para emparejar (upsert) registros — típicamente algo como Email_External_Id__c o un campo externo personalizado en el objeto Contacto o Prospección. Este campo debe estar marcado como un ID Externo en Salesforce.
• Fuente del ID Externo: Un desplegable que te permite seleccionar qué campo de datos de Drimify se debe usar como clave de coincidencia (por ejemplo: Email).
• Verificar Conexión: Prueba la conexión OAuth de Salesforce antes de guardar.

⚠️ Campos Requeridos de Salesforce

Salesforce impone campos requeridos a nivel de objeto. Si estás realizando un upsert de Clientes Potenciales, Salesforce requiere como mínimo:

• lastName — requerido para la fecha de creación del Lead

Si estás realizando un upsert de Contactos, Salesforce requiere:

• lastName — requerido para la fecha de creación del Contacto

Aunque Email no es requerido en el esquema por defecto de Salesforce, casi siempre es necesario como ID Externo para hacer coincidir correctamente y deduplicar los registros durante los upserts. Sin una coincidencia fiable de ID Externo, Salesforce puede crear registros duplicados o devolver un error.

Mejor Práctica

Siempre mapea al menos:

• Apellido
• Email

cuando conectes a Salesforce. Omitir Apellido hará que el webhook falle y el registro no se creará ni actualizará.

Mapeo de Campos

Disponible para los tres tipos de integración, Mapeo de Campos te permite especificar exactamente qué campos de datos de Drimify se envían a tu integración, y bajo qué nombres clave. Haz clic en + Añadir Campo para añadir una fila de mapeo.

Cada fila consta de:

• Campo del Webhook (izquierda) — el nombre de la clave que aparecerá en la carga de salida (definido por ti para coincidir con los requisitos de tu integración)
• → Campo Fuente (desplegable en la derecha) — el valor fuente para este campo. Puedes:
• • Seleccionar un campo de datos de Drimify (por ejemplo, Referencia De La App, Email, Puntaje) para enviar un valor dinámico recopilado del participante
  • Seleccionar Valor Estático para enviar un valor fijo y codificado cada vez que se active el webhook — aparecerá un campo de texto adicional donde ingresarás el valor (por ejemplo, Mi_Valor). Útil para pasar constantes como un nombre de evento, un identificador fuente, o una etiqueta de entorno.

Campos Fuente de Drimify Disponibles

Puedes añadir tantos mapeos como necesites. Para eliminar un mapeo, haz clic en el icono de la papelera en el lado derecho de la fila.

Disponible en Espacio de Trabajo

En la parte inferior del formulario de la integración, la sección Available in Workspaces te permite usar el interruptor junto a cada espacio de trabajo para controlar qué espacio de trabajo puede usar la integración.
Haz clic en Select All para habilitar la integración para todos los espacios de trabajo a la vez.

Guardar y Gestionar Integraciones

Una vez completados todos los campos, haz clic en Save Changes para crear la integración. La integración aparecerá entonces en la lista principal de Integraciones. Puedes editar o borrar integraciones existentes desde esta lista en cualquier momento. Haz clic en Cancel para descartar los cambios no guardados.

Integraciones de Servidor de Correo Electrónico

Las integraciones de servidor de correo electrónico te permiten enviar correos electrónicos transaccionales (por ejemplo, confirmaciones, resultados, o seguimientos) directamente desde tus experiencias en Drimify usando tu proveedor de correo electrónico preferido.

Añadir Integración de Servidor de Correo Electrónico

1. Ve a Integraciones → Integraciones de Servidor de Correo Electrónico
2. Haz clic en Añadir Integración de Servidor de Correo Electrónico
3. Elige tu proveedor:

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• Tipimail
• SMTP Personalizado

Configurar tu Integración de Servidor de Correo Electrónico

Ajustes Generales

Todos los proveedores comparten los siguientes ajustes generales:

• Nombre de la Integración – Nombre interno para identificar tu integración
• Nombre del Remitente – Nombre que se mostrará como el remitente del correo
• Correo del Remitente – Dirección de correo electrónico utilizada para enviar correos (no aplicable para Drimify — ver abajo)
• Correo BCC (opcional) – Añadir una dirección de correo para recibir una copia de todos los correos salientes

Autenticación

Cada proveedor requiere credenciales específicas. Consulta la sección de configuración específica del proveedor a continuación para más detalles.

Probar tu Conexión

Después de ingresar tus credenciales, haz clic en Enviar Correo de Prueba para verificar que tu integración funcione correctamente. Una confirmación de "Correo de prueba enviado con éxito" aparecerá si la conexión es válida.

Campos de Parámetros de la Plantilla

Asocia campos de datos de Drimify a las variables de plantilla de tu proveedor de correo electrónico. Esta sección está disponible para proveedores que soportan plantillas de correo dinámicas: Brevo, Mailgun, Mailjet, Mandrill, SendGrid y Tipimail.

• Nombre del Parámetro – El nombre de la variable esperado en tu plantilla de correo
• Campo – El dato correspondiente de Drimify (por ejemplo, Nombre, Correo Electrónico, Puntuación, etc.)

Haz clic en Añadir Campo para crear mapeos adicionales.

disponible en el espacio de trabajo

Elige qué espacio de trabajo puede usar esta integración de servidor de correo electrónico.

Configuración Específica del Proveedor

Amazon SES

Lo que necesitas:

• Un usuario de AWS IAM con permisos ses:SendEmail
• Clave de Acceso API y Clave Privada API (de AWS IAM)
• Tu región de AWS (por ejemplo, eu-west-1, us-east-1)
• Token de Sesión (solo si utilizas credenciales temporales/STS)
• Un correo del remitente o dominio verificado en Amazon SES

Pasos:

1. En AWS IAM, crea un usuario con permisos para enviar con SES y genera un par de claves de acceso
2. En Drimify, introduce tu Clave de Acceso API, Clave Privada API, y Región
3. Si usas credenciales temporales, introduce también el Token de Sesión
4. Asegúrate de que tu correo del remitente o dominio esté verificado en Amazon SES
5. Haz clic en Enviar Correo de Prueba para validar la conexión
6. Guarda tu integración

Brevo

Lo que necesitas:

• Una clave api de Brevo

Pasos:

1. En tu cuenta de Brevo, genera una clave api en Configuración → Claves API
2. Pégala en el campo de Clave API en Drimify
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

Drimify

No se requiere autenticación. Los correos se envían a través de la infraestructura interna de correo electrónico de Drimify (notification@digitaservice.com).
Lo que necesitas:

• Un nombre del remitente
• Una dirección de correo electrónico de respuesta (por ejemplo, contact@yourcompany.com)
• Opcionalmente, una dirección de correo electrónico en CCO

Pasos:

1. Selecciona Drimify como tu proveedor
2. Introduce tu Nombre del Remitente y Correo de Respuesta
3. Opcionalmente añade un Correo en CCO
4. Selecciona el espacio de trabajo que debería usar esta integración y guarda

Mailgun

Lo que necesitas:

• Una clave api de Mailgun
• Tu dominio de envío registrado en Mailgun
• Tu región API (EE. UU. o UE)

Pasos:

1. En tu cuenta de Mailgun, recupera tu clave de api y dominio de envío
2. En Drimify, introduce tu Clave API, Dominio API, y Región API
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

Mailjet

Lo que necesitas:

• Una Clave de Acceso API de Mailjet y Clave Privada API

Pasos:

1. En tu cuenta de Mailjet, ve a Configuración de Cuenta → REST API → Gestión de claves api
2. Copia tu Clave de Acceso API y Clave Privada API
3. Introduce ambas en Drimify
4. Haz clic en Enviar Correo de Prueba para validar la conexión
5. Guarda tu integración

Mandrill

Lo que necesitas:

• Una clave api de Mandrill (Mandrill es un complemento de correo transaccional de Mailchimp)

Pasos:

1. En tu cuenta de Mandrill, ve a Configuraciones → Claves API y genera una clave
2. Pega la Clave API en Drimify
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

SendGrid

Lo que necesitas:

• Una clave api de SendGrid con permisos para enviar correo

Pasos:

1. En tu cuenta de SendGrid, ve a Configuraciones → Claves API y crea una clave con permisos de Mail Send
2. Pega la Clave API en Drimify
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

Tipimail

Lo que necesitas:

• Un Usuario API de Tipimail y clave api (Tipimail es el servicio de correo transaccional de Sarbacane)

Pasos:

1. En tu cuenta de Tipimail, ve a Configuración → SMTP & APIs y recupera tu Usuario API y Clave API
2. Introduce ambos en Drimify
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

SMTP Personalizado

Lo que necesitas:

• El nombre de host de tu servidor SMTP
• Puerto SMTP (normalmente 587 para TLS, 465 para SSL)
• Acceso SMTP (normalmente tu dirección de correo electrónico)
• Contraseña SMTP

Pasos:

1. Recupera tus credenciales SMTP desde tu proveedor de alojamiento de correo electrónico o configuración del servidor
2. En Drimify, introduce tu Host, Puerto, Iniciar Sesión y Contraseña
3. Haz clic en Enviar Correo de Prueba para validar la conexión
4. Guarda tu integración

Actualizado el: 03/10/2026