Verimor SMS

Verimor API üzerinden SMS gönder, bakiye sorgula, rapor al, başlıkları listele ve kara liste yönet.

Security Scan

The skill's instructions, required tools, and credential use match its stated purpose (sending/managing SMS via Verimor); nothing requests unrelated privileges or external systems.

Purpose & Capability

Name/description (Verimor SMS) align with the actions in SKILL.md (send SMS, balance, reports, headers, blacklist). Required binaries (curl, jq) and credentials (VERIMOR_USERNAME, VERIMOR_PASSWORD, VERIMOR_SOURCE) are appropriate for calling the Verimor HTTP API.

Instruction Scope

Runtime instructions are concrete curl calls to https://sms.verimor.com.tr/v2 endpoints and use only the declared config values. The skill does not instruct reading arbitrary files, other environment variables, or sending data to unrelated endpoints.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing is downloaded or written to disk by the skill itself.

Credentials

The credentials requested by the SKILL.md (username, password, source) are appropriate and minimal for the API. Note: registry metadata reported 'Required env vars: none' while SKILL.md declares three config vars — this metadata mismatch should be clarified before installation so you know the platform will store/provide those credentials correctly.

Persistence & Privilege

always:false and no special privileges requested. The skill does not request system-wide config modification or permanent elevated presence.

Assessment

This skill is coherent with its stated purpose: it uses curl/jq and your Verimor username/password/source to call Verimor's API endpoints. Before installing: (1) verify you trust the skill author or prefer an official integration; (2) ensure the platform will store VERIMOR_USERNAME/VERIMOR_PASSWORD/VERIMOR_SOURCE securely (the registry metadata omitted listing these, which is a minor inconsistency to verify); (3) supply a dedicated API account/password with minimal permissions (don’t reuse high-privilege credentials); (4) be aware the skill will perform live SMS sends and blacklist changes — avoid enabling autonomous invocation if you don’t want automated sends without an extra confirmation step; (5) confirm network access to https://sms.verimor.com.tr is allowed and that usage (cost/privacy) is acceptable.

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ı

HTTP Kodu	Anlam
400	Geçersiz istek (numara formatı, eksik alan)
401	Hatalı kullanıcı adı veya şifre
403	IP izinsiz veya yetkisiz erişim
429	Rate 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.