SuperAPI AI 工具集

make-call

智能体与模型

查看项目

更新于 10-15 20:07

技能介绍

用途:通过 Bolna Voice AI 发起外呼,支持即时呼叫、定时呼叫、个性化变量、失败重试以及停止排队或已定时的呼叫。

主要能力:调用 POST https://api.bolna.ai/call 创建呼叫,必填 agent_id(Bolna 智能体 UUID)和 recipient_phone_number(E.164 格式,如 +919876543210)。可选字段包括 from_phone_number(E.164 发送号码,省略则用 Bolna 默认外呼号码)、scheduled_at(带时区的 ISO 8601 时间,如 2026-05-19T18:30:00+05:30)、user_data(提示词或欢迎语中引用的动态变量,如 {customer_name})、agent_data.voice_id(仅在同一已配置 TTS 提供商内覆盖语音)、bypass_call_guardrails(跳过呼叫窗口检查,仅用于测试、紧急或明确批准的高优先级呼叫)、retry_config(针对无应答、忙线、失败、错误或语音信箱重试)。

使用方式:即时呼叫用 curl 向 https://api.bolna.ai/call 发送 POST,携带 Authorization: Bearer $BOLNA_API_KEY 和 JSON 请求体;响应返回 execution_id,需保存作为 webhook 与执行查询的关联键。停止排队或已定时呼叫用 POST https://api.bolna.ai/call/{execution_id}/stop,无法停止进行中的呼叫。也可使用脚本:python3 make-call/scripts/make_call.py、schedule_call.py、bulk_make_calls.py。

适用场景:测试智能体、呼叫指定接收者、定时外呼、批量临时外呼(正式活动建议用 create-batch)。

限制:定时时间必须带时区,避免无时区字符串;若智能体配置了 calling_guardrails.call_start_hour 和 call_end_hour,Bolna 会按接收者本地时区判断,超出窗口可能改为重新安排;bypass_call_guardrails 仅在用户明确要求忽略时间窗口时使用;重试会消耗并发并可能与批次重叠;停止接口不能终止进行中的呼叫。