Bu rehberde: İleti Merkezi hesabınızı API anahtarı, API hash ve onaylı başlığınızla bağlarsınız. Workflow'lardan tekil SMS, kampanyalardan toplu SMS gönderirsiniz; ticari mesajlar İleti Merkezi'nin İYS kontrolünden geçer, teslim raporları webhook ile mesaj durumlarını günceller.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | ILETI_MERKEZI |
| Kategori | Mesajlaşma (SMS) |
| Kimlik doğrulama | API anahtarı + API hash (istek gövdesinde authentication.key / authentication.hash) |
| Kapsam | Organizasyon |
| Webhook | Evet (teslim raporları) |
| Yetenekler | Mesaj gönderme, toplu mesaj |
| Kullanan kutular | Mesaj gönder (kanal SMS veya SMS – İleti Merkezi), Toplu mesaj |
Ne işe yarar?
- Tekil SMS (bildirim, randevu, OTP) ve SMS kampanyası gönderir; numaralar
905XXXXXXXXXbiçimine çevrilir. - İleti Merkezi'nin döndürdüğü sipariş numarası (
order.id) her mesajda saklanır; teslim raporu webhook'u geldiğinde mesaj ve kampanya durumu iletildi veya başarısız olur. - Ticari SMS'ler
iys=1veiysList=BIREYSEL|TACIRile gider: İleti Merkezi İYS'de onayı olmayan alıcıya iletmez.
Ön koşullar
- İleti Merkezi hesabı ve SMS kredisi.
- Onaylı gönderici adı (başlık): en fazla 11 karakter, Türkçe karakter yok. Panelde başlık başvurusu yapın.
- API erişimi açık olmalı: panel → Ayarlar → Güvenlik → Erişim izinleri → "API kullanımına izin ver". Kapalıysa her istek 401 döner.
- Ticari gönderim için panelde İYS marka kodu ve İYS sorgu ayarı tanımlı olmalı (aksi halde 468 / 470 hataları).
Adım adım kurulum
- İleti Merkezi paneli → Ayarlar → Güvenlik → API Erişimi: API anahtarı ve API hash değerlerini kopyalayın. Hash'i panel hazır verir; kendiniz hesaplamayın, olduğu gibi yapıştırın.
- OrqLabs → Entegrasyonlar → İleti Merkezi SMS → Bağla.
| Alan | Değer |
|---|---|
| API anahtarı | Panelden kopyaladığınız anahtar |
| API hash | Panelin verdiği hash |
| Gönderici adı (başlık) | Onaylı başlığınız (ör. MARKAM) |
| İYS modu | Otomatik (önerilen), Her zaman bilgilendirme, Her zaman ticari – bireysel / tacir |
- Bağlantıyı test et: bakiye (TL ve SMS adedi) ile onaylı başlıklarınız gelir; girdiğiniz başlık listede değilse hata verir. Bu test kredi harcamaz.
- Webhook adımını tamamlayın, ardından kendinize Mesaj gönder (kanal SMS – İleti Merkezi) ile deneme yapın.
Webhook kurulumu (teslim raporları)
- OrqLabs → İleti Merkezi kartı → Webhook URL ve doğrulama anahtarı.
- İleti Merkezi paneli → Ayarlar → API → Webhook (
panel.iletimerkezi.com/settings/api/webhooks) → rapor adresi olarak şunu girin:https://api.orqlabs.com/api/v1/webhooks/ileti_merkezi/<hesap kimliği>?token=<doğrulama anahtarı> - İleti Merkezi webhook'ları imza göndermez; OrqLabs her isteği adresteki
tokenile doğrular. Anahtarı paylaşmayın. - Raporlar:
accepted(operatöre iletildi, durum değişmez),delivered→ iletildi,undelivered→ başarısız.
İYS ve 6563 sayılı Kanun
Tüketicilere ticari elektronik ileti göndermeden önce onay alınmalı ve onay İYS'de kayıtlı olmalıdır (6563 sayılı Kanun ve Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik). Tacirlere ret bildirimi olmadıkça gönderilebilir.
| İYS modu | Kampanya mesajı | Tekil mesaj |
|---|---|---|
| Otomatik (varsayılan) | iys=1, iysList=BIREYSEL | iys=0 (bilgilendirme) |
| Her zaman bilgilendirme | iys=0 | iys=0 |
| Her zaman ticari – bireysel / tacir | iys=1, iysList=BIREYSEL / TACIR | aynı |
İYS entegrasyonu bağlıysa OrqLabs kampanya öncesinde onayı olmayan alıcıları "İYS onayı yok" ile atlar. Bilgilendirme modu yalnızca gerçekten ticari olmayan mesajlar (sipariş durumu, şifre, randevu) içindir.
Limitler
| Konu | Sınır |
|---|---|
| Hız | Hesap başına saniyede 100 SMS (alıcı sayısına göre) |
| Gönderici adı | En fazla 11 karakter, Türkçe karakter yok |
| OrqLabs toplu mesaj | Dakikada varsayılan 20 mesaj |
Sık karşılaşılan hatalar
| Kod | OrqLabs hatası | Neden / çözüm |
|---|---|---|
| 401 | AUTH | Anahtar / hash hatalı ya da panelde API erişimi kapalı |
| 402 | FORBIDDEN | Bakiye yetersiz; kredi yükleyin |
| 450 | CONFIG | Başlık kullanılamaz; onaylı başlığı girin |
| 452 | INVALID | Alıcı numarası geçersiz |
| 454 | INVALID | Mesaj metni boş |
| 459 / 460 | CONFIG | Başlık boş veya 11 karakterden uzun / Türkçe karakterli |
| 467 | FORBIDDEN | Hesapta eksik evrak / sözleşme |
| 468 / 469 / 470 | CONFIG | İYS ayarı, İYS listesi veya İYS kodu tanımlı değil; panelde İYS bilgilerinizi girin |
| 503 | UPSTREAM | Geçici servis kesintisi; kuyruk yeniden dener |
Sık sorulan sorular
Hash'i nasıl üretirim? Üretmezsiniz; panel API anahtarıyla birlikte hazır hash verir. Değeri olduğu gibi yapıştırın.
Teslim raporları gelmiyor.
Webhook adresinde ?token= kısmının olduğundan ve OrqLabs'taki doğrulama anahtarıyla birebir aynı olduğundan emin olun; aksi halde istekler 401 ile reddedilir.
SMS ücreti nereden düşer? İleti Merkezi hesabınızın kredisinden; OrqLabs ek ücret almaz.