Configurar Integraciones De Webhook en Drimify

Las integraciones de webhook de Drimify te permiten enviar automáticamente datos de participantes a servicios externos siempre que un usuario complete o interactúe con tu aplicación. Puedes conectar con un Custom API, HubSpot o Salesforce, y para cada uno, puedes definir exactamente qué campos de datos se transmiten.

Comenzando

Dirígete a Configuración → Integraciones. Si aún no se han configurado integraciones, verás la pantalla de marcador "Aún no hay integraciones de webhook". 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 integración.

Seleccionando un Tipo de Integración

Aparecerá un modal titulado "Seleccionar Integración de Webhook". Puedes filtrar por categoría usando el menú desplegable (que por defecto está en Todos). Las tres integraciones disponibles son:

• Custom API — para cualquier endpoint REST de API que controles.
• HubSpot — para automatización de CRM y Marketing a través de HubSpot.
• Salesforce — para CRM de Salesforce.

Haz clic en el mosaico del tipo de integración que deseas configurar.

Integración de Custom API

Autenticación

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

Nombre de la Integración Una etiqueta para tu propia referencia (por defecto "Custom API Integration"). Puedes renombrarlo a algo descriptivo.

API Endpoint La URL completa de tu receptor de webhook (por ejemplo, https://api.example.com/webhook). Debe ser un endpoint HTTPS.

Tipo de Clave API Elige el método de autenticación que usa tu endpoint. Las opciones son:

Cuando se selecciona Custom Header, aparece un campo adicional de Nombre de Cabecera Personalizada donde introduces el nombre de la clave de la cabecera.

Clave API El valor secreto enviado con el método de autenticación elegido.

Verificar Conexión Haz clic en este botón para probar si Drimify puede alcanzar tu endpoint exitosamente con las credenciales proporcionadas antes de guardar.

Integración de HubSpot

Después de seleccionar HubSpot, el panel muestra:

Nombre de la Integración Por defecto "HubSpot Integration".

API Key / Access Token Pega aquí tu Token de Acceso de Aplicación Privada de HubSpot. HubSpot retiró las claves API heredadas en 2022, por lo que debes usar un token de aplicación privada generado desde tu cuenta de HubSpot bajo Configuración → Integraciones → Aplicaciones Privadas.

Verificar Conexión Prueba el token contra la API de HubSpot antes de guardar.

Integración de Salesforce

Después de seleccionar Salesforce, el panel muestra:

Nombre de la Integración Por defecto "Salesforce Integration".

Dominio de Salesforce La URL de tu instancia de Salesforce (por ejemplo, yourcompany.my.salesforce.com).

Consumer Key y Consumer Secret Estos se obtienen desde una Aplicación Conectada configurada en Salesforce bajo Configuración → Administrador de Aplicaciones → Nueva Aplicación Conectada. Drimify utiliza el flujo de credenciales del cliente OAuth 2.0.

Nombre del Campo id Externo El nombre de la API del campo utilizado para hacer coincidir (upsert) registros — típicamente Email_External_Id__c o un campo id externo personalizado en el objeto Contacto o Lead. Este campo debe estar marcado como ID Externo en Salesforce.

Fuente de ID Externo Un menú desplegable para seleccionar qué campo de datos de Drimify usar como clave de coincidencia (por ejemplo, Email).

Verificar Conexión Prueba la conexión OAuth de Salesforce antes de guardar.### ⚠️ Campos Obligatorios para Salesforce

Salesforce aplica campos obligatorios a nivel del objeto. Si estás insertando o actualizando Leads, Salesforce requiere al menos:

• Last Name (lastName) — obligatorio para la fecha de creación del Lead.

Si estás insertando o actualizando Contactos, Salesforce requiere:

• Last Name (lastName) — obligatorio para la fecha de creación del Contacto.

El Email no es obligatorio por defecto en el esquema de Salesforce, pero casi siempre es necesario como External ID para hacer correctamente el emparejamiento y la deduplicación de registros en la operación de upsert. Sin un emparejamiento confiable de ID externo, Salesforce creará registros duplicados o devolverá un error.

Mejor práctica: Siempre mapea como mínimo Last Name y Email cuando te conectes a Salesforce. Omitir el Apellido causará que el webhook devuelva un error y el registro no se creará ni actualizará.

Mapear Campo

Disponible en los tres tipos de integración, Mapear Campo 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 clave que aparecerá en la carga de datos saliente (lo defines tú, emparejando los nombres de campos esperados de tu integración).
• → Campo de origen (desplegable de la derecha) — el campo de datos de Drimify a mapear.

Campos de Origen Disponibles en Drimify

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

Disponible en Espacios de Trabajo

En la parte inferior de cada formulario de integración hay una sección llamada Disponible en Espacios de Trabajo. Usa el interruptor al lado de cada espacio de trabajo para controlar cuál puede usar esta integración. Haz clic en Seleccionar Todos para habilitarlo para todos los espacios de trabajo a la vez.

Guardar y Administrar Integraciones

Una vez que todos los campos estén completados, haz clic en Guardar Cambios para crear la integración. Aparecerá en la lista principal de Integraciones. Puedes editar o borrar integraciones existentes desde esa lista en cualquier momento.

Haz clic en Cancelar para descartar cualquier cambio no guardado.

Actualizado el: 06/03/2026