Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Look up phone number information (carrier, type, caller name) and verify users via SMS/voice OTP. Use for phone verification and data enrichment. This skill provides Ruby SDK examples.
.claude/skills/team-telnyx-telnyx-verify-ruby/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 114% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 100% | 0% |
| case-03 | ✗→✓ | ▲ Improved | 159% | 0% |
| case-04 | ✗→✓ | ▲ Improved | 99% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 104% | 0% |
<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
bashgem install telnyx
rubyrequire "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.
All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:
rubybegin result = client.messages.send_(to: "+13125550001", from: "+13125550002", text: "Hello") rescue Telnyx::Errors::APIConnectionError puts "Network error — check connectivity and retry" rescue Telnyx::Errors::RateLimitError # 429: rate limited — wait and retry with exponential backoff sleep(1) # Check Retry-After header for actual delay rescue Telnyx::Errors::APIStatusError => e puts "API error #{e.status}: #{e.message}" if e.status == 422 puts "Validation error — check required fields and formats" end end
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).
+13125550001). Include the + prefix and country code. No spaces, dashes, or parentheses..auto_paging_each for automatic iteration: page.auto_paging_each { |item| puts item.id }.Returns information about the provided phone number.
GET /number_lookup/{phone_number}
rubynumber_lookup = client.number_lookup.retrieve("+18665552368") puts(number_lookup)
Returns: caller_name (object), carrier (object), country_code (string), fraud (string | null), national_format (string), phone_number (string), portability (object), record_type (string)
GET /verifications/by_phone_number/{phone_number}
rubyby_phone_numbers = client.verifications.by_phone_number.list("+13035551234") puts(by_phone_numbers)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
POST /verifications/by_phone_number/{phone_number}/actions/verify — Required: code, verify_profile_id
rubyverify_verification_code_response = client.verifications.by_phone_number.actions.verify( "+13035551234", code: "17686", verify_profile_id: "12ade33a-21c0-473b-b055-b3c836e1c292" ) puts(verify_verification_code_response)
Returns: phone_number (string), response_code (enum: accepted, rejected)
POST /verifications/call — Required: phone_number, verify_profile_id
Optional: custom_code (string | null), extension (string | null), timeout_secs (integer)
rubycreate_verification_response = client.verifications.trigger_call( phone_number: "+13035551234", verify_profile_id: "12ade33a-21c0-473b-b055-b3c836e1c292" ) puts(create_verification_response)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
POST /verifications/flashcall — Required: phone_number, verify_profile_id
Optional: timeout_secs (integer)
rubycreate_verification_response = client.verifications.trigger_flashcall( phone_number: "+13035551234", verify_profile_id: "12ade33a-21c0-473b-b055-b3c836e1c292" ) puts(create_verification_response)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
POST /verifications/sms — Required: phone_number, verify_profile_id
Optional: custom_code (string | null), timeout_secs (integer)
rubycreate_verification_response = client.verifications.trigger_sms( phone_number: "+13035551234", verify_profile_id: "12ade33a-21c0-473b-b055-b3c836e1c292" ) puts(create_verification_response)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
POST /verifications/whatsapp — Required: phone_number, verify_profile_id
Optional: custom_code (string | null), timeout_secs (integer)
rubycreate_verification_response = client.verifications.trigger_whatsapp_verification( phone_number: "+13035551234", verify_profile_id: "12ade33a-21c0-473b-b055-b3c836e1c292" ) puts(create_verification_response)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
GET /verifications/{verification_id}
rubyverification = client.verifications.retrieve("12ade33a-21c0-473b-b055-b3c836e1c292") puts(verification)
Returns: created_at (string), custom_code (string | null), id (uuid), phone_number (string), record_type (enum: verification), status (enum: pending, accepted, invalid, expired, error), timeout_secs (integer), type (enum: sms, call, flashcall, whatsapp), updated_at (string), verify_profile_id (uuid)
POST /verifications/{verification_id}/actions/verify
Optional: code (string), status (enum: accepted, rejected)
rubyverify_verification_code_response = client.verifications.actions.verify("12ade33a-21c0-473b-b055-b3c836e1c292") puts(verify_verification_code_response)
Returns: phone_number (string), response_code (enum: accepted, rejected)
Gets a paginated list of Verify profiles.
GET /verify_profiles
rubypage = client.verify_profiles.list puts(page)
Returns: call (object), created_at (string), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), id (uuid), language (string), name (string), record_type (enum: verification_profile), sms (object), updated_at (string), webhook_failover_url (string), webhook_url (string), whatsapp (object)
Creates a new Verify profile to associate verifications with.
POST /verify_profiles — Required: name
Optional: call (object), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), language (string), sms (object), webhook_failover_url (string), webhook_url (string), whatsapp (object)
rubyverify_profile_data = client.verify_profiles.create(name: "Test Profile") puts(verify_profile_data)
Returns: call (object), created_at (string), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), id (uuid), language (string), name (string), record_type (enum: verification_profile), sms (object), updated_at (string), webhook_failover_url (string), webhook_url (string), whatsapp (object)
List all Verify profile message templates.
GET /verify_profiles/templates
rubyresponse = client.verify_profiles.retrieve_templates puts(response)
Returns: id (uuid), text (string)
Create a new Verify profile message template.
POST /verify_profiles/templates — Required: text
rubymessage_template = client.verify_profiles.create_template(text: "Your {{app_name}} verification code is: {{code}}.") puts(message_template)
Returns: id (uuid), text (string)
Update an existing Verify profile message template.
PATCH /verify_profiles/templates/{template_id} — Required: text
rubymessage_template = client.verify_profiles.update_template( "12ade33a-21c0-473b-b055-b3c836e1c292", text: "Your {{app_name}} verification code is: {{code}}." ) puts(message_template)
Returns: id (uuid), text (string)
Gets a single Verify profile.
GET /verify_profiles/{verify_profile_id}
rubyverify_profile_data = client.verify_profiles.retrieve("12ade33a-21c0-473b-b055-b3c836e1c292") puts(verify_profile_data)
Returns: call (object), created_at (string), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), id (uuid), language (string), name (string), record_type (enum: verification_profile), sms (object), updated_at (string), webhook_failover_url (string), webhook_url (string), whatsapp (object)
PATCH /verify_profiles/{verify_profile_id}
Optional: call (object), daily_spend_limit (number), daily_spend_limit_enabled (boolean), language (string), name (string), sms (object), webhook_failover_url (string), webhook_url (string), whatsapp (object)
rubyverify_profile_data = client.verify_profiles.update("12ade33a-21c0-473b-b055-b3c836e1c292") puts(verify_profile_data)
Returns: call (object), created_at (string), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), id (uuid), language (string), name (string), record_type (enum: verification_profile), sms (object), updated_at (string), webhook_failover_url (string), webhook_url (string), whatsapp (object)
DELETE /verify_profiles/{verify_profile_id}
rubyverify_profile_data = client.verify_profiles.delete("12ade33a-21c0-473b-b055-b3c836e1c292") puts(verify_profile_data)
Returns: call (object), created_at (string), daily_spend_limit (number), daily_spend_limit_enabled (boolean), flashcall (object), id (uuid), language (string), name (string), record_type (enum: verification_profile), sms (object), updated_at (string), webhook_failover_url (string), webhook_url (string), whatsapp (object)
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→pass | 11,038 | 11,840 | +7% | 1 | 1 | 0% | 2,549 | 5,465 | +114% | 0 | 0 | — |
case-02 | fail→pass | 12,664 | 6,303 | -50% | 1 | 1 | 0% | 2,463 | 4,927 | +100% | 0 | 0 | — |
case-03 | fail→pass | 9,957 | 7,341 | -26% | 1 | 1 | 0% | 1,983 | 5,132 | +159% | 0 | 0 | — |
case-04 | fail→pass | 10,796 | 3,809 | -65% | 1 | 1 | 0% | 2,204 | 4,375 | +99% | 0 | 0 | — |
case-05 | fail→pass | 11,111 | 3,139 | -72% | 1 | 1 | 0% | 2,086 | 4,264 | +104% | 0 | 0 | — |
case-06 | fail→pass | 6,843 | 3,392 | -50% | 1 | 1 | 0% | 1,391 | 4,298 | +209% | 0 | 0 | — |
case-07 | fail→pass | 14,485 | 4,640 | -68% | 1 | 1 | 0% | 2,895 | 4,520 | +56% | 0 | 0 | — |
case-08 | fail→pass | 8,435 | 3,707 | -56% | 1 | 1 | 0% | 1,488 | 4,335 | +191% | 0 | 0 | — |
case-09 | fail→pass | 4,712 | 3,450 | -27% | 1 | 1 | 0% | 787 | 4,238 | +439% | 0 | 0 | — |
case-10 | fail→pass | 10,842 | 3,542 | -67% | 1 | 1 | 0% | 2,148 | 4,307 | +101% | 0 | 0 | — |
case-11 | fail→pass | 9,850 | 3,751 | -62% | 1 | 1 | 0% | 2,006 | 4,388 | +119% | 0 | 0 | — |
case-12 | fail→pass | 5,972 | 3,267 | -45% | 1 | 1 | 0% | 1,114 | 4,314 | +287% | 0 | 0 | — |
case-13 | fail→pass | 13,173 | 26,488 | +101% | 1 | 1 | 0% | 2,324 | 4,066 | +75% | 0 | 0 | — |
case-14 | fail→pass | 7,597 | 2,895 | -62% | 1 | 1 | 0% | 1,269 | 4,166 | +228% | 0 | 0 | — |
case-15 | pass→pass | 12,538 | 3,021 | -76% | 1 | 1 | 0% | 2,139 | 4,052 | +89% | 0 | 0 | — |
case-16 | pass→pass | 8,492 | 2,387 | -72% | 1 | 1 | 0% | 1,755 | 3,942 | +125% | 0 | 0 | — |
case-17 | fail→pass | 7,577 | 3,473 | -54% | 1 | 1 | 0% | 1,683 | 4,440 | +164% | 0 | 0 | — |
case-18 | fail→pass | 9,888 | 3,244 | -67% | 1 | 1 | 0% | 2,082 | 4,337 | +108% | 0 | 0 | — |
case-19 | fail→pass | 12,156 | 6,300 | -48% | 1 | 1 | 0% | 2,428 | 4,948 | +104% | 0 | 0 | — |
case-20 | fail→pass | 5,131 | 4,240 | -17% | 1 | 1 | 0% | 1,096 | 4,524 | +313% | 0 | 0 | — |
case-21 | pass→pass | 7,310 | 6,918 | -5% | 1 | 1 | 0% | 1,488 | 4,991 | +235% | 0 | 0 | — |
case-22 | pass→pass | 14,408 | 13,639 | -5% | 1 | 1 | 0% | 2,892 | 6,297 | +118% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +82 percentage points is the difference between those two pass rates over the 22 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.