team-telnyx/telnyx-messaging-ruby
api/ruby/telnyx-messaging-ruby/SKILL.md
Send and receive SMS/MMS messages, manage messaging-enabled phone numbers, and handle opt-outs. Use when building messaging applications, implementing 2FA, or sending notifications. This skill provides Ruby SDK examples.
$ install --global
skillsauthnpx skillsauth add team-telnyx/telnyx-toolkit telnyx-messaging-rubyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:45 PM1.8s1 file scanned
SKILL.md
- name:
- telnyx-messaging-ruby
- description:
- >-
- author:
- telnyx
- product:
- messaging
- language:
- ruby
- generated_by:
- telnyx-ext-skills-generator
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
Telnyx Messaging - Ruby
Installation
gem install telnyx
Setup
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.
Send a message
Send a message with a Phone Number, Alphanumeric Sender ID, Short Code or Number Pool.
POST /messages — Required: to
response = client.messages.send_(to: "+18445550001")
puts(response)
Retrieve a message
Note: This API endpoint can only retrieve messages that are no older than 10 days since their creation.
GET /messages/{id}
message = client.messages.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
puts(message)
Cancel a scheduled message
Cancel a scheduled message that has not yet been sent.
DELETE /messages/{id}
response = client.messages.cancel_scheduled("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
puts(response)
Send a Whatsapp message
POST /messages/whatsapp — Required: from, to, whatsapp_message
response = client.messages.send_whatsapp(from: "+13125551234", to: "+13125551234", whatsapp_message: {})
puts(response)
Send a group MMS message
POST /messages/group_mms — Required: from, to
response = client.messages.send_group_mms(from: "+13125551234", to: ["+18655551234", "+14155551234"])
puts(response)
Send a long code message
POST /messages/long_code — Required: from, to
response = client.messages.send_long_code(from: "+18445550001", to: "+13125550002")
puts(response)
Send a message using number pool
POST /messages/number_pool — Required: to, messaging_profile_id
response = client.messages.send_number_pool(
messaging_profile_id: "abc85f64-5717-4562-b3fc-2c9600000000",
to: "+13125550002"
)
puts(response)
Schedule a message
Schedule a message with a Phone Number, Alphanumeric Sender ID, Short Code or Number Pool.
POST /messages/schedule — Required: to
response = client.messages.schedule(to: "+18445550001")
puts(response)
Send a short code message
POST /messages/short_code — Required: from, to
response = client.messages.send_short_code(from: "+18445550001", to: "+18445550001")
puts(response)
List opt-outs
Retrieve a list of opt-out blocks.
GET /messaging_optouts
page = client.messaging_optouts.list
puts(page)
Retrieve a phone number with messaging settings
GET /phone_numbers/{id}/messaging
messaging = client.phone_numbers.messaging.retrieve("id")
puts(messaging)
Update the messaging profile and/or messaging product of a phone number
PATCH /phone_numbers/{id}/messaging
messaging = client.phone_numbers.messaging.update("id")
puts(messaging)
List phone numbers with messaging settings
GET /phone_numbers/messaging
page = client.phone_numbers.messaging.list
puts(page)
Retrieve a mobile phone number with messaging settings
GET /mobile_phone_numbers/{id}/messaging
messaging = client.mobile_phone_numbers.messaging.retrieve("id")
puts(messaging)
List mobile phone numbers with messaging settings
GET /mobile_phone_numbers/messaging
page = client.mobile_phone_numbers.messaging.list
puts(page)
Bulk update phone number profiles
POST /messaging_numbers/bulk_updates — Required: messaging_profile_id, numbers
messaging_numbers_bulk_update = client.messaging_numbers_bulk_updates.create(
messaging_profile_id: "00000000-0000-0000-0000-000000000000",
numbers: ["+18880000000", "+18880000001", "+18880000002"]
)
puts(messaging_numbers_bulk_update)
Retrieve bulk update status
GET /messaging_numbers/bulk_updates/{order_id}
messaging_numbers_bulk_update = client.messaging_numbers_bulk_updates.retrieve("order_id")
puts(messaging_numbers_bulk_update)
Webhooks
The following webhook events are sent to your configured webhook URL.
All webhooks include telnyx-timestamp and telnyx-signature-ed25519 headers for verification (Standard Webhooks compatible).
| Event | Description |
|-------|-------------|
| deliveryUpdate | Delivery Update |
| inboundMessage | Inbound Message |
| replacedLinkClick | Replaced Link Click |
Related Skills
team-telnyx/telnyx-webrtc-client-react-native
tools
VerifiedTrustedCommunity
Build cross-platform VoIP calling apps with React Native using Telnyx Voice SDK. High-level reactive API with automatic lifecycle management, CallKit/ConnectionService integration, and push notifications. Use for mobile VoIP apps with minimal setup.
2SKILL.mdUpdated Apr 15, 2026
team-telnyx/telnyx-webrtc-client-js
tools
VerifiedTrustedCommunity
Build browser-based VoIP calling apps using Telnyx WebRTC JavaScript SDK. Covers authentication, voice calls, events, debugging, call quality metrics, and AI Agent integration. Use for web-based real-time communication.
2SKILL.mdUpdated Apr 15, 2026
team-telnyx/telnyx-webrtc-client-ios
tools
VerifiedTrustedCommunity
Build VoIP calling apps on iOS using Telnyx WebRTC SDK. Covers authentication, making/receiving calls, CallKit integration, PushKit/APNS push notifications, call quality metrics, and AI Agent integration. Use when implementing real-time voice communication on iOS.
2SKILL.mdUpdated Apr 15, 2026
team-telnyx/telnyx-webrtc-client-flutter
tools
VerifiedTrustedCommunity
Build cross-platform VoIP calling apps with Flutter using Telnyx WebRTC SDK. Covers authentication, making/receiving calls, push notifications (FCM + APNS), call quality metrics, and AI Agent integration. Works on Android, iOS, and Web.
2SKILL.mdUpdated Apr 15, 2026