gem install telnyx

require "telnyx"

client = Telnyx::Client.new(
  api_key: ENV["TELNYX_API_KEY"], # This is the default and can be omitted
)

begin
  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

page = client.audit_events.list

puts(page)

balance = client.balance.retrieve

puts(balance)

charges_breakdown = client.charges_breakdown.retrieve(start_date: "2025-05-01")

puts(charges_breakdown)

charges_summary = client.charges_summary.retrieve(end_date: "2025-06-01", start_date: "2025-05-01")

puts(charges_summary)

page = client.detail_records.list

puts(page)

page = client.invoices.list

puts(page)

invoice = client.invoices.retrieve("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")

puts(invoice)

auto_recharge_prefs = client.payment.auto_recharge_prefs.list

puts(auto_recharge_prefs)

auto_recharge_pref = client.payment.auto_recharge_prefs.update

puts(auto_recharge_pref)

user_tags = client.user_tags.list

puts(user_tags)

response = client.payment.create_stored_payment_transaction(amount: "120.00")

puts(response)

page = client.webhook_deliveries.list

puts(page)

webhook_delivery = client.webhook_deliveries.retrieve("C9C0797E-901D-4349-A33C-C2C8F31A92C2")

puts(webhook_delivery)