SuperAPI AI 工具集

telnyx-messaging-python

智能体与模型

查看项目

更新于 10-16 08:11

技能介绍

用途:该技能面向用 Python 集成 Telnyx 消息服务,覆盖发送与接收 SMS/MMS、处理退订和投递状态 Webhook,可用于通知、2FA 或消息类应用。

安装与初始化:pip install telnyx。初始化示例为 from telnyx import Telnyx;client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。

主要能力:client.messages.send() 发送短信(POST /messages);send_with_alphanumeric_sender() 用字母数字发送者 ID;send_group_mms() 群发 MMS;send_long_code()、send_short_code()、send_number_pool() 指定发送路径;schedule() 定时发送;send_whatsapp() 发送 WhatsApp 消息。辅助操作包括检索消息、取消定时消息、管理字母数字发送者 ID、查询托管号码与退订列表、查看消息配置文件指标等。

Webhook:Telnyx 使用 Ed25519 签名,请求含 telnyx-signature-ed25519 与 telnyx-timestamp 头,生产环境应校验签名,示例用 client.webhooks.unwrap(payload, headers=headers),需传原始请求体而非解析后的 JSON。投递与入站事件字段如 data.event_type、data.payload.id、data.payload.text、data.payload.sent_at 等。

限制与注意事项:电话号码须为 E.164 格式(如 +13125550001),含 + 和国家码,不可含空格、短横线或括号。发送号码须已绑定到正确的消息配置文件。美国 A2P 长码流量需先完成 10DLC 注册,否则可能被运营商拦截或过滤。投递 Webhook 是异步的,发送响应仅表示请求被接受,不代表最终投递。列表方法返回自动分页迭代器,可用 for item in page_result 遍历。错误需处理:401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 触发限流(建议指数退避重试)。不要臆造参数、枚举、响应字段或 Webhook 字段;未内联的字段应查相应参考文档。