BetaUtilizar webhooks en los agentes

Utiliza las acciones de webhook en los agentes para enviar y recibir datos de sistemas externos. Puedes configurar acciones de webhook en el generador de agentes para realizar solicitudes HTTP (por ejemplo, GET o POST), como desencadenantes de procesos externos o para recuperar datos.

Las acciones de webhook permiten conectar a los agentes con herramientas externas sin necesidad de integraciones personalizadas. Por ejemplo, puedes enviar datos de un negocio a un sistema externo como desencadenante del proceso de tramitación, o recuperar información de los clientes de otra plataforma y utilizarla en las respuestas de tus agentes.

Ten en cuenta lo siguiente: puedes gestionar el acceso a las funciones de IA en tu configuración de IA y especificar qué datos se comparten. Consulta las preguntas frecuentes sobre la confianza en la IA y las fichas de modelos de IA de HubSpot para obtener información detallada sobre los controles de seguridad, el uso de los datos y el cumplimiento de la IA.

Antes de empezar

Antes de empezar a utilizar los webhooks en los agentes, revisa los requisitos y las consideraciones.

• Un superadministrador debe activar los siguientes interruptores en la configuración de IA:

  • Da a los usuarios acceso a herramientas y características de IA generativa

  • Datos de CRM

  • Datos de conversión de clientes

  • Datos de archivos

  • Dar acceso a los usuarios al asistente de Breeze

Añadir una acción de webhook a un agente

Añade una acción de webhook en el generador de agentes para enviar datos a un sistema externo o recuperar datos de él. Utiliza el menú desplegable «Método» para seleccionar cómo debe comunicarse el agente con la URL del webhook:

• GET: recuperar valores de otro sistema. Utiliza solicitudes GET cuando el agente necesite consultar información de un sistema externo en una fase posterior de la ejecución del agente, como el estado de una suscripción, el estado de un pedido o un campo del perfil del cliente.

• POST: enviar valores a otro sistema. Utiliza solicitudes POST cuando el agente necesite ser un desencadenante o actualizar algo fuera de HubSpot, como crear una solicitud de gestión de pedidos, enviar una notificación o actualizar un registro externo.

Para añadir una acción de webhook:

1. En tu cuenta de HubSpot, haz clic en «Más» y, a continuación, ve a «Agentes » > «Agent Hub». Si «More» no aparece en tu cuenta, ve directamente a «Agentes » > «Agent Hub».

2. Haz clic en la pestaña «Agentes».

3. Haz clic en «Editar» en la ficha de un agente ya existente o crea un nuevo agente.

4. En el generador de agentes, haz clic en «Añadir acción » en la sección «Acciones ».

5. En el panel de la derecha, introduce «Enviar un webhook» en el campo de búsqueda . A continuación, haz clic en la acción «Enviar un webhook ».

6. Haz clic en el menú desplegable «Método» y selecciona el tipo de solicitud (por ejemplo, POST o GET).

7. En el campo «URL del webhook» , introduce la URL a la que debe enviarse la solicitud.

8. Haz clic en el menú desplegable «Tipo de autenticación » y selecciona un tipo de autenticación.

9. Dependiendo del método seleccionado (por ejemplo, GET o POST), configura los valores que se incluirán en la solicitud.

   • Para las solicitudes GET , en la sección «Parámetros de consulta», haz clic en «Añadir valor estático» para añadir los nombres y valores que se deben añadir a la URL del webhook.

   • Para las solicitudes POST , en la sección «Cuerpo de la solicitud», haz clic en «Añadir valor estático» para añadir los valores que se incluirán en el cuerpo de la solicitud del webhook.

10. Para probar la acción del webhook, haz clic en «Probar». Revisa la respuesta para confirmar que la solicitud está configurada correctamente. Si la prueba falla, comprueba la URL del webhook, el método, el tipo de autenticación, los parámetros de consulta o el cuerpo de la solicitud, y vuelve a realizar la prueba.

11. Cuando hayas terminado, haz clic en «Guardar y añadir».
12. Sigue personalizando el agente y, a continuación, publícalo.

Pasos siguientes

• Crear y personalizar agentes en el generador de agentes
• Ejecuta agentes y revisa los resultados en la bandeja de entrada del agente
• Revisa los costes estimados del crédito cuando recurras a intermediarios