Configurar las integraciones en Drimify (webhooks y servidores de correo electrónico)

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

Primeros pasos

Si aún no has configurado ninguna integración, verás el mensaje «Todavía no hay integraciones de webhook» o «Todavía no hay integraciones de servidor de correo electrónico».
Haz clic en + Añadir nueva integración (disponible tanto en la esquina superior derecha como en el centro de la página) para abrir el selector de integraciones.

Integraciones de webhook

Seleccionar un tipo de integración

Se abrirá una ventana modal con el título «Seleccionar integración de webhook».
Puedes filtrar por categoría mediante el menú desplegable (la opción predeterminada es Todas). Las tres integraciones disponibles son:

• API personalizada: para cualquier endpoint de una API REST que gestiones.
• HubSpot: para el CRM y la automatización del marketing a través de HubSpot.
• Salesforce: para el CRM de Salesforce.

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

Integración con una API personalizada

Autenticación

Al seleccionar API personalizada, se abrirá el panel Añadir integración con los siguientes campos:

• Nombre de la integración: una etiqueta para identificarla (por defecto: «Integración con una API personalizada»). Puedes cambiarla por un nombre más descriptivo.
• Endpoint de la API: la URL completa del endpoint que recibirá el webhook (por ejemplo: https://api.example.com/webhook). Debe ser un endpoint HTTPS.
• Método HTTP:

Selecciona el método HTTP que se utilizará para enviar la solicitud de webhook a tu endpoint.
Opciones disponibles:

• POST: recomendado en la mayoría de los casos (crea un recurso o envía datos).
• PUT: sustituye por completo un recurso existente.
• PATCH: actualiza parcialmente un recurso existente.

Elige el método que corresponda a la forma en que tu API espera recibir los datos.

• Tipo de autenticación: elige el método de autenticación que utiliza tu endpoint.

• Al seleccionar Autenticación básica, aparecen dos campos: Nombre de usuario y Contraseña. Introduce los datos tal cual: Drimify genera automáticamente la cabecera Authorization: Basic. No necesitas codificar nada.
• Al seleccionar Cabecera personalizada, aparece el campo adicional Nombre de la cabecera personalizada, donde puedes introducir el nombre de la clave de la cabecera.
• Clave API: el valor secreto que se envía mediante el método de autenticación seleccionado.
• Verificar conexión: haz clic en este botón antes de guardar para comprobar si Drimify puede conectarse a tu endpoint con las credenciales proporcionadas.

Obtener el token de un endpoint de autenticación (llamada previa)

Algunas API requieren que te autentiques primero: envías una solicitud a un endpoint de autenticación con tus credenciales, recibes un token y lo utilizas en la llamada del webhook. Drimify puede gestionar este proceso automáticamente.

Cuando el tipo de autenticación es Clave API, Token Bearer o Cabecera personalizada, aparece la casilla «Obtener este token de un endpoint de autenticación». Al marcarla, el campo de la credencial estática se sustituye por los ajustes de la llamada previa que se indican a continuación. En el caso de Cabecera personalizada, el campo del nombre de la cabecera sigue visible y el token obtenido se envía en esa cabecera.

El token obtenido se incluye según el tipo de autenticación:

• Token Bearer → Authorization: Bearer <token>
• Clave API → X-API-KEY: <token>
• Cabecera personalizada → <your header name>: <token>

Elegir uno de los tres métodos

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

• Campos: URL del token, ID de cliente, Secreto de cliente, Ámbito (opcional).
• Drimify envía una solicitud OAuth2 estándar de tipo client_credentials y obtiene el token de access_token. La duración del token se toma del valor expires_in que devuelve el servidor.

Inicio de sesión mediante JSON: para endpoints de inicio de sesión que reciben un cuerpo JSON y devuelven un token.

• Campos: URL de autenticación, Cuerpo (lista de pares clave/valor), Ruta del token.
• Drimify envía una solicitud POST con un cuerpo JSON generado a partir de las filas de pares clave/valor (p. ej., las filas email = a@b.com y password = secret generan {"email":"a@b.com","password":"secret"}).
• Ruta del token indica a Drimify dónde se encuentra el token en la respuesta JSON mediante la notación de puntos; por ejemplo, data.access_token o simplemente token si está en el nivel superior.

Personalizado: para los casos que no encajen en ninguno de los dos métodos anteriores.

• Campos: URL de autenticación, Método HTTP (POST o GET), Cabeceras (lista de pares clave/valor), Cuerpo (lista de pares clave/valor), Codificación del cuerpo (JSON o form-urlencoded), Ruta del token.
• Con el método GET, la solicitud no tiene cuerpo: pasa los parámetros a través de las cabeceras o de la URL de autenticación.
• Si añades una cabecera Content-Type manualmente, tendrá prioridad sobre la que se derive de la codificación del cuerpo.

Listas de pares clave/valor (cuerpo y cabeceras)

Cada fila tiene una clave, un valor y una casilla «Confidencial» (marcada por defecto). Puedes añadir y eliminar filas, pero no editarlas directamente: para modificar una fila, elimínala y vuelve a añadirla. Solo puedes indicar si un valor es confidencial al añadir la fila. Los valores confidenciales se ocultan después de guardar y no vuelven a mostrarse, ni en el formulario ni en los registros.

Caché de tokens y reintentos

• Los tokens OAuth2 se almacenan en caché durante el tiempo indicado en expires_in.
• Para Inicio de sesión mediante JSON y Personalizado, configura la Validez del token (minutos). Si dejas el campo vacío, se aplicará el valor predeterminado de 60 minutos.
• Los tokens se conservan en caché durante un máximo de 7 días.
• Si tu endpoint devuelve un código 401 mientras se está utilizando un token almacenado en caché, Drimify descarta el token, vuelve a autenticarse y reintenta la llamada una vez.
• Si falla la llamada previa (por un error, por agotarse el tiempo de espera o porque no se encuentra ningún token en la ruta indicada), el webhook no se envía sin autenticación: la entrega falla, se registra el error y la cola de entregas vuelve a intentarlo de la forma habitual.

Verificar la conexión con una llamada previa

El botón Verificar conexión también admite la llamada previa: primero se autentica en tu endpoint de autenticación y después realiza la llamada de prueba con el token obtenido.

Integración con HubSpot

Al seleccionar HubSpot, el panel muestra:

• Nombre de la integración: por defecto, «Integración con HubSpot».
• Clave API / Token de acceso: pega aquí el token de acceso de tu aplicación privada de HubSpot. HubSpot retiró las claves API antiguas en 2022, por lo que debes utilizar un token de aplicación privada generado desde tu cuenta de HubSpot en: Configuración → Integraciones → Aplicaciones privadas.
• Verificar conexión: comprueba el token con la API de HubSpot antes de guardar.

Integración con Salesforce

Al seleccionar Salesforce, el panel muestra:

• Nombre de la integración: por defecto, «Integración con Salesforce».
• Dominio de Salesforce: la URL de tu instancia de Salesforce (por ejemplo: yourcompany.my.salesforce.com).
• Clave de consumidor y secreto de consumidor: se obtienen de una aplicación conectada configurada en Salesforce en: Configuración → Administrador de aplicaciones → Nueva aplicación conectada. Drimify utiliza el flujo de credenciales de cliente de OAuth 2.0.
• Nombre del campo de ID externo: el nombre de API del campo utilizado para identificar los registros al crearlos o actualizarlos (upsert), normalmente algo como Email_External_Id__c u otro campo personalizado de ID externo del objeto Contacto. Este campo debe estar marcado como ID externo en Salesforce. Drimify crea o actualiza Contactos. Los clientes potenciales aún no son compatibles.
• Origen del ID externo: un menú desplegable que te permite seleccionar qué campo de datos de Drimify se utilizará como clave para identificar los registros (por ejemplo: Email).
• Verificar conexión: comprueba la conexión OAuth con Salesforce antes de guardar.

⚠️ Campos obligatorios de Salesforce

Salesforce exige que se rellenen determinados campos del objeto Contacto. Para crear un contacto, se requiere, como mínimo:

• lastName

Aunque Email no es obligatorio en el esquema predeterminado de Salesforce, casi siempre es necesario como ID externo para identificar correctamente los registros y evitar duplicados al crearlos o actualizarlos. Sin una coincidencia fiable basada en un ID externo, Salesforce puede crear registros duplicados o devolver un error.

Práctica recomendada

Asigna siempre, como mínimo:

• Apellido
• Email

al conectar con Salesforce. Si omites Apellido, el webhook fallará y el registro no se creará ni se actualizará.

Asignación de campos

La opción Asignar campos, disponible para los tres tipos de integración, te permite especificar exactamente qué campos de datos de Drimify se envían a tu integración y con qué nombres de clave.
Haz clic en + Añadir campo para añadir una fila de asignación.

Cada fila consta de:

• Campo del webhook (izquierda): el nombre de la clave que aparecerá en los datos enviados (lo defines tú según los requisitos de tu integración).
• → Campo de origen (menú desplegable de la derecha): el origen del valor de este campo. Puedes:
• • Seleccionar un campo de datos de Drimify (p. ej., Referencia de la app, Email o Puntuación) para enviar un valor dinámico obtenido del participante.
  • Seleccionar Valor estático para enviar un valor fijo cada vez que se active el webhook. Aparecerá un campo de texto adicional en el que podrás introducir el valor (p. ej., My_Value). Resulta útil para enviar constantes, como el nombre de un evento, un identificador de origen o una etiqueta de entorno.

Campos de origen de Drimify disponibles

Puedes añadir tantas asignaciones como necesites.
Para eliminar una asignación, haz clic en el icono de la papelera situado a la derecha de la fila.## Cómo indicar en tu CRM que un contacto procede de Drimify

Drimify no asigna una fuente automáticamente, pero puedes hacerlo mediante el mapeo de campos, tanto en Salesforce como en HubSpot:

1. En tu CRM, crea un campo para guardar la fuente. En Salesforce, debe ser un campo de texto en el objeto Contacto (por ejemplo, Drimify_Source__c). En HubSpot, debe ser una propiedad de contacto (por ejemplo, drimify_source).
2. En tu integración de Drimify, abre Mapear campos y añade una fila con el nombre de API de ese campo a la izquierda. Selecciona Valor estático a la derecha e introduce Drimify.
3. Para saber en qué experiencia ha participado el contacto, añade una segunda fila que asocie otro campo (por ejemplo, Drimify_Game__c) con Referencia de la aplicación.

Disponible en espacios de trabajo

En la parte inferior del formulario de integración, la sección Disponible en espacios de trabajo te permite controlar qué espacios de trabajo pueden utilizar la integración mediante el interruptor situado junto a cada uno.
Haz clic en Seleccionar todo para habilitar la integración en todos los espacios de trabajo a la vez.

Guardar y gestionar integraciones

Una vez completados todos los campos, haz clic en Guardar cambios para crear la integración. Esta aparecerá en la lista principal de Integraciones. Puedes editar o eliminar las integraciones existentes desde esta lista en cualquier momento. Haz clic en Cancelar para descartar los cambios sin guardar.

Integraciones de servidor de correo electrónico

Las integraciones de servidor de correo electrónico te permiten enviar correos transaccionales (por ejemplo, confirmaciones, resultados o mensajes de seguimiento) directamente desde tus experiencias de Drimify a través de tu proveedor de correo electrónico habitual.

Añadir una 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. Selecciona 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 muestra como remitente del correo
• Correo electrónico del remitente – Dirección de correo electrónico utilizada para enviar los mensajes (no se aplica a Drimify; consulta la información más abajo)
• Correo electrónico en CCO (opcional) – Añade una dirección de correo electrónico para recibir una copia oculta de todos los mensajes salientes

Autenticación

Cada proveedor requiere unas credenciales específicas. Consulta los detalles en la sección de configuración de cada proveedor que aparece más abajo.

Probar la conexión

Tras introducir tus credenciales, haz clic en Enviar correo de prueba para comprobar que tu integración funciona correctamente. Si la conexión es válida, aparecerá la confirmación «Correo de prueba enviado correctamente».

Campos de parámetros de la plantilla

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

• Nombre del parámetro – Nombre de la variable que utiliza tu plantilla de correo electrónico
• Campo – Dato correspondiente de Drimify (por ejemplo, Nombre, Email, Puntuación, etc.)

Haz clic en Añadir campo para crear más asociaciones.

Disponible en espacios de trabajo

Selecciona qué espacios de trabajo pueden utilizar esta integración de servidor de correo electrónico.

Configuración de cada proveedor

Amazon SES

Qué necesitas:

• Un usuario de AWS IAM con permisos ses:SendEmail
• Una clave de acceso a la API y una clave privada de la API (disponibles en AWS IAM)
• Tu región de AWS (por ejemplo, eu-west-1, us-east-1)
• Un token de sesión (solo si utilizas credenciales temporales o de STS)
• Una dirección de correo electrónico del remitente o un dominio verificados en Amazon SES

Pasos:

1. En AWS IAM, crea un usuario con permisos de envío de SES y genera un par de claves de acceso
2. En Drimify, introduce tu Clave de acceso a la API, tu Clave privada de la API y tu Región
3. Si utilizas credenciales temporales, introduce también el Token de sesión
4. Asegúrate de que la dirección de correo electrónico del remitente o el dominio estén verificados en Amazon SES
5. Haz clic en Enviar correo de prueba para validar la conexión
6. Guarda tu integración

Brevo

Qué necesitas:

• Una clave de API de Brevo

Pasos:

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

Drimify

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

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

Pasos:

1. Selecciona Drimify como proveedor
2. Introduce el Nombre del remitente y el Correo electrónico de respuesta
3. Si lo deseas, añade un Correo electrónico en CCO
4. Selecciona los espacios de trabajo que podrán utilizar esta integración y guarda los cambios

Mailgun

Qué necesitas:

• Una clave de API de Mailgun
• Tu dominio de envío registrado en Mailgun
• Tu región de la API (US o EU)

Pasos:

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

Mailjet

Qué necesitas:

• Una clave de acceso a la API y una clave privada de la API de Mailjet

Pasos:

1. En tu cuenta de Mailjet, ve a Ajustes de la cuenta → API REST → Gestión de claves de API
2. Copia tu Clave de acceso a la API y tu Clave privada de la 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

Qué necesitas:

• Una clave de API de Mandrill (Mandrill es un complemento de Mailchimp para el envío de correos transaccionales)

Pasos:

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

SendGrid

Qué necesitas:

• Una clave de API de SendGrid con permisos de envío de correo

Pasos:

1. En tu cuenta de SendGrid, ve a Ajustes → Claves de API y crea una clave con permisos de Envío de correo
2. Pega la Clave de API en Drimify
3. Haz clic en Enviar correo de prueba para validar la conexión
4. Guarda tu integración

Tipimail

Qué necesitas:

• Un usuario de API y una clave de API de Tipimail (Tipimail es el servicio de correo electrónico transaccional de Sarbacane)

Pasos:

1. En tu cuenta de Tipimail, ve a Ajustes → SMTP y API y busca tu Usuario de API y tu Clave de 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

Qué necesitas:

• El nombre de host de tu servidor SMTP
• El puerto SMTP (normalmente, 587 para TLS o 465 para SSL)
• El usuario SMTP (normalmente, tu dirección de correo electrónico)
• La contraseña SMTP

Pasos:

1. Obtén tus credenciales SMTP a través de tu proveedor de alojamiento de correo electrónico o de la configuración del servidor
2. En Drimify, introduce tu Host, Puerto, Usuario y Contraseña
3. Haz clic en Enviar correo de prueba para validar la conexión
4. Guarda tu integración

Actualizado el: 03/11/2026