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: septiembre 25, 2020

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. 

Hay una variedad de usos para webhooks, tales como enviar datos y notificaciones.

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.

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

  • Enviar 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.

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.

Ten en cuenta: HubSpot volverá a intentar los webhooks fallidos hasta 3 días.

Para obtener más información sobre los aspectos técnicos de webhooks, echa un vistazo a nuestra documentación de desarrolladores.

 Configurar un webhook en el Workflows

Ten en cuenta: Las cuentas Marketing Hub Pro  o los cupos Sales Hub Pro  comprados antes del 1 de noviembre de 2018, tendrán acceso a la accion de workflow Activar un webhook  
  • 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. 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.

trigger-a-webhook-action

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

User-added image

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

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.

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:

/es/workflows/how-do-i-use-webhooks-with-hubspot-workflows