İçeriğe geç

Kanallar

Tek uç noktanın ardında yedi kanal türü

OmniMessage, kendi kanalınızı getirdiğiniz bir ağ geçididir. Hâlihazırda sahip olduğunuz göndericileri bağlarsınız; hepsi aynı şekilde adreslenir, izlenir ve faturalandırılır.

Kendi kanalınızı getirin

Konsoldan veya API ile bir kez bağlayın

Bağlanan bir gönderici, kimliği olan bir kanala dönüşür. Bu kimlik, gönderim isteğindeki kanala özgü tek değerdir.

  • Gönderici sizindir

    Numara, bot veya hesap, sağlayıcı nezdinde sizin adınıza kayıtlıdır. OmniMessage’dan ayrılmak, göndericinizi geride bırakmak anlamına gelmez.

  • İki ayrı fatura

    OmniMessage, giden mesaj başına bir ağ geçidi ücreti alır. Meta’nın, Twilio’nun veya başka bir sağlayıcının kanal için aldığı ücretler ise doğrudan onlar tarafından size faturalandırılır.

  • Giriş yapın veya kimlik bilgilerini yapıştırın

    WhatsApp, Messenger ve Instagram konsolda Facebook ile, TikTok ise TikTok ile giriş yapılarak yetkilendirilir. Telegram, SMS ve SMS OTP, konsoldan veya API üzerinden girilen kimlik bilgileriyle bağlanır; hâlihazırda Cloud API üzerinde olan bir WhatsApp numarası da bu şekilde bağlanabilir.

  • Kimlik bilgileri salt yazılırdır

    Belirteçler, kodlar ve kimlik bilgileri, bir kanal bağladığınızda teslimat katmanına iletilir. Ağ geçidi bunları saklamaz ve API bunları hiçbir zaman geri döndürmez.

POST /v1/channels
curl https://api.omnimessage.co/v1/channels \
  -H "Authorization: Bearer om_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "whatsapp",
    "name": "Support line",
    "identifier": "+971800123456",
    "credentials": {
      "wab_account_id": "...",
      "phone_number_id": "...",
      "access_token": "..."
    }
  }'
201 Created
{
  "id": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "object": "channel",
  "mode": "live",
  "type": "whatsapp",
  "name": "Support line",
  "identifier": "+971800123456",
  "status": "active",
  "connection_status": "pending",
  "capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
  "created_at": "2026-10-01T08:00:00.000Z"
}

WhatsApp, Telegram, SMS ve SMS OTP için. channels:write kapsamını gerektirir. Bağlantı durumunu izlemek için channel.connected ve channel.disconnected olaylarına abone olun.

WhatsApp Business

Sahibi olduğunuz bir WhatsApp Business Platform (Cloud API) telefon numarasından gönderin. OmniMessage mesajlarınızı Cloud API’ye iletir ve gönderildi, teslim edildi, okundu ve başarısız durumlarını size geri bildirir.

Giden mesaj başına $0,001 veya bir paket kredisi

Gerekenler
Meta işletme portföyünüze erişimi olan bir Facebook girişi. Konsolda Facebook ile devam edin; Meta Embedded Signup, WhatsApp Business hesabını ve numarayı kurar. Hâlihazırda Cloud API üzerinde olan bir numara, kimlikleri ve bir sistem kullanıcısı erişim belirteciyle konsoldan veya API üzerinden de bağlanabilir.
API kimlik bilgileri
wab_account_idphone_number_idaccess_token
Kanal türü
whatsapp
Gönderici tanımlayıcısı
E.164 biçiminde gönderici telefon numarası; örneğin +971800123456.
Alıcı (to)
E.164 biçiminde telefon numarası.
Bilmeniz gerekenler
  • 24 saatlik müşteri hizmetleri penceresi dışında WhatsApp yalnızca onaylı şablon mesajlarını kabul eder.
  • Bir kanalın onaylı şablonlarını GET /v1/channels/:id/templates ile listeleyin.
  • Meta görüşme ücretleri, Meta tarafından WhatsApp Business hesabınızdan tahsil edilir. Bunlar ağ geçidi ücretinden ayrıdır.

SMS

Kendi Twilio hesabınızdaki bir Twilio telefon numarasından SMS gönderin. Bildirimler, hatırlatmalar ve çift yönlü görüşmeler için kullanın; gelen mesajlar webhook’unuza iletilir.

Giden mesaj başına $0,0005 veya bir paket kredisi

Gerekenler
Bir Twilio hesabı ve mesajlaşmaya açık bir telefon numarası.
API kimlik bilgileri
account_sidphone_number_sidauth_token
Kanal türü
sms
Gönderici tanımlayıcısı
E.164 biçiminde gönderici telefon numarası.
Alıcı (to)
E.164 biçiminde telefon numarası.
Mesaj türleri
MetinEkler
Bilmeniz gerekenler
  • Medya ekleri, numaranızın ve hedef şebekenin desteklediklerine bağlıdır.
  • Operatör ve Twilio ücretleri, Twilio tarafından Twilio hesabınızdan tahsil edilir. Bunlar ağ geçidi ücretinden ayrıdır.

SMS OTP

Doğrulama kodları için ayrılmış bir kanal türü. Yalnızca düz metin kabul eder; böylece bir giriş akışı bu kanaldan yanlışlıkla başka bir şey gönderemez.

Giden mesaj başına $0,0005 veya bir paket kredisi

Gerekenler
OTP SMS sağlayıcınızda bir hesap ve bu hesabın API anahtarı.
API kimlik bilgileri
api_key
Kanal türü
sms_otp
Gönderici tanımlayıcısı
Sağlayıcınızda kayıtlı gönderici kimliği veya numarası.
Alıcı (to)
E.164 biçiminde telefon numarası.
Mesaj türleri
Metin
Bilmeniz gerekenler
  • Yalnızca metin. Ekler ve etkileşimli türler unsupported_message_type ile reddedilir.
  • Sağlayıcı ücretleri sağlayıcınız tarafından tahsil edilir. Bunlar ağ geçidi ücretinden ayrıdır.

Telegram

Oluşturduğunuz bir Telegram botu üzerinden gönderin. Tek kimlik bilgisi bot belirtecidir; bota mesaj yazan kişiler message.received olayları olarak ulaşır.

Giden mesaj başına $0,0003 veya bir paket kredisi

Gerekenler
Bir Telegram botu ve @BotFather üzerinden alınan belirteci. Bot kullanıcı adı, bağlantı sırasında Telegram’dan okunur.
API kimlik bilgileri
access_token
Kanal türü
telegram
Gönderici tanımlayıcısı
Belirteçle Telegram’dan okunan bot kullanıcı adı.
Alıcı (to)
Telegram sohbet kimliği.
Bilmeniz gerekenler
  • Bir bot yalnızca kendisiyle sohbet başlatmış kişilere mesaj gönderebilir.
  • Her kişinin sohbet kimliği, tetiklediği message.received olaylarında yer alır.

Messenger

Facebook Sayfanızla iletişime geçen kişilere metin, medya ve yanıt düğmeleriyle yanıt verin. Gelen mesajlar, yanıt vermek için ihtiyaç duyduğunuz gönderen kimliğiyle birlikte webhook’unuza ulaşır.

Giden mesaj başına $0,0005 veya bir paket kredisi

Gerekenler
Bir Facebook Sayfası ve bu Sayfa üzerinde tam denetime sahip bir Facebook girişi.
Nasıl bağlanır?
Konsolda Facebook ile devam edin ve gönderim yapılacak Sayfayı seçin.Bu kanal türü için kopyalanacak kimlik bilgisi yoktur ve bu tür bir API anahtarıyla oluşturulamaz.
Kanal türü
messenger
Gönderici tanımlayıcısı
Kanalın gönderim yaptığı Sayfa.
Alıcı (to)
Sayfa kapsamlı kullanıcı kimliği.
Bilmeniz gerekenler
  • Sayfa kapsamlı kimlikler her Sayfa için ayrı verilir. Bunları message.received olaylarında alırsınız.
  • Neyi ne zaman gönderebileceğiniz konusunda Meta mesajlaşma politikaları geçerlidir.

Instagram

Instagram profesyonel hesabınıza gönderilen direkt mesajları, diğer tüm kanallarla aynı uç nokta üzerinden metin, medya ve yanıt düğmeleriyle yanıtlayın.

Giden mesaj başına $0,0005 veya bir paket kredisi

Gerekenler
Yönettiğiniz bir Facebook Sayfasına bağlı bir Instagram profesyonel hesabı.
Nasıl bağlanır?
Konsolda Facebook ile devam edin ve Instagram hesabınızın bağlı olduğu Sayfayı seçin. Bağlı bir profesyonel hesabı olmayan Sayfalar bağlanamaz.Bu kanal türü için kopyalanacak kimlik bilgisi yoktur ve bu tür bir API anahtarıyla oluşturulamaz.
Kanal türü
instagram
Gönderici tanımlayıcısı
Kanalın gönderim yaptığı Instagram hesabı.
Alıcı (to)
Sayfa kapsamlı kullanıcı kimliği.
Bilmeniz gerekenler
  • Kapsamlı kimlikler her hesap için ayrı verilir. Bunları message.received olaylarında alırsınız.
  • Neyi ne zaman gönderebileceğiniz konusunda Meta mesajlaşma politikaları geçerlidir.

TikTok

TikTok işletme hesabınıza mesaj yazan kişilere metin, medya ve yanıt düğmeleriyle yanıt verin; her mesajı aynı durumlar ve webhook’larla izleyin.

Giden mesaj başına $0,0005 veya bir paket kredisi

Gerekenler
Giriş yapabildiğiniz bir TikTok Business hesabı.
Nasıl bağlanır?
Konsolda TikTok ile devam edin ve işletme hesabınızın mesajlarına erişimi onaylayın.Bu kanal türü için kopyalanacak kimlik bilgisi yoktur ve bu tür bir API anahtarıyla oluşturulamaz.
Kanal türü
tiktok
Gönderici tanımlayıcısı
Kanalın gönderim yaptığı TikTok hesabı.
Alıcı (to)
Bir message.received olayındaki gönderen kimliği.
Bilmeniz gerekenler
  • Neyi ne zaman gönderebileceğiniz konusunda TikTok mesajlaşma politikaları geçerlidir.

İlk kanalınızı bağlayın

Bir hesap oluşturun, hâlihazırda sahip olduğunuz bir göndericiyi ekleyin ve sandbox’ta test ettiğiniz istekle aynı isteği kullanarak onun üzerinden gönderin.