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: January 3, 2019

Enterprise

Requisitos

Marketing Hub
marketing-enterprise
Enterprise
Sales Hub
sales-enterprise
Enterprise
Service Hub
service-enterprise
Enterprise

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

Nota: Usuarios que compraron  Marketing Hub Pro o Sales Hub Pro antes del 1 de noviembre de 2018 también tendrán acceso a la acción de activación de un workflow de webhook. Los usuarios después del 1 de noviembre de 2018 tendrán que comprar Marketing Hub Enterprise o Sales Hub Enterprise  para obtener acceso a la acción del activador de un workflow de webhook.

¿Qué son los webhooks?

Los Webhooks se utilizan para enviar datos de una aplicación web a otra después de que se complete 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 un workflow basado en contactos

Estos pasos solo se aplican a los workflows basados en contactos.

  • En tu cuenta de HubSpot, dirígete a Automatización > Workflows.
  • Haz clic en el nombre del workflow basado en el contacto para editar.
  • Haz clic en el ícono + para agregar una acción.
  • En el panel derecho, haz clic en Activar un webhook.
  • Haz clic en el menú desplegable Método y selecciona GET o POST.
    • GET: envía una solicitud GET (recuperar datos) a la URL especificada.
    • POST: envía una solicitud POST (enviar datos) a la URL especificada.
  • Introduce la URL del webhook.

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

  • Si la solicitud de tu sistema requiere autentificación, selecciona la casilla de comprobación ¿Usar autentificación? y agrega un nombre de usuario y contraseña.
  • Haz clic en Guardar.

Configurar un webhook en otros tipos de workflows

Estos pasos se aplican a workflows basados en empresa, basados en negocio, basados en ticket y basados en cotización.

  • En tu cuenta de HubSpot, dirígete a Automatización > Workflows.
  • Haz clic en el nombre del workflow basado en empresa, basado en negocio, basado en ticket o basado en cotización para editarlo.
  • Haz clic en el icono + para agregar una acción y en el panel derecho, haz clic en Activar 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.

  • Haz clic en Guardar.

Nota: la acción de activación de un webhook en workflows basados en empresa, basados en negocio, basados en ticket y basados en cotización solo admite el método POST.

Pruebar tu 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 tu navegador, ve 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.

User-added image
User-added image

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.