Recuperar el punto final de Webhook
Siga estos pasos para generar un webhook endpoint para su agente
Paso 1: Navegue hasta el módulo de activación
Abra la configuración de su agente y vaya al Módulo Activador.
Paso 2: Seleccionar Webhook como disparador
Haga clic en Añadir activador y elija Webhook de la lista de opciones disponibles.
Paso 3: Generar la URL del Webhook
Haga clic en Generar activador para crear la URL del webhook. Esta URL se utilizará para enviar solicitudes POST.
Paso 4: Activar la autenticación de clave de API (opcional)
Si su integración requiere autenticación, active Activar claves de API.
Proporcione un nombre de etiqueta y haga clic en Crear nueva clave API.
- La clave API generada sólo se mostrará una vez-guárdala de forma segura.
Estructuración del esquema de carga útil
Paso 1: Estructura de la carga útil
Beam procesa JSON payload y lo entiende basándose en el contexto. La plataforma interpreta dinámicamente las claves y los valores para asignarlos a la lógica de procesamiento del agente.
A continuación se muestra un ejemplo de cómo podría ser una carga útil de webhook estándar:
Beam procesa JSON y lo entiende en función del contexto
Paso 2: Manejo de datos estructurados (objetos anidados & matrices)
Muchos sistemas requieren datos estructurados, como registros de candidatos, ofertas de empleo o transacciones financieras. Beam admite objetos anidados y matrices para dar cabida a estos casos de uso.
Beam es una herramienta de gestión de datos
Paso 3: Gestión de archivos adjuntos (codificación Base64)
Beam soporta archivos adjuntos como currículos, facturas y contratos. Estos archivos deben estar codificados en Base64 e incluidos en
encodedContextFiles.Una vez cargados, Beam puede almacenarlos para futuras referencias y extraer información clave de ellos para utilizarla dentro de los flujos.
Paso 4: Gestión de valores nulos o ausentes
Si un campo es opcional pero no disponible, debe omitirse o establecerse como nulo.
Ejemplo de carga útil completa
Si un campo es opcional pero no disponible, debe omitirse o establecerse como nulo.
