跳到正文

callflow-esl 深入文档导航 ​

本目录是 apps/callflow-esl 的深入文档入口;服务总览与快速运行见 上级 README。

文档内容
configuration.md完整配置结构、字段、默认值与路径解析
http-runtime-api.md健康检查、外呼、FreeSWITCH、会议及实时通话控制接口
business-development.md如何从零编写一段业务:handler 签名、生命周期、约束与「注册一段新业务」完整步骤
components.mdCallContext(ctx.*)组件 API 参考:speak / hear / originate / conference / DTMF / 录音的参数、返回值与回调契约
duplex-communication.md全双工音频链路、插话打断、业务接入和排查入口
existing-businesses.md全部内置业务逐个说明(用途 / 关键常量 / 流程),与 src/business/index.ts 汇总的 allBusinesses 对应
tts-api.mdsherpa-tts-server 对接:TTS 调用链、流式播放与 playback 目标映射
callout-integration.md与 callout-server 协同交互与接口规范:通道变量、上行业务接口、下行控制接口与容灾机制
conference-lifecycle-and-reconcile.md转人工会议的状态归属、前台收尾、读时状态校准与后台对账
use-cases.md当前代码能实现的典型通话场景与可复制的示例 handler 代码

建议阅读顺序:初次接入先读 business-development.md,写业务时对照 components.md 与 use-cases.md,编写实时语音对话时读 duplex-communication.md, 开发或联调外呼业务与 AI 策略中台时查阅 callout-integration.md, 需要参考现成实现时查 existing-businesses.md。

文档与代码在同一仓库维护,现有 Markdown 是唯一内容源。