用途:该 Skill 面向 Python 开发者,封装 Telnyx 短信配置文件(messaging profiles)相关 API,用于创建、查询、更新、删除配置文件,并管理关联电话号码与 short codes,适用于短信发送配置、号码池、粘性发送与 geomatch 等场景。
安装与初始化:pip install telnyx。随后使用 import os 与 from telnyx import Telnyx,通过 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")) 初始化客户端,示例默认已初始化 client。
主要能力:列出、创建、检索、更新、删除 messaging profiles(GET/POST /messaging_profiles,PATCH/DELETE /messaging_profiles/{id}),创建时必填 name 与 whitelisted_destinations,可选含 ai_assistant_id、alpha_sender、daily_spend_limit、mms_fall_back_to_sms、number_pool_settings、webhook 相关字段等;列出配置文件关联的电话号码与 short codes;列出、检索、更新 short codes(GET /short_codes,PATCH /short_codes/{id},必填 messaging_profile_id,可选 tags)。
使用方式:list 方法返回自动分页迭代器,可用 for item in page_result 遍历全部页面。更新 short code 时,将 messaging_profile_id 设为 null 或空字符串可解绑;tags 用字符串数组添加或更新。
错误处理:需处理网络错误(APIConnectionError)、限流(429,按 Retry-After 退避重试)、校验错误(422)与认证错误(401);常见状态码含 401、403、404、422、429。
限制:资料未提供具体定价、配额、区域限制或性能数据,使用前请查阅 Telnyx 官方文档;所有调用依赖有效 API Key 与相应权限。