Workflows

¿Cómo utilizo webhooks con los flujos de trabajo de HubSpot?

Última actualización: March 7, 2016

Este artículo es para los desarrolladores web que desean utilizar la función de webhooks de los flujos de trabajo para pasar la información desde HubSpot a otra aplicación web.


¿Qué son los webhooks?

Los webhooks son una forma de enviar información desde una aplicación web a otra, después de completar algunas acciones en la aplicación fuente. Son diferentes de los correos electrónicos, ya que los correos son comunicaciones entre seres humanos y los webhooks son mensajes enviados entre un software y otro a través de una solicitud HTTP. Puedes utilizar webhooks para enviar datos, notificaciones, avisos o cualquier otra actualización en tiempo real. En pocas palabras, los webhooks presentan una forma realmente poderosa para automatizar el marketing, lo que te permite enviar datos desde una aplicación o un sistema a otro.

Casos de uso frecuente y ejemplos

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

  • Publicar datos de contactos de HubSpot en otro sistema, como un sistema de gestión de la relación con el cliente (CRM), cuando ese contacto completa un formulario en particular en tu sitio.

  • Enviar datos de contactos a un sistema externo que crea una prueba del software para el usuario que se ha registrado.

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

¿Cómo se puede configurar un webhook en HubSpot?

Crea tu flujo de trabajo y agrega una acción que incluya «Desencadenar un Webhook». Ahora, debes decidir si deseas enviar datos a otro sistema o si deseas recuperar los datos.

La opción OBTENER envía una solicitud para OBTENER (recuperar datos) a la URL especificada.

La opción POST envía una solicitud POST (enviar datos) a la URL especificada.

Imagen añadida por el usuario
Una vez que hayas seleccionado el método de HTTP, agrega la URL de webhook con la que desees interactuar.

Si la solicitud a tu sistema requiere autenticación, marca la casilla en la acción y agrega un nombre de usuario y una contraseña. En este caso, el agente de usuario emplea el encabezado de autenticación. Básicamente, el nombre de usuario y la contraseña se combinan en una cadena («nombre de usuario:contraseña»), que luego se codifica (Basic Base64).

¿Cómo lo pruebas?

Después de que hayas creado tu flujo de trabajo con una acción de webhook, puedes realizar una prueba muy rápida con una URL de webhook de prueba. Ve a http://requestb.in/ y crea un «Request Bin». Utiliza esa URL como la URL del webhook en tu acción de webhook.

Imagen añadida por el usuario
Ahora, inscribe un contacto al visitar el registro de un contacto individual > Flujos de trabajo > selecciona un flujo de trabajo activo > Inscribir contacto.

Aquí te presentamos un ejemplo del cuerpo de solicitud del webhook anterior, que revela meta información sobre el contacto específico, que incluye información del contacto, envíos de formularios, membresías de la lista, etc. Cuando se desencadenó la acción del flujo de trabajo, HubSpot envió el registro completo del contacto con formato JSON a la dirección URL especificada.

Imagen añadida por el usuario
Imagen añadida por el usuario

El sistema receptor puede analizar esos datos JSON y usarlos para su propia aplicación.

Para obtener más información sobre webhooks, consulta la documentación de referencia de webhooks. Si tienes preguntas adicionales acerca de la implementación específica de webhooks con HubSpot, escríbenos en developers.hubspot.com/forum.