用途:面向使用 Retell AI 构建语音智能体与电话外呼的场景,处理外呼活动、呼叫查询、录音与转写等电话运营任务。前置条件:需先完成 retellai-core-workflow-a。
主要能力:一是发起外呼活动,通过 retell.call.createPhoneCall 传入 from_number、to_number、override_agent_id 与 metadata,并对号码列表循环调用;示例中每通电话间隔 2 秒做限流,单个号码失败时捕获错误并记录。二是列出与筛选呼叫记录,使用 retell.call.list,支持 sort_order(如 descending)和 limit 等参数,输出 call_id、call_status 以及由 end_timestamp 与 start_timestamp 计算的时长。三是获取单通电话详情,使用 retell.call.retrieve,读取 recording_url(录音)和 transcript(转写)。
使用方式:在 TypeScript/Node 环境中调用 Retell AI SDK,号码需使用 E.164 格式,配合环境变量保存主叫号码,示例命令与代码需保持原样。
适用场景:预约提醒类有界外呼活动、呼叫结果核查、录音与转写取回等。建议仅上传已获同意的测试联系人到开发活动,先设置小并发上限,再启用生产队列;每通测试电话核对 E.164 格式、预期智能体版本、完成状态与脱敏转写;结果不明确时先按呼叫标识查询再重试,避免重复呼叫或覆盖原结果。
限制:资料未提供具体平台的并发上限数值、收费与价格信息、录音默认开关状态及完整错误码清单;错误处理提示包括号码格式错误、未启用录音、并发超限三类,解决方式分别为改用 E.164、在智能体设置中开启录音、升级计划或排队呼叫,均需以实际账户与文档为准。后续可衔接 retellai-webhooks-events 处理通话事件。