Configuración de Integraciones de Webhook en Drimify

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

Empezando

Dirígete a Mi Cuenta → Integraciones. Si aún no se han configurado integraciones, verás la pantalla de marcador "Sin integraciones de webhook todavía".

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.

Selección de un Tipo de Integración

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

• API Personalizada — para cualquier punto final de REST 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 cuadro del tipo de integración que deseas configurar.

Integración de API Personalizada

Autenticación

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

• Nombre de Integración Una etiqueta para tu propia referencia (por defecto "Integración de API Personalizada"). Puedes renombrarla a algo más descriptivo.
• Punto Final de API La URL completa de tu receptor de webhook (ej. https://api.example.com/webhook). Debe ser un punto endpoint HTTPS.
• Tipo de Clave API Elige el método de autenticación que tu punto final usa. Las opciones son:

• Cuando se selecciona Encabezado Personalizado, aparece un campo adicional Nombre del Encabezado Personalizado donde introduces el nombre clave del encabezado.
• 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 exitosamente tu punto final con las credenciales proporcionadas antes de guardar.

Integración de HubSpot

Después de seleccionar HubSpot, el panel muestra:

• Nombre de Integración Por defecto "Integración de HubSpot".
• Clave API / Token de Acceso Pega aquí tu HubSpot Token de Acceso de App Privada. HubSpot dejó de usar claves API heredadas en 2022, por lo que debes usar un token de app privada generado desde tu cuenta HubSpot bajo Configuraciones → Integraciones → Apps 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 Integración Por defecto "Integración de Salesforce".
• Dominio de Salesforce La URL de tu instancia de Salesforce (ej. yourcompany.my.salesforce.com).
• Clave del Consumidor y Secreto del Consumidor Estos se obtienen desde una App Conectada configurada en Salesforce bajo Setup → Administrador de Aplicaciones → Nueva App Conectada. Drimify utiliza el flujo de credenciales de cliente OAuth 2.0.
• Nombre del campo id externo El nombre de API del campo usado para hacer coincidir (insertar o actualizar) 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 (ej. Email).
• Verificar Conexión Prueba la conexión OAuth de Salesforce antes de guardar.

⚠️ Campos Obligatorios para Salesforce

Salesforce implementa campos obligatorios a nivel de objeto. Si estás realizando un upsert de Leads, Salesforce requiere como mínimo:

• Apellido (lastName) — obligatorio para la creación del Lead

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

• Apellido (lastName) — obligatorio para la creación del Contacto

Email no es necesario por defecto en el esquema de Salesforce, pero casi siempre es imprescindible como el ID Externo para hacer coincidir y deduplicar registros correctamente en el proceso de upsert. Sin una coincidencia fiable del ID externo, Salesforce creará registros duplicados o devolverá un error.

Mejor práctica: Siempre debes mapear al menos Apellido y Email al conectarte a Salesforce. Omitir el Apellido hará que el webhook devuelva un error y el registro no se creará o actualizará.

Mapeo De Campo

Disponible en los tres tipos de integración, Mapeo De 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 agregar una fila de mapeo. Cada fila consta de:

• Campo del Webhook (izquierda) — el nombre clave que aparecerá en el payload saliente (esto lo defines tú, ajustándolo a los nombres de campo esperados por tu integración)
• → Campo de Origen (desplegable derecho) — el campo de datos de Drimify a mapear

Campos de Origen de Drimify Disponibles

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

Al final de cada formulario de integración hay una sección de Disponible en Espacios de Trabajo. Usa el interruptor junto a cada espacio de trabajo para controlar qué espacio de trabajo puede utilizar esta integración. Haz clic en Seleccionar Todo para habilitarlo para todos los espacios de trabajo a la vez.

Guardar y Gestionar Integraciones

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

Haz clic en Cancelar para descartar cualquier cambio no guardado.

Actualizado el: 10/03/2026