dotnet add package Devotel.Orbit

Install-Package Devotel.Orbit

using Devotel.Orbit;

var orbit = new Orbit("dv_live_sk_your_key_here");

// Send an SMS
var message = await orbit.Messages.SendAsync("+14155552671", "Hello from Orbit!", "sms");

Console.WriteLine(message); // {data: {message_id: msg_abc123, ...}}

// Program.cs
builder.Services.AddOrbitClient(options =>
{
    options.ApiKey = builder.Configuration["Devotel:ApiKey"];
});

public class MessagingService
{
    private readonly IOrbitClient _orbit;

    public MessagingService(IOrbitClient orbit) => _orbit = orbit;

    public async Task SendWelcome(string phoneNumber)
    {
        await _orbit.Messages.SendAsync(new SendMessageRequest
        {
            Channel = "sms",
            To = phoneNumber,
            Body = "Welcome to our service!"
        });
    }
}

// Send WhatsApp message
var waMessage = await orbit.Messages.SendWhatsAppAsync("+14155552671", "Hello from Orbit on WhatsApp!");

// Send Email
var email = await orbit.Messages.SendEmailAsync("user@example.com", "Welcome!", "<h1>Welcome to Acme</h1>");

// Send SMS shorthand
var sms = await orbit.Messages.SendSmsAsync("+14155552671", "Quick SMS hello!");

// Make an outbound call
var call = await orbit.Voice.CreateCallAsync("+14155552671", "+18005551234");

// Retrieve call details
var callDetails = await orbit.Voice.GetCallAsync(call.GetProperty("data").GetProperty("id").GetString()!);

// Send OTP
var verification = await orbit.Verify.SendAsync("+14155552671", "sms");

// Check OTP
var verificationId = verification.GetProperty("data").GetProperty("verification_id").GetString()!;
var result = await orbit.Verify.CheckAsync(verificationId, "482901");

Console.WriteLine(result.GetProperty("data").GetProperty("status")); // "approved"

using Devotel.Orbit.Webhooks;

// ASP.NET Core Minimal API
app.MapPost("/webhooks/orbit", async (HttpContext context) =>
{
    var payload = await new StreamReader(context.Request.Body).ReadToEndAsync();
    var signature = context.Request.Headers["X-Devotel-Signature"].ToString();

    if (!WebhookVerifier.Verify(payload, signature, "whsec_your_secret"))
    {
        return Results.Unauthorized();
    }

    var webhookEvent = WebhookEvent.Parse(payload);
    switch (webhookEvent.Type)
    {
        case "message.delivered":
            // Handle delivery
            break;
        case "call.completed":
            // Handle call completion
            break;
    }

    return Results.Ok(new { received = true });
});

try
{
    await orbit.Messages.SendAsync("invalid", "Hi", "sms");
}
catch (DevotelApiException ex)
{
    Console.Error.WriteLine(ex.Code);       // "INVALID_PHONE_NUMBER"
    Console.Error.WriteLine(ex.StatusCode); // 422
    Console.Error.WriteLine(ex.Message);    // "The to field must be a valid E.164 phone number"
}

var orbit = new Orbit("dv_live_sk_your_key_here");

// Or with a custom base URL
var orbitCustom = new Orbit("dv_live_sk_your_key_here", "https://orbit-api.devotel.io/api/v1");