Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.
Workflows

Usar webhooks con workflows de HubSpot

Última actualización: marzo 18, 2022

Requisitos

Operations Hub Professional, Enterprise

Utiliza los webhooks en los workflows para enviar solicitudes POST o GET desde tus workflows.  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. 

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 de desarrollador 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 Workflows.
  • 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, agrega parámetros de consulta a la URL del Webhook. Si no se han agregado parámetros de consulta, se enviará una solicitud genérica POST o GET.  
  • Para autenticar cualquier petición a tu webhook:
    • Haz clic en el menú desplegable Tipo de autenticación y selecciona Incluye la firma de la solicitud en el título.
    • Introduce tu ID de aplicación de HubSpot. Más información sobre cómo verificar las solicitudes de firma.
  • 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. 

Después de probar tu webhook, puedes seleccionar los campos que se emitirán para utilizarlos 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.

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:

Was this article helpful? *
This form is used for documentation feedback only. Learn how to get help with HubSpot.