Verimor SMS Skill#

Bu skill, Verimor SMS API ( https://sms.verimor.com.tr/v2) üzerinden SMS gönderimi ve yönetimi sağlar.

Kimlik Bilgileri#

Tüm komutlarda şu environment variable'ları kullan:

• VERIMOR_USERNAME → Verimor kullanıcı adı (905xxxxxxxxx formatında)
• VERIMOR_PASSWORD → Verimor API şifresi
• VERIMOR_SOURCE → Varsayılan gönderici başlık (örn: FIRMAM), yoksa boş bırak

---

1. SMS Gönder (tek veya çoklu alıcı)#

Kullanıcı "SMS gönder", "mesaj at", "bildirim gönder" gibi bir şey söylediğinde:

bash

curl -s -X POST https://sms.verimor.com.tr/v2/send.json \
  -H "Content-Type: application/json" \
  -d '{
    "username": "'"$VERIMOR_USERNAME"'",
    "password": "'"$VERIMOR_PASSWORD"'",
    "source_addr": "'"$VERIMOR_SOURCE"'",
    "messages": [
      {
        "dest": "905XXXXXXXXX",
        "msg": "Mesaj metni buraya"
      }
    ]
  }'

Birden fazla alıcı için dest alanına virgülle ayırarak ekle: "dest": "905111111111,905222222222"

İleri tarihli gönderim için send_at ekle: "send_at": "2025-06-01 10:00:00"

Ticari mesaj için: "is_commercial": true, "iys_recipient_type": "BIREYSEL"

Başarılı olursa API bir Kampanya ID döner (sayısal). Bunu kullanıcıya göster.

Türkçe karakter notu: Mesajda Ş ş Ğ ğ ç ı İ harfleri varsa "datacoding": 1 ekle. Yoksa "datacoding": 0 kullan.

---

2. Bakiye Sorgula#

Kullanıcı "bakiye", "kredi", "kaç SMS kaldı" dediğinde:

bash

curl -s "https://sms.verimor.com.tr/v2/balance?username=$VERIMOR_USERNAME&password=$VERIMOR_PASSWORD"

Dönen sayı kalan SMS kredisidir. Kullanıcıya "X kredi kaldı" şeklinde göster.

---

3. Gönderim Raporu Sorgula#

Kullanıcı kampanya ID vererek rapor istediğinde:

bash

curl -s "https://sms.verimor.com.tr/v2/status?username=$VERIMOR_USERNAME&password=$VERIMOR_PASSWORD&id=KAMPANYA_ID" | jq '.'

Her mesaj için şu alanları göster:

• dest → Alıcı numara
• status → DELIVERED, NOT_DELIVERED, WAITING, EXPIRED vb.
• done_at → İşlem zamanı
• credits → Harcanan kredi

---

4. Tanımlı Başlıkları Listele#

Kullanıcı "başlıklarım neler", "hangi başlıkları kullanabilirim" dediğinde:

bash

curl -s "https://sms.verimor.com.tr/v2/headers?username=$VERIMOR_USERNAME&password=$VERIMOR_PASSWORD" | jq '.'

---

5. Kampanya İptal Et#

Kullanıcı ileri tarihli bir kampanyayı iptal etmek istediğinde:

bash

curl -s -X POST https://sms.verimor.com.tr/v2/cancel/KAMPANYA_ID \
  -H "Content-Type: application/json" \
  -d '{"username": "'"$VERIMOR_USERNAME"'", "password": "'"$VERIMOR_PASSWORD"'"}'

---

6. Kara Liste Sorgula#

bash

curl -s "https://sms.verimor.com.tr/v2/blacklists?username=$VERIMOR_USERNAME&password=$VERIMOR_PASSWORD" | jq '.'

---

7. Kara Listeye Numara Ekle#

bash

curl -s -X POST "https://sms.verimor.com.tr/v2/blacklists?username=$VERIMOR_USERNAME&password=$VERIMOR_PASSWORD&phones=905XXXXXXXXX"

---

Hata Durumları#

HTTP KoduAnlam400Geçersiz istek (numara formatı, eksik alan)401Hatalı kullanıcı adı veya şifre403IP izinsiz veya yetkisiz erişim429Rate limit aşıldı (dakikada 240 istek)

Hata alınırsa kullanıcıya hata mesajını ve HTTP kodunu göster.

Numara Formatı#

Tüm Türkiye numaraları 905XXXXXXXXX formatında olmalı (başında 0 veya +90 değil). Kullanıcı 05XX veya +905XX formatında verirse otomatik düzelt.