gem 'devotel'

bundle install

gem install devotel

require 'devotel'

orbit = Devotel::Orbit.new(api_key: 'dv_live_sk_your_key_here')

# Send an SMS
message = orbit.messages.send(
  channel: 'sms',
  to: '+14155552671',
  body: 'Hello from Orbit!'
)

puts message["data"]["message_id"] # msg_abc123

# Send WhatsApp template
wa_message = orbit.messages.send(
  channel: 'whatsapp',
  to: '+14155552671',
  type: 'template',
  template: {
    name: 'order_confirmation',
    language: 'en',
    components: [
      {
        type: 'body',
        parameters: [{ type: 'text', text: 'ORD-12345' }]
      }
    ]
  }
)

# Send Email
email = orbit.messages.send(
  channel: 'email',
  to: 'user@example.com',
  from: 'hello@yourdomain.com',
  subject: 'Welcome!',
  html: '<h1>Welcome to Acme</h1>'
)

# Make an outbound call
call = orbit.voice.create_call(
  to: '+14155552671',
  from: '+18005551234'
)

# Retrieve call details
call_details = orbit.voice.get_call(call["data"]["id"])

# Send OTP
verification = orbit.verify.send(
  to: '+14155552671',
  channel: 'sms'
)

# Check OTP
result = orbit.verify.check(
  verification_id: verification["data"]["verification_id"],
  code: '482901'
)

puts result["data"]["status"] # "approved"

require 'devotel'

# Sinatra example
post '/webhooks/orbit' do
  signature = request.env['HTTP_X_DEVOTEL_SIGNATURE']
  payload = request.body.read

  unless Devotel::Webhook.verify(payload, signature, 'whsec_your_secret')
    halt 401, { error: 'Invalid signature' }.to_json
  end

  event = JSON.parse(payload)
  case event['type']
  when 'message.delivered'
    handle_delivery(event)
  when 'call.completed'
    handle_call_complete(event)
  end

  { received: true }.to_json
end

class WebhooksController < ApplicationController
  skip_before_action :verify_authenticity_token

  def orbit
    signature = request.headers['X-Devotel-Signature']
    payload = request.raw_post

    unless Devotel::Webhook.verify(payload, signature, ENV['DEVOTEL_WEBHOOK_SECRET'])
      return render json: { error: 'Invalid signature' }, status: :unauthorized
    end

    event = JSON.parse(payload)
    WebhookProcessorJob.perform_later(event)

    render json: { received: true }
  end
end

begin
  orbit.messages.send(channel: 'sms', to: 'invalid', body: 'Hi')
rescue Devotel::DevotelApiError => e
  puts e.code        # "INVALID_PHONE_NUMBER"
  puts e.status_code # 422
  puts e.message     # "The to field must be a valid E.164 phone number"
end

orbit = Devotel::Orbit.new(
  api_key: 'dv_live_sk_your_key_here',
  base_url: 'https://orbit-api.devotel.io/api/v1'
)