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 cada vez que un usuario completa o interactúa con tu aplicación. Puedes conectar a un Custom API, HubSpot o Salesforce — y para cada uno, 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 de posición "No hay 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 desplegable (predeterminado en Todo). Las tres integraciones disponibles son:

• Custom API — para cualquier punto final de api REST que controles
• HubSpot — para automatización de CRM y marketing vía HubSpot
• Salesforce — para CRM de Salesforce

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

Integración Custom API

Autenticación

Tras seleccionar Custom API, se abrirá el panel Añadir Integración con los siguientes campos:

• Nombre de la Integración Una etiqueta para tu propia referencia (predeterminado a "Integración Custom API"). Puedes renombrarla 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.
• **Método HTTP : **

Selecciona el método HTTP utilizado para enviar la solicitud de webhook a tu endpoint.

Las opciones son:

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

Elige el método que se adapte a cómo tu API espera recibir datos.

• 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 Nombre del Encabezado Personalizado donde ingresas el nombre de la clave del encabezado.
• API Key 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 endpoint con las credenciales proporcionadas antes de guardar.

Integración HubSpot

Tras seleccionar HubSpot, el panel muestra:

• Nombre de la Integración Predeterminado a "Integración HubSpot".
• API Key / Access Token Pega aquí tu Token de Acceso de Aplicación Privada de HubSpot. HubSpot retiró las API keys heredadas en 2022, así que deberías usar un token de App Privada generado desde tu cuenta de HubSpot bajo Configuraciones → Integraciones → Aplicaciones 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 la Integración Predeterminado a "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 App Conectada configurada en Salesforce bajo Setup → Administrador de Aplicaciones → Nuevo App Conectada. Drimify utiliza el flujo de credenciales de cliente OAuth 2.0.
• Nombre del campo externo id El nombre API del campo utilizado para coincidir (upsert) registros — típicamente Email_External_Id__c o un campo externo personalizado en el objeto Contacto o Lead. Este campo debe estar marcado como External ID en Salesforce.
• Fuente del ID Externo Un menú desplegable para seleccionar qué campo de datos de Drimify usar como la clave de coincidencia (por ejemplo, Email).
• Verificar Conexión Prueba la conexión OAuth de Salesforce antes de guardar.

⚠️ Campos Requeridos para Salesforce

Salesforce aplica campos requeridos a nivel de objeto. Si estás haciendo upsert de Leads, Salesforce requiere al menos:

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

Si estás haciendo upsert de Contactos, Salesforce requiere:

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

Email no es requerido por el esquema de Salesforce por defecto, pero casi siempre se necesita como el External ID para coincidir y desduplicar correctamente los registros en el upsert. Sin una coincidencia de ID externa confiable, Salesforce creará registros duplicados o devolverá un error.

Mejor práctica: Siempre mapea al menos Last Name y Email cuando te conectes a Salesforce. Omitir el Apellido hará que el webhook devuelva un error y el registro no será creado o actualizado.

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 añadir una fila de mapeo. Cada fila consta de:

• Campo Webhook (izquierda) — el nombre clave que aparecerá en el payload saliente (lo defines tú, coincidiendo con los nombres de campos esperados de tu integración)
• → Campo Fuente (desplegable a la derecha) — el campo de datos de Drimify a mapear hacia él.

Campos Fuente Disponibles de Drimify

Puedes añadir tantas filas como sea necesario. 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 Disponible en Espacios de Trabajo. Usa el interruptor junto a cada espacio de trabajo para controlar qué espacio de trabajo puede usar 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 completos, 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: 22/04/2026