实现服务器到服务器的聊天，将 token 流式输出到你自己的界面，并通过指向你 FlexyAgents 主机的 Webhook 触发自动化。下方的路由都是真实的 Next.js 处理程序——在生成 FlexyAgents API 连接后，从"部署"页面复制对应的值即可。
先要密钥？ 创建工作空间 然后打开 设置 → API 密钥 或智能体的连接弹窗。
HTTP 接口一览
路径与 Next.js 路由树一一对应。请将占位符替换为部署界面中显示的智能体 ID 与主机。
发送包含 messages 数组（角色 + 内容）的 JSON，并可选用 stream 标志。Bearer 校验你在智能体连接上存储的 FlexyAgents API 密钥；密钥验证成功后会自动解析到对应组织。
已发布的自动化可暴露 Webhook URL，反序列化载荷并调用 executeAutomation——当你的自有服务需要在无 OAuth 的情况下启动流程时非常有用。
/api/webhooks 下的同级路由处理 WhatsApp、Instagram、Facebook Messenger、入站邮件及类似厂商回调，使全渠道部署保留在你的域名下。
若希望 FlexyAgents 将会话或系统事件推送到 SIEM、数据湖或工单桥接，可在控制台配置签名的出站 Webhook。
最简单的非流式调用
curl -X POST "https://YOUR_APP_HOST/api/agents/AGENT_ID/chat" \
-H "Authorization: Bearer YOUR_FLEXYAGENTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"你好"}],"stream":false}'请将以下值替换为来自 部署 → API 的内容（在该智能体连接 FlexyAgents 应用之后获得）。
调用
部署页可复制针对线上主机的 curl 片段。底层处理程序通过自动化连接存储校验 API 密钥，加载行为与知识，并像其他渠道一样累计用量。
请求体至少包含一轮对话。执行器为检索会将历史裁剪到最新用户消息，同时仍接受多轮数组以备后续能力。
设置 stream: true 可接收 NDJSON 片段（每行一个 JSON 对象），前端可在 token 到达时刷新界面。
服务账号应使用按智能体生成的 FlexyAgents 连接密钥。交互式测试可依赖已登录控制台会话，但服务端到服务端应始终使用 Bearer。
基于 Redis 的限速在流量突增时返回 429。套餐策略对托管/BYOK 月配额添加 MESSAGE_LIMIT_REACHED，托管推理还有 token 上限。
事件
入站路由规范化厂商签名，出站配置与其他集成并列。自动化还可以在流程内发起任意 HTTP POST。
当流程发布 Webhook 触发器时，FlexyAgents 保存路径片段并在调用 executeAutomation 前校验载荷并解析正文。
WhatsApp、Instagram DM、Messenger 与入站邮件各自注册公共 HTTPS 端点，供 Meta、Twilio 或邮件服务商验证并投递事件。
自动化动作可向客户自有 URL 发起 POST/PUT，并使用模板化正文——例如「通知 Opsgenie」或「创建 Jira 工单」，无需等待官方连接器。
参考
营销页负责叙事；工程师应依赖文档站、仓库中的 OpenAPI 定义，以及与租户 ID 一致的部署页片段。
从 /docs 阅读概念指南，再交叉链接到面向开发者的 /api 页面获取快速开始、认证入门与分栏参考。
仓库包含完整的 OpenAPI，描述认证方案、聊天载荷与附属 REST 资源——可从该文件生成客户端或导入 Postman。
并非所有场景都需要裸 REST——可嵌入脚本使用相同的聊天端点并携带访客上下文。若既要网页自助又要后台任务，可将 API 与挂件组合使用。