verimor-sms（维里莫尔短信）

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:

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:

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:

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:

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:

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

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

7. Kara Listeye Numara Ekle

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

Hata Durumları

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.