Usar webhooks con workflows de HubSpot

Usa webhooks en workflows para enviar u obtener información entre HubSpot y otras herramientas externas. Hay una variedad de usos para los webhooks, ejemplos de casos de uso populares para los webhooks incluyen:

• Publicar datos de contactos de HubSpot a otro sistema, como un CRM, cuando ese contacto completa un formulario en particular en tu sitio.

• Enviar datos de negocios a un sistema externo de gestión de envíos para crear una orden de compra.

• Enviar alertas de chat desde tu sistema externo al flujo de chat de tu empresa para notificar a los empleados que ha ocurrido algo importante.

• Recuperar datos de otro sistema para actualizar tus registros de HubSpot. 

Puedes enviar solicitudes POST y GET utilizando workflows. HubSpot regula el tráfico de webhook por separado de otros procesos de workflow. Esto se hace para optimizar el rendimiento del workflow y el rendimiento del webhook. Cuando un webhook es lento o los horarios, la acción del workflow puede tardar más de lo esperado.

Nota: HubSpot volverá a intentar webhooks fallidos hasta por tres días, comenzando un minuto después de la falla. Las fallas posteriores se volverán a intentar a intervalos cada vez mayores, con un intervalo máximo de ocho horas entre los intentos. Descubre las excepciones de códigos de error específicos en la documentación para desarrolladores de HubSpot.

Más información sobre webhooks en la documentación de los desarrolladores web. Si tienes preguntas sobre tu implementación específica de webhooks con HubSpot, ponte en contacto con los foros de HubSpot para desarrolladores.

 Configurar un webhook en el Workflows

• En tu cuenta de HubSpot, dirígete a Automatización > Workflows.
• Haz clic en el nombre del workflow.
• Haz clic en el ícono + para agregar una acción.
• En el panel derecho, selecciona Enviar un webhook.
• Haz clic en el menú desplegable Método y selecciona POST o GET. 
• Introduce la URL del webhook. Las URL de webhook están restringidas a un protocolo de seguridad y deben comenzar con HTTPS. Para solicitar información específica, puedes agregar parámetros de consulta como ?queryparameter=abc a la URL del Webhook. Si no se han agregado parámetros de consulta, se enviará una solicitud genérica POST o GET.  
• Configura tu tipo de autenticación para autenticar las solicitudes a tu webhook: 
  • Para utilizar una firma de solicitud en el título de tu webhook: 
    • Haz clic en el menú desplegable Tipo de autenticación. Luego, selecciona Incluye la firma de la solicitud en el título.
    • Luego, introduce tu ID de aplicación de HubSpot. Más información sobre cómo verificar las solicitudes de firma.

• • También puedes utilizar una clave API o una aplicación pública creada a través de una cuenta de desarrollador para la autenticación.

Nota: desde el 30 de noviembre de 2022, las claves de API de HubSpot están obsoletas y ya no son compatibles. Puedes seguir utilizando claves API externas para la autenticación en los workflows de HubSpot.

• • • Cuando se utiliza una clave de API para la autenticación, el nombre de la clave de API y la ubicación de la clave de API utilizada dependen de cómo esté configurado el webhook. Por razones de seguridad, la clave de API no se mostrará en ninguna solicitud de prueba. Para utilizar una clave de API: 
      • Haz clic en el menú desplegable Tipo de autenticación. Luego, selecciona Clave API. 

• • • • Introduce el nombre de tu clave de API.
      • Haz clic en el menú desplegable Ubicación de clave de API. Luego, selecciona Parámetros de consulta o Título de la solicitud. Más información sobre el uso de claves de API en HubSpot.
    • Si estás haciendo una solicitud a una de nuestras API de HubSpot:
      • Haz clic en el menú desplegable Clave de API y selecciona un secreto. El valor secreto debe tener el formato Bearer [TU_TOKEN].
      • Establece el valor de nombre de clave de API en Autorización.
      • Establece el valor de la ubicación de la clave de API en Título de la solicitud.
• Si estás configurando una solicitud POST, puedes elegir incluir todas las propiedades del registro de CRM o enviar solo propiedades específicas:
  • Para incluir todas las propiedades, en la sección Personalizar cuerpo de la solicitud, selecciona Incluir todas las propiedades.  
  • Para incluir solo propiedades específicas:
    
    • En la sección Personalizar el cuerpo de la solicitud, selecciona Elige propiedades específicas.
    • Haz clic en el menú desplegable Elegir propiedad. Luego, haz clic en [objeto] en este workflow y selecciona una propiedad.
    • Para cambiar el nombre de una propiedad en el webhook, edita el campo de texto Nombre de la propiedad . Esto solo actualizará el nombre de la propiedad en la solicitud POST, no actualizará el nombre de la propiedad o el nombre interno en HubSpot.  
    • Para agregar otra propiedad, haz clic en Agregar propiedad.
    • Para eliminar una propiedad, haz clic en el delete icono de la papelera.
         

• Si estás configurando una solicitud GET, puedes utilizar propiedades como parámetros de consulta:
  
  • En la sección Parámetros de consulta , haz clic en el menú desplegable Elige propiedad. Luego, haz clic en [objeto] en este workflow y selecciona una propiedad.
  • Para cambiar el nombre de una propiedad en el parámetro de consulta, edita el campo de texto Nombre de la propiedad. Esto solo actualizará el nombre de la propiedad en la solicitud GET, no actualizará el nombre de la propiedad o el nombre interno en HubSpot.  
• • Para agregar otra parámetro de consulta, haz clic en Agregar parámetro de consulta.
  • Para eliminar una propiedad, haz clic en el deleteicono de la papelera.      
• Haz clic en Guardar.
  
  

Nota: para seleccionar varias salidas, la respuesta debe estructurarse como un objeto JSON.

Personalizar tu solicitud POST

Si estás configurando una solicitud POST, puedes elegir incluir todas las propiedades del registro de CRM o enviar solo propiedades específicas:

• Para incluir todas las propiedades, en la sección Personalizar cuerpo de la solicitud, selecciona Incluir todas las propiedades.  
• Para incluir solo propiedades específicas:
  
  • En la sección Cuerpo de la solicitud, seleccion Personalizar cuerpo de la solicitud.
  • Introduce la Clave y el Valor.
  • Para cambiar el nombre de una propiedad en el webhook, edita el campo de texto Clave . Esto solo actualizará el nombre de la propiedad en la solicitud POST, no actualizará el nombre de la propiedad o el nombre interno en HubSpot.  
  • Para agregar otra propiedad, haz clic en Agregar propiedad.
  • Para eliminar una propiedad, haz clic en el deleteicono de la papelera.
    
    

Personalice tus solicitudes GET

Si estás configurando una solicitud GET, puedes utilizar propiedades como parámetros de consulta para recuperar datos específicos: 

• En la sección Parámetros de consulta , introduce la Clave y luego selecciona una propiedad.
• Para cambiar el nombre de una propiedad en el parámetro de consulta, edita el campo de texto Nombre de la propiedad. Esto solo actualizará el nombre de la propiedad en la solicitud GET, no actualizará el nombre de la propiedad o el nombre interno en HubSpot.  
• Para agregar otra propiedad, haz clic en Agregar propiedad.
• Para eliminar una propiedad, haz clic en el deleteicono de la papelera.      
• Selecciona un Tipo de autenticación en el menú desplegable.
• Haz clic en Guardar.
  
  

Probar tu webhook dentro de HubSpot

Al configurar tu webhook POST o GET, puedes ejecutar una prueba para ver la respuesta del webhook. Durante la prueba, mientras se envían y recuperan datos de un tercero, los registros existentes en HubSpot no se verán afectados. Si estás utilizando una clave de API para la autenticación, la clave de API no se mostrará en ninguna solicitud de prueba.

Después de probar tu webhook, puedes seleccionar los campos que se utilizarán como entradas más adelante en tu workflow. Selecciona sólo las salidas disponibles en cada respuesta. Si la salida se utiliza en una acción posterior pero no está disponible en la respuesta, la acción fallará.    

• En el panel lateral, haz clic en Probar acción para ampliar la sección. 
• Haz clic en el menú desplegable Objeto y luego selecciona un Registro con el cual realizar la prueba.
• Haz clic en Probar. 
• Para comprobar los detalles del webhook, selecciona la pestaña Respuesta o Solicitud. En cada pestaña, puedes hacer clic en Abrir todo para ampliar todas las secciones, o en Contraer todo para contraer todas las secciones
  
  • En la pestaña Respuesta, haz clic en encabezados: o cuerpo: para ampliar cada sección. 
  • En la pestaña Solicitud , haz clic en httpHeaders: para ampliar la sección
    
    

Probar tu webhook externamente

Después de crear tu workflow con una acción de webhook, puedes ejecutar una prueba rápida con una URL de webhook ficticia:

• En el navegador, ve hastahttps://webhook.site y copia la URL única.
• En el campo URL de webhook en tu acción de webhook, pega la URL.

• Una vez activado el workflow, puedes inscribir manualmente un contacto de prueba. 

Cuando se desencadene la acción del webhook, se enviará un cuerpo de respuesta JSON al webhook que contiene toda la información sobre el contacto, incluyendo envíos de formularios, pertenencia a listas y todos los valores de las propiedades de contacto. El sistema de recepción puede analizar los datos JSON y usarlos para su propia aplicación.

Si se desencadena una acción de webhook con una solicitud GET, se enviará una solicitud GET genérica, a menos que se hayan aplicado parámetros de consulta adicionales.   

Nota: los valores de propiedad históricos solo se devolverán en workflows basados en contactos. Webhooks utilizados en todos los demás tipos de workflows solo devolverá el valor más reciente.

Verificar la solicitud de firmas en los webhooks de Workflows

Donde seleccionaste Solicitar firma en la sección Autentificación de la acción Desencadenar un webhook, HubSpot va a completar el webhook con un encabezado de firma X-HubSpot con un código hash SHA-256 de la concatenación del secreto de la aplicación para esta, el método HTTP, la URI y el cuerpo no analizado. Más información sobre esto en la documentación de los desarrolladores.

Para verificar que las solicitudes recibidas en tu URL son de HubSpot:

• Ten una cuenta de desarrollador. Si no tienes una, regístrate para una cuenta de desarrollador.
• Ten una aplicación. Si no tienes una aplicación, obtén más información sobre cómo crear una aplicación.
• Verifica el valor del código hash de la firma.