用途:该技能面向使用 Telnyx 账户通知功能的 Ruby 开发者,演示如何配置通知渠道与通知设置,以接收账户告警和事件通知。
主要能力:围绕四个资源提供 Ruby SDK 调用示例。通知渠道(notification_channels)支持列出、创建、获取、更新和删除,通道类型为 sms、voice、email、webhook。通知事件条件(notification_event_conditions)和通知事件(notification_events)支持列表查询。通知配置文件(notification_profiles)支持增删改查。通知设置(notification_settings)支持列出、添加、获取和删除,包含状态枚举。
使用方式:先执行 gem install telnyx,然后 require "telnyx",使用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。调用如 client.notification_channels.list、client.notification_channels.create(channel_type_id: "webhook", channel_destination: "https://example.com/webhooks") 等。分页可用 .auto_paging_each 自动迭代。
错误处理:调用可能返回 401、403、404、422、429 等错误,示例用 begin/rescue 捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError;429 限流建议指数退避并检查 Retry-After 头。
限制:资料未说明 API 版本、计费方式、速率上限及权限配置细节,具体字段与枚举以官方文档为准。