telnyx-messaging-ruby

<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. --> # Telnyx Messaging - Ruby ## Installation ```bash gem install telnyx ``` ## Setup ```ruby require "telnyx" client = Telnyx::Client.new( api_key: ENV["TELNYX_API_KEY"], # This is the default and can be omitted ) ``` All examples below assume `client` is already initialized as shown above. ## Error Handling All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code: ```ruby response = client.messages.send_(to: "+18445550001", from: "+18005550101", text: "Hello from Telnyx!") puts(response) ``` Common error codes: `401` invalid API key, `403` insufficient permissions, `404` resource not found, `422` validation error (check field formats), `429` rate limited (retry with exponential backoff). ## Important Notes - **Phone numbers** must be in E.164 format (e.g., `+13125550001`). Include the `+` prefix and country code. No spaces, dashes, or parentheses. - **Pagination:** Use `.auto_paging_each` for automatic iteration: `page.auto_paging_each { |item| puts item.id }`. ## Operational Caveats - The sending number must already be assigned to the correct messaging profile before you send traffic from it. - US A2P long-code traffic must complete 10DLC registration before production sending or carriers will block or heavily filter messages. - Delivery webhooks are asynchronous. Treat the send response as accep...