Personaliza tus webhooks (BETA)

Si estás utilizando webhooks en flujos de trabajo para enviar peticiones POST o GET desde tus flujos de trabajo, puedes personalizar tus webhooks para controlar los datos enviados y recibidos.

En tus peticiones POST, puedes especificar las propiedades enviadas a cualquier sistema externo, como un CRM. Del mismo modo, en tus peticiones GET, puedes especificar las propiedades solicitadas mediante parámetros de consulta. 

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.

Ten en cuenta: HubSpot reintentará los webhooks fallidos durante un máximo de tres días, comenzando un minuto después del fallo. 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.

Configura tu webhook

Para crear y personalizar tus webhooks:

• En tu cuenta de HubSpot, dirígete a Automatizaciones > Workflows.
• Haz clic en el nombre del workflow.
• 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, puedes añadir parámetros de consulta como ?queryparameter=abc a la URL del Webhook . Si no se han agregado parámetros de consulta, se enviará una solicitud genérica POST o GET. 
• Configura tu tipo de autenticación para autenticar las solicitudes a tu webhook: 
  • Para utilizar una firma de solicitud en el título de tu webhook: 
    • Haz clic en el menú desplegable Tipo de autenticación. Luego, selecciona Incluye la firma de la solicitud en el título.
    • Luego, introduce tu ID de aplicación de HubSpot. Más información sobre cómo verificar las solicitudes de firma.

• • También puedes utilizar una clave API para la autenticación. Cuando se utiliza una clave de API para la autenticación, el nombre de la clave de API y la ubicación de la clave de API utilizada dependen de cómo esté configurado el webhook. Por razones de seguridad, la clave de API no se mostrará en ninguna solicitud de prueba. Para utilizar una clave de API: 
    • Haz clic en el menú desplegable Tipo de autenticación. Luego, selecciona Clave API. 

• • • Introduce el nombre de tu clave de API.
    • Haz clic en la ubicación de la clave API Menú desplegable. Luego, selecciona o bien Parámetros de consulta o bien Título de la solicitud. Más información sobre el uso de las claves API en HubSpot.
      
      

Personalizar tu solicitud POST

• Para incluir todas las propiedades, en la sección Personalizar cuerpo de la solicitud, selecciona Incluir todas las propiedades. 
• Para incluir solo propiedades específicas:
  
  • En la sección Personalizar el cuerpo de la solicitud, selecciona Elige propiedades específicas.
  • Haz clic en el menú desplegable Elegir propiedad. Luego, haz clic en [objeto] en este workflow y selecciona una propiedad.
  • Para cambiar el nombre de una propiedad en el webhook, edita el campo de texto Nombre de la propiedad . Esto solo actualizará el nombre de la propiedad en la solicitud POST, no actualizará el nombre de la propiedad o el nombre interno en HubSpot. 
  • Para agregar otra propiedad, haz clic en Agregar propiedad.
  • Para eliminar una propiedad, haz clic en el delete icono de la papelera.
     

Personalice tus solicitudes GET

• En la sección Parámetros de consulta , haz clic en el menú desplegable Elige propiedad. Luego, haz clic en [objeto] en este workflow y selecciona una propiedad.
• Para cambiar el nombre de una propiedad en el parámetro de consulta, edita el campo de texto Nombre de la propiedad. Esto solo actualizará el nombre de la propiedad en la solicitud GET, no actualizará el nombre de la propiedad o el nombre interno en HubSpot. 

• Para agregar otra parámetro de consulta, haz clic en Agregar parámetro de consulta.
• Para eliminar una propiedad, haz clic en el deleteicono de la papelera. 
• Haz clic en Guardar.