Hızlı Başlangıç

Adım 1: Hesap Oluşturun

orbit.devotel.io/signup adresinden kaydolun. Kontrol paneli sizi otomatik olarak bölge tercihinize uygun URL’ye yönlendirir. Kredi kartı gerekmez — bir sonraki adımda sandbox’ın kilidini açmak için e-postanızı doğrulamanız yeterlidir.

Adım 2: Sandbox API Anahtarı Alın

Settings > API Keys bölümüne gidin, yeni bir anahtar oluşturun ve modunu Test olarak ayarlayın. Sandbox anahtarları dv_test_sk_ önekiyle başlar, KYC veya onay adımı olmadan hemen çalışır ve maliyeti $0’dır — her sandbox gönderimi kendi bünyemizde simüle edilir ve asla gerçek bir operatöre ulaşmaz veya Stripe’a dokunmaz. Anahtarı yalnızca sunucu tarafında saklayın. (Canlı anahtarlar dv_live_sk_ önekiyle başlar ve gerçek trafiği faturalandırır — üretim numaralarına hazır olduğunuzda Adım 5: Canlıya Geçiş bölümüne bakın.)

Adım 3: İlk Mesajınızı Gönderin (Sandbox)

Aynı /messages/<channel> uç nokta yapısı SMS, WhatsApp, Email, RCS, Viber ve diğer mesajlaşma kanallarında çalışır — önce entegre edeceğiniz kanalı seçin. Ses ayrıdır: çağrıları POST /voice/calls ile gerçekleştirin (aşağıdaki Voice örneğine bakın). Aşağıda $ORBIT_API_KEY olarak Adım 2’deki dv_test_sk_ anahtarınızı kullanın — gönderim ücretsiz ve anında olur, canlı trafik riski yoktur.

cURL

curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+14155551234",
    "body": "Hello from Orbit!"
  }'

curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": { "code": "en" }
    }
  }'

curl -X POST https://api.orbit.devotel.io/api/v1/messages/email \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "from": "hello@yourdomain.com",
    "subject": "Welcome",
    "html": "<h1>Welcome to Acme</h1>"
  }'

Node.js SDK

@devotel-orbit/node bu üç curl çağrısını tipli metotlarla değiştirir — tam referans için Node.js SDK sayfasına bakın.

import { Orbit } from '@devotel-orbit/node';

const orbit = new Orbit({
  apiKey: process.env.ORBIT_API_KEY!,
});

// SMS
await orbit.messages.send({
  channel: 'sms',
  to: '+14155552671',
  body: 'Hello from Orbit!',
});

// WhatsApp template
await orbit.messages.sendWhatsApp({
  to: '+14155552671',
  type: 'template',
  template: {
    name: 'hello_world',
    language: { code: 'en' },
  },
});

// Email
await orbit.messages.sendEmail({
  to: 'user@example.com',
  from: 'hello@yourdomain.com',
  subject: 'Welcome',
  html: '<h1>Welcome to Acme</h1>',
});

Python SDK

# Not yet on PyPI — install from the workspace package:
#   pip install ./packages/sdk-python
export ORBIT_API_KEY=dv_test_sk_your_key_here

from orbit_sdk import OrbitClient, OrbitError

client = OrbitClient.from_env()

try:
    result = client.messages.send_sms(
        to="+14155552671",
        body="Hello from Orbit!",
    )
    print("queued:", result["data"]["id"])
except OrbitError as exc:
    print("send failed:", exc.code, exc.message)

Python SDK çekirdek kapsamlı ve yayımlanmamıştır — SMS, WhatsApp ve e-posta gönderimleri bugün çalışır; daha derin yüzeyler (ses kayıtları, konferanslar, IVR, dialer) kasıtlı olarak kapsam dışıdır. Bunlar için yukarıdaki Node SDK’yı kullanın veya REST API’yi doğrudan düşük seviyeli client.request(method, path, ...) kaçış yoluyla çağırın — Dile göre SDK kapsamı bölümüne bakın.

Go SDK

# Not yet on a public module proxy — go get the workspace module path:
#   go get github.com/devotel/orbit-go
export ORBIT_API_KEY=dv_test_sk_your_key_here

// go.mod: require github.com/devotel/orbit-go (module path, not yet on a public proxy)
package main

import (
	"context"
	"fmt"
	"os"
	"time"

	"github.com/devotel/orbit-go/orbit"
)

func main() {
	client, err := orbit.NewClient(os.Getenv("ORBIT_API_KEY"))
	if err != nil {
		panic(err)
	}

	ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
	defer cancel()

	resp, err := client.Messages().SendSMS(ctx, orbit.SendSMSInput{
		To:   "+14155552671",
		Body: "Hello from Orbit!",
	})
	if err != nil {
		panic(err)
	}
	fmt.Println("queued:", resp.Data.ID)
}

Go SDK çekirdek kapsamlı ve yayımlanmamıştır — client.Messages() + client.Voice() bugün çalışır; ses konferansları/IVR/dialer/kayıtlar kapsam dışıdır. Bunlar için Node SDK’yı veya düşük seviyeli client.Request(ctx, method, path, ...) kaçış yolunu kullanın — Dile göre SDK kapsamı bölümüne bakın.

Ruby SDK

# Not yet on RubyGems — add the workspace path to your Gemfile:
#   gem "orbit_sdk", path: "packages/sdk-ruby"
export ORBIT_API_KEY=dv_test_sk_your_key_here

require "orbit_sdk"

client = OrbitSdk::Client.from_env
begin
  result = client.messages.send_sms(
    to: "+14155552671",
    body: "Hello from Orbit!",
  )
  puts "queued: #{result.dig("data", "id")}"
rescue OrbitSdk::OrbitError => e
  warn "send failed: #{e.code} — #{e.message}"
end

Ruby SDK çekirdek kapsamlı ve yayımlanmamıştır — client.messages + client.voice gönderimleri bugün çalışır; kayıtlar/transkriptler/konferanslar/IVR/dialer kapsam dışıdır. Bunlar için Node SDK’yı veya düşük seviyeli client.request(method, path, **opts) kaçış yolunu kullanın — Dile göre SDK kapsamı bölümüne bakın.

PHP SDK

# Not yet on Packagist — vendor the SDK from the monorepo or call the
# REST API directly. Setup lives on the PHP SDK page:
#   https://orbit.devotel.io/sdks/php
export ORBIT_API_KEY=dv_test_sk_your_key_here

<?php
use Devotel\Orbit\Errors\OrbitError;
use Devotel\Orbit\OrbitClient;

try {
    $client = OrbitClient::fromEnv();
    $result = $client->messages->sendSms(
        to: '+14155552671',
        body: 'Hello from Orbit!',
    );
    printf("queued: %s\n", $result['data']['id'] ?? '?');
} catch (OrbitError $e) {
    fwrite(STDERR, "send failed: {$e->errorCode} — {$e->getMessage()}\n");
}

PHP SDK çekirdek kapsamlı ve yayımlanmamıştır — $client->messages + $client->voice gönderimleri bugün çalışır; konferanslar, IVR, dialer, SIP trunk’lar ve kayıtlar kapsam dışıdır. Bunlar için Node SDK’yı veya düşük seviyeli OrbitClient::request(method: ..., path: ..., ...) kaçış yolunu kullanın — Dile göre SDK kapsamı bölümüne bakın.

Java SDK

# Not yet on Maven Central — build + depend on the workspace module:
#   mvn -f packages/sdk-java/pom.xml install
export ORBIT_API_KEY=dv_test_sk_your_key_here

import io.devotel.orbit.OrbitClient;
import io.devotel.orbit.errors.OrbitError;

import java.util.Map;

OrbitClient client = OrbitClient.fromEnv();
try {
    Map<String, Object> result = client.messages.sendSms(
        "+14155552671",
        "Hello from Orbit!"
    );
    System.out.println("queued: " + result.get("data"));
} catch (OrbitError e) {
    System.err.println("send failed: " + e.getCode() + " — " + e.getMessage());
}

Java SDK çekirdek kapsamlı ve yayımlanmamıştır — client.messages + client.voice gönderimleri bugün çalışır; kayıtlar/transkriptler/konferanslar/IVR/dialer ve WhatsApp şablon bileşenleri kapsam dışıdır. Bunlar için Node SDK’yı veya düşük seviyeli client.request(method, path, ...) kaçış yolunu kullanın — Dile göre SDK kapsamı bölümüne bakın.

C# SDK

# Not yet on NuGet — add the workspace project reference:
#   dotnet add reference packages/sdk-csharp
export ORBIT_API_KEY=dv_test_sk_your_key_here

// xmlns/pep: the .NET client ships as Orbit.Sdk in the monorepo.
using Orbit.Sdk;
using Orbit.Sdk.Errors;

try
{
    var client = OrbitClient.FromEnv();
    var result = await client.Messages.SendSmsAsync(
        "+14155552671",
        "Hello from Orbit!"
    );
    if (result.TryGetProperty("data", out var data) &&
        data.TryGetProperty("id", out var id))
        Console.WriteLine($"queued: {id.GetString()}");
}
catch (OrbitError e)
{
    Console.Error.WriteLine($"send failed: {e.Code} — {e.Message}");
}

.NET SDK çekirdek kapsamlı ve yayımlanmamıştır — client.Messages + client.Voice gönderimleri bugün çalışır; kayıtlar/transkriptler/konferanslar/IVR/dialer kapsam dışıdır. Bunlar için Node SDK’yı veya düşük seviyeli client.RequestAsync(method, path, ...) kaçış yolunu kullanın — Dile göre SDK kapsamı bölümüne bakın.

Voice

cURL

POST /voice/calls ile bir çağrı başlatın:

curl -X POST https://api.orbit.devotel.io/api/v1/voice/calls \
  -H "X-API-Key: $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "from": "+14155551234",
    "agent_id": "agt_support_bot"
  }'

Node.js SDK

const call = await orbit.voice.calls.create({
  to: '+14155552671',
  from: '+14155551234',
  agent_id: 'agt_support_bot',
});

Diğer altı SDK (Python, Go, Ruby, PHP, Java, C#) POST /voice/calls uç noktasını çekirdek kapsamları dahilinde destekler — yukarıdaki dile özgü bölümlere bakın. Ses kayıtları, transkriptler, konferanslar, IVR ve dialer bu SDK’lar için kapsam dışıdır; Node SDK’yı veya REST API’yi doğrudan her dilin düşük seviyeli request(...) kaçış yoluyla kullanın — Dile göre SDK kapsamı bölümüne bakın.

Ses ile sıfırdan mı başlıyorsunuz? Özel Voice Quickstart kılavuzunu izleyin — bir numara tedarik etmeyi, bir aracıyı sistem istemiyle yapılandırmayı, tarayıcı mikrofonuyla test etmeyi ve SSE olay aboneliğini kapsar; tümü 5 dakikadan kısa sürer.

$ORBIT_API_KEY değerini Adım 2’deki anahtarla değiştirin (veya kabuğunuzda dışa aktarın). Anahtarınızı doğrudan paylaşılan kod parçacıklarına yapıştırmayın.

Adım 4: Yanıtı Kontrol Edin

{
  "data": {
    "id": "msg_abc123",
    "status": "queued",
    "channel": "sms"
  },
  "meta": {
    "request_id": "req_xyz789",
    "timestamp": "2026-03-08T00:00:00Z"
  }
}

Tebrikler — Orbit ile ilk mesajınızı ücretsiz olarak 5 dakikadan kısa sürede gönderdiniz. Bir sandbox gönderimi, delivered/failed durumuna yükseltilmek yerine dürüst test_sent durumunu korur — isteğe bağlı olarak belirli bir teslimat raporu sonucu (delivered, undelivered, expired ve 7 diğer) tetiklemek için, eşleşen son rakamına sahip bir alıcı numarasına gönderin; Sandbox Magic Numbers sayfasına bakın. Sırada bir teslimat webhook’u bağlayın: Webhooks sayfasına bakın.

Adım 5: Canlıya Geçiş

Sandbox trafiği asla gerçek bir operatöre ulaşmadığından, entegrasyonunuzu oluşturmanın ve test etmenin en hızlı yoludur — ancak canlıya geçmek iki şey daha gerektirir:

KYC doğrulaması. İşletme belgelerinizi Settings > KYC altında gönderin. Bir yönetici kuruluşunuzu onayladığında canlı gönderimin kilidi açılır — ancak Orbit kullandıkça öde modeliyle çalışır ve otomatik deneme kredisi yoktur, bu nedenle Settings > Billing altından bakiye ekleyene kadar canlı bakiyeniz $0 kalır. SMS (ABD veya uluslararası), WhatsApp ve ses, gönderilebilmeleri için onaylı KYC ve finanse edilmiş bakiye gerektirir.
ABD SMS için 10DLC kaydı. ABD numaralarına canlı trafik üzerinden SMS göndermek ayrıca 10DLC marka + kampanya kaydı gerektirir — KYC’nin üzerine eklenen ve onun yerine geçmeyen bir uyumluluk adımı. Sender ID Registration sayfasına bakın.

KYC onaylandıktan sonra, Settings > API Keys altında bir canlı anahtar (dv_live_sk_ öneki) oluşturun ve yukarıda kullandığınız dv_test_sk_ anahtarıyla değiştirin — istek yapısı değişmez.

Reference

Hızlı Başlangıç: ilk SMS, çağrı veya e-postanızı gönderin

Hızlı Başlangıç

Adım 1: Hesap Oluşturun

Adım 2: Sandbox API Anahtarı Alın

Adım 3: İlk Mesajınızı Gönderin (Sandbox)

cURL

Node.js SDK

Python SDK

Go SDK

Ruby SDK

PHP SDK

Java SDK

C# SDK

Voice

cURL

Node.js SDK

Adım 4: Yanıtı Kontrol Edin

Adım 5: Canlıya Geçiş

​Hızlı Başlangıç

​Adım 1: Hesap Oluşturun

​Adım 2: Sandbox API Anahtarı Alın

​Adım 3: İlk Mesajınızı Gönderin (Sandbox)

​cURL

​Node.js SDK

​Python SDK

​Go SDK

​Ruby SDK

​PHP SDK

​Java SDK

​C# SDK

​Voice

​cURL

​Node.js SDK

​Adım 4: Yanıtı Kontrol Edin

​Adım 5: Canlıya Geçiş

Hızlı Başlangıç

Adım 1: Hesap Oluşturun

Adım 2: Sandbox API Anahtarı Alın

Adım 3: İlk Mesajınızı Gönderin (Sandbox)

cURL

Node.js SDK

Python SDK

Go SDK

Ruby SDK

PHP SDK

Java SDK

C# SDK

Voice

cURL

Node.js SDK

Adım 4: Yanıtı Kontrol Edin

Adım 5: Canlıya Geçiş