Bu rehberde: Verimor hesabınızı kullanıcı adı, API şifresi ve onaylı başlığınızla bağlarsınız. Tekil SMS ve SMS kampanyası gönderirsiniz; ticari mesajlar Verimor'un İYS kontrolünden geçer. Push adresiyle teslim raporları mesaj durumlarını günceller, 0850 numaranıza gelen SMS'ler Gelen Kutusu'na düşer.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | VERIMOR |
| Kategori | Mesajlaşma (SMS) |
| Kimlik doğrulama | Kullanıcı adı (90850…) + API şifresi (istek gövdesinde) |
| Kapsam | Organizasyon |
| Webhook | Evet (teslim raporları + gelen SMS, tek push adresi) |
| Yetenekler | Mesaj gönderme, mesaj alma, toplu mesaj |
| Kullanan kutular | Mesaj geldi, Mesaj gönder (kanal SMS veya SMS – Verimor), Toplu mesaj |
| Kullanan ajanlar | AI Chatbot (0850 numarasına gelen SMS'ler) |
Ne işe yarar?
- Tekil SMS ve SMS kampanyası; numaralar
905XXXXXXXXXbiçimine çevrilir. Verimor'un döndürdüğü kampanya numarası her mesajda saklanır. - Teslim raporları push ile gelir:
DELIVERED→ iletildi;NOT_DELIVERED,EXPIRED,REJECTED,NOT_ALLOWED_BY_IYS(İYS izni yok),BLACKLISTED_DESTINATION_ADDRESSvb. → başarısız.WAITING/SENDINGdurumu değiştirmez. - Gelen SMS: Verimor abone numaranıza (0850…) gelen SMS'ler Gelen Kutusu'nda konuşma açar; chatbot veya Mesaj geldi tetikleyicili bir workflow yanıt verebilir. Alfanümerik başlıkla gönderilen SMS'lere alıcı yanıt veremez.
Ön koşullar
- Verimor hesabı ve SMS kredisi; kullanıcı adı 12 haneli abone numaranızdır (
908501234567). - API şifresi: OİM → SMS Ayarlarım sayfasında tanımlanır.
- IP izni (zorunlu): BTK yönergeleri gereği SMS gönderen sunucunun IP adresi aynı sayfada izinli olmalıdır; yoksa
401 Hesabınızda izinli IP ayarları yapılmamışhatası alırsınız. OrqLabs'ın çıkış IP adresini destek ekibinden alıp ekleyin. - Onaylı alfanümerik başlık: BTK kararı gereği API'den yalnızca alfanümerik başlıkla gönderim yapılır.
- Ticari gönderim için başlığa OİM → Başlık Yönetimi'nden İYS marka kodu girilmiş ve İYS'de Verimor'a yetki (AHS izni) verilmiş olmalıdır.
Adım adım kurulum
- OİM → SMS Ayarlarım: API şifresi belirleyin ve OrqLabs'ın çıkış IP'sini izinli IP'lere ekleyin.
- OrqLabs → Entegrasyonlar → Verimor SMS → Bağla.
| Alan | Değer |
|---|---|
| Kullanıcı adı (90…) | 908501234567 |
| API şifresi | OİM'de belirlediğiniz şifre |
| Gönderici başlığı | Onaylı başlığınız (ör. MARKAM) |
| İYS modu | Otomatik (önerilen), Her zaman bilgilendirme, Her zaman ticari – bireysel / tacir |
- Bağlantıyı test et: kalan kredi ve onaylı başlıklar listelenir; girdiğiniz başlık listede yoksa hata verir.
- Push adımını tamamlayın ve kendinize deneme SMS'i gönderin.
Push adresi (teslim raporu ve gelen SMS)
- OrqLabs → Verimor kartı → Webhook URL ve doğrulama anahtarı.
- OİM → SMS Ayarlarım → gönderim raporu ve gelen SMS push adresi olarak şunu girin:
https://api.orqlabs.com/api/v1/webhooks/verimor/<hesap kimliği>?token=<doğrulama anahtarı> - Verimor push isteklerini imzalamaz; OrqLabs her isteği adresteki
tokenile doğrular. Verimor 200 yanıt alamazsa 5 dakika arayla 3 kez daha dener.
İYS ve 6563 sayılı Kanun
Tüketicilere ticari elektronik ileti için önceden onay alınmalı ve onay İYS'de kayıtlı olmalıdır (6563 sayılı Kanun). Tacirlere ret bildirimi olmadıkça gönderilebilir.
| İYS modu | Kampanya mesajı | Tekil mesaj |
|---|---|---|
| Otomatik (varsayılan) | is_commercial: true, iys_recipient_type: BIREYSEL | is_commercial: false |
| Her zaman bilgilendirme | is_commercial: false | is_commercial: false |
| Her zaman ticari – bireysel / tacir | is_commercial: true, BIREYSEL / TACIR | aynı |
İYS izni olmayan alıcıya giden ticari SMS raporda "İYS izni yok" ile başarısız olur. İYS entegrasyonu bağlıysa OrqLabs bu alıcıları kampanyaya hiç almaz ("İYS onayı yok").
Limitler
| Konu | Sınır |
|---|---|
| Gönderim isteği | Dakikada 240 istek (aşımda 429) |
| Mesaj boyu | Türkçe karakterli 1.043, Türkçe karaktersiz 1.071 karakter (7 boy) |
| Mükerrer | Aynı içerik aynı gün aynı başlıkla aynı numaraya gönderilemez |
| Geçerlilik | Varsayılan 24 saat |
| OrqLabs toplu mesaj | Dakikada varsayılan 20 mesaj |
Sık karşılaşılan hatalar
| Verimor yanıtı | OrqLabs hatası | Neden / çözüm |
|---|---|---|
| 401 "Geçersiz kullanıcı adı/şifre" | AUTH | Kullanıcı adı / API şifresi hatalı |
| 401 "izinli IP ayarları yapılmamış" | CONFIG | OrqLabs çıkış IP'sini OİM'de izinli IP'lere ekleyin |
INVALID_SOURCE_ADDRESS | CONFIG | Başlık kabul edilmedi; onaylı başlığı birebir girin |
NUMERIC_SOURCE_ADDRESS_NOT_ALLOWED | CONFIG | API'de yalnızca alfanümerik başlık |
INSUFFICIENT_CREDITS | FORBIDDEN | Kredi yetersiz |
MISSING_IYS_BRAND_CODE, AHS_AUTHORIZATION_ERROR, NO_AHS_BRAND_ERROR | CONFIG / FORBIDDEN | Başlığın İYS marka kodu yok veya İYS'de Verimor'a yetki verilmemiş |
INVALID_DESTINATION_ADDRESS | INVALID | Alıcı numarası geçersiz |
MUKERRER_RAPORLAMA | INVALID | Aynı SMS son 24 saatte gönderilmiş |
| 429 | RATE_LIMIT | İstek sınırı; kuyruk bir dakika sonra yeniden dener |
Sık sorulan sorular
Müşterilerim SMS'e yanıt verebilir mi? Alfanümerik başlıkla gönderilen SMS'lere yanıt verilemez. Müşteriler 0850 numaranıza SMS atarsa mesaj Gelen Kutusu'na düşer.
SMS ücreti nereden düşer? Verimor hesabınızın kredisinden; OrqLabs ek ücret almaz.