# Be Agent

Dominio oficial: https://agents.begraffic.com. API REST: https://agents.begraffic.com/api/v1.

API REST v1 y Be Agent Connect. Conexión OAuth, sincronización de recursos, ejecución entrante e invocación de agentes con acciones externas por webhooks firmados.

- [Guía completa y contrato en Markdown](/docs.md)
- [OpenAPI y esquemas](/docs/openapi.json)
- [Recursos de marca y lineamientos](/docs/be-agent-brand.md)
- [Kit de marca ZIP](/brand/integrations/be-agent-integration-kit.zip)
- [SDK de servidor](/sdk/be-agent-connect.mjs)

## Capítulos

- [Construye sobre Be Agent](/docs#introduccion): Primeros pasos
- [Tu primera integración](/docs#inicio-rapido): Primeros pasos
- [Qué puedes integrar](/docs#capacidades): Primeros pasos
- [Derivaciones humanas y aprendizaje del dueño](/docs#atencion-humana): Operación
- [Claves, permisos y caducidad](/docs#autenticacion): Conexión
- [Referencia de permisos](/docs#permisos): Conexión
- [Estado de la conexión y del agente](/docs#estado-conexion): Conexión
- [Recursos de marca y botón de conexión](/docs#recursos-marca): Conexión
- [Conector oficial de BeSocial](/docs#besocial-oficial): Conexión
- [Conector oficial de BeCRM](/docs#becrm-oficial): Conexión
- [Be Agent Connect](/docs#be-agent-connect): Conexión
- [Consulta y sincronización](/docs#sincronizacion): Datos y sincronización
- [Importar y sincronizar historiales](/docs#historial): Datos y sincronización
- [Consultar agentes](/docs#recurso-agents): Datos y sincronización
- [Leads y oportunidades](/docs#recurso-leads): Datos y sincronización
- [Conversaciones](/docs#recurso-conversations): Datos y sincronización
- [Agenda y citas](/docs#recurso-appointments): Datos y sincronización
- [Tareas y seguimiento](/docs#recurso-tasks): Datos y sincronización
- [Crear y actualizar contactos](/docs#contactos): Datos y sincronización
- [Catálogo y acciones entrantes](/docs#acciones): Agentes y acciones
- [Invocar al agente con datos de tu plataforma](/docs#agentes): Agentes y acciones
- [BeSchool y educación](/docs#educacion): Agentes y acciones
- [Las 15 acciones del catálogo](/docs#catalogo-acciones): Agentes y acciones
- [Ciclo de una conversación delegada](/docs#ciclo-ejecucion): Agentes y acciones
- [Derivación a agentes especialistas](/docs#derivacion-especialistas): Agentes y acciones
- [Marca y conocimiento del negocio](/docs#conocimiento-marca): Agentes y acciones
- [WhatsApp, SMS y Telegram](/docs#mensajeria): Canales externos
- [Correos, comentarios y mensajes sociales](/docs#correos-social): Canales externos
- [Llamadas y mensajes de voz](/docs#voz): Canales externos
- [Derivaciones entre agentes](/docs#derivaciones): Agentes y acciones
- [Resultados, aprobaciones y recuperación](/docs#resultados): Agentes y acciones
- [Webhooks firmados](/docs#webhooks): Operación
- [Errores y límites](/docs#errores): Operación
- [Preparación y prueba de la integración](/docs#operacion): Operación

## Límites de capacidad

Be Agent aporta razonamiento y acciones. La plataforma externa gestiona WhatsApp, SMS, Telegram, correo, audio y sus historiales completos. No hay endpoints públicos de envío de mensajes, importación de conocimiento ni consulta genérica de inventario. Consulta la guía antes de implementar. Las credenciales se utilizan solo en el servidor; las cookies del panel no autentican la API v1.