用途:在 Python 中完成 Telnyx AI 助手外呼语音的完整配置,从购买号码到触发 AI 助手拨打电话。安装命令:pip install telnyx requests。
主要能力与必要前提:需先具备已购买的 Telnyx 电话号码、TeXML 应用、号码已绑定到该应用、外呼语音配置文件且目标国家在白名单中、AI 助手设置 telephony_settings.default_texml_app_id。缺任一项会报特定错误。
使用方式:用 TELNYX_API_KEY 初始化 Telnyx 客户端;通过 available_phone_numbers.list() 和 number_orders.create() 购买号码;用 texml_applications.create() 创建应用(voice_url 必填但外呼不使用);用 PATCH /v2/phone_numbers/{phone} 设置 connection_id 为应用 ID 完成绑定;通过 /v2/outbound_voice_profiles 获取配置文件并设置 whitelisted_destinations(ISO 3166-1 alpha-2,默认仅 US、CA),再 PATCH TeXML 应用写入 outbound.outbound_voice_profile_id;用 ai.assistants.create() 创建助手并设置 telephony_settings;最后用 ai.assistants.scheduled_events.create() 触发外呼,参数包括 assistant_id、telnyx_conversation_channel="phone_call"、telnyx_end_user_target(被叫)、telnyx_agent_target(主叫,须为已绑定号码)、scheduled_at_fixed_datetime(UTC,提前约 5 秒即近似立即拨打),可选 dynamic_variables、conversation_metadata。
限制与排错:外呼目标国家未加白名单会返回 403 及 D13;TeXML 应用未配置外呼配置文件会报 400;助手未配置 telephony_settings 会报 400;模型可用性因账户而异,若返回 422 "not available for inference",可通过 client.ai.assistants.list().data 查看已有助手可用模型,常见模型为 openai/gpt-4o、Qwen/Qwen3-235B-A22B。通话仍 pending 时检查时间是否为 UTC 未来值、主叫与被叫号码及绑定是否正确。具体收费、价格与其他平台支持暂未提供。