Guía de activación de Beam Webhook
Esta guía explica cómo estructurar cargas útiles para llamadas POST utilizando el módulo webhook de Beam. La plataforma Beam acepta cargas útiles con formato JSON y puede procesar varias estructuras de datos, incluidos objetos estructurados, adjuntos y metadatos.
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.
