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: octubre 29, 2019

Requisitos

Marketing Hub  Enterprise
Sales Hub  Enterprise
Service Hub  Enterprise

Utiliza webhooks en workflows para pasar información de HubSpot a otra aplicación web.

Ten en cuenta: Las cuentas de Marketing Hub Pro o Sales Hub Pro adquiridas antes de 1 de noviembre del 2018 tendrán acceso heredado a la acción Desencadenar un webhook del Workflows. 


Entender los webhooks

Los Webhooks envían datos de una aplicación web a otra después de que finaliza una acción en la aplicación fuente. Puedes utilizar webhooks para enviar datos, notificaciones, alertas o cualquier otra actualización en tiempo real.

Algunos ejemplos de casos de uso común para emplear webhooks son los siguientes:

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

  • Enviando datos de contacto en un sistema externo que crea una prueba del software para el contacto.

  • Alertas de chat enviadas desde tu sistema externo a la transmisión de chat de tu empresa que permite a los empleados saber que algo importante ha ocurrido.

 

 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, haz selecciona Desencadenar un webhook.
  • Introduce la URL del webhook.

Nota: las URL de webhook están restringidas a un protocolo de seguridad y deben comenzar con HTTPS.

  • Selecciona la casilla de comprobación Usar solicitud de firma para autentificar cualquier solicitud de tu webhook e ingresa la ID de la aplicación. Más información sobre cómo verificar las solicitudes de firma.
  • Haz clic en Guardar.

Ten en cuenta: la acción Desencadenar un webhook solo admite el método PUBLICAR.

 

Probar el webhook

Después de crear tu workflow con una acción web, puedes ejecutar una prueba rápida con una URL de webhook ficticia. En el navegador, navega a https://webhook.site y copia la URL única que se crea automáticamente. En el campo URL de webhook en tu acción de webhook, pega la URL.

El ejemplo siguiente muestra el cuerpo de solicitud del webhook, que revela la meta información sobre el contacto específico, incluida la información de contacto, los envíos de formularios, las membresías de la lista, etc. Cuando la acción del workflow se activó, HubSpot envió el registro completo del contacto en formato JSON a la URL especificada.

Imagen agregada por el usuario

El sistema de recepción puede analizar los datos JSON y usarlos para su propia aplicación.

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.

 

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: