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) - INLINECODE1 → Verimor API şifresi
- INLINECODE2 → 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:
CODEBLOCK0
Birden fazla alıcı için dest alanına virgülle ayırarak ekle:
INLINECODE4
İleri tarihli gönderim için send_at ekle:
INLINECODE6
Ticari mesaj için:
INLINECODE7
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:
CODEBLOCK1
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:
CODEBLOCK2
Her mesaj için şu alanları göster:
- -
dest → Alıcı numara - INLINECODE11 → DELIVERED, NOT_DELIVERED, WAITING, EXPIRED vb.
- INLINECODE12 → İşlem zamanı
- INLINECODE13 → 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.
Verimor SMS 技能
此技能通过 Verimor SMS API (https://sms.verimor.com.tr/v2) 提供短信发送和管理功能。
认证信息
所有命令均使用以下环境变量：
- - VERIMORUSERNAME → Verimor 用户名（格式：905xxxxxxxxx）
- VERIMORPASSWORD → Verimor API 密码
- VERIMOR_SOURCE → 默认发送者名称（例如：FIRMAM），若无则留空
1. 发送短信（单人或多人接收）
当用户说发送短信、发消息、发送通知等时：
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,
sourceaddr: $VERIMORSOURCE,
messages: [
{
dest: 905XXXXXXXXX,
msg: 消息内容在此
}
]
}
对于多个接收者，在 dest 字段中用逗号分隔添加：
dest: 905111111111,905222222222
如需定时发送，添加 send_at：
send_at: 2025-06-01 10:00:00
商业消息：
iscommercial: true, iysrecipient_type: BIREYSEL
成功时，API 返回一个活动ID（数字）。将其显示给用户。
土耳其字符说明： 如果消息中包含 Ş ş Ğ ğ ç ı İ 等字符，添加 datacoding: 1。否则使用 datacoding: 0。
2. 查询余额
当用户说余额、信用、还剩多少短信时：
bash
curl -s https://sms.verimor.com.tr/v2/balance?username=$VERIMORUSERNAME&password=$VERIMORPASSWORD
返回的数字是剩余短信额度。以剩余 X 额度的形式显示给用户。
3. 查询发送报告
当用户提供活动ID请求报告时：
bash
curl -s https://sms.verimor.com.tr/v2/status?username=$VERIMORUSERNAME&password=$VERIMORPASSWORD&id=活动ID | jq .
每条消息显示以下字段：
- - dest → 接收号码
- status → DELIVERED（已送达）、NOTDELIVERED（未送达）、WAITING（等待中）、EXPIRED（已过期）等
- doneat → 处理时间
- credits → 消耗的额度
4. 列出已定义发送者名称
当用户说我的发送者名称有哪些、我可以使用哪些发送者名称时：
bash
curl -s https://sms.verimor.com.tr/v2/headers?username=$VERIMORUSERNAME&password=$VERIMORPASSWORD | jq .
5. 取消活动
当用户想要取消一个定时活动时：
bash
curl -s -X POST https://sms.verimor.com.tr/v2/cancel/活动ID \
-H Content-Type: application/json \
-d {username: $VERIMORUSERNAME, password: $VERIMORPASSWORD}
6. 查询黑名单
bash
curl -s https://sms.verimor.com.tr/v2/blacklists?username=$VERIMOR
USERNAME&password=$VERIMORPASSWORD | jq .
7. 添加号码到黑名单
bash
curl -s -X POST https://sms.verimor.com.tr/v2/blacklists?username=$VERIMOR
USERNAME&password=$VERIMORPASSWORD&phones=905XXXXXXXXX
错误状态
| HTTP 状态码 | 含义 |
|---|
| 400 | 无效请求（号码格式、缺少字段） |
| 401 |
用户名或密码错误 |
| 403 | IP 未授权或无权限访问 |
| 429 | 超出速率限制（每分钟 240 次请求） |
如果出现错误，向用户显示错误消息和 HTTP 状态码。
号码格式
所有土耳其号码必须采用 905XXXXXXXXX 格式（开头不带 0 或 +90）。
如果用户提供 05XX 或 +905XX 格式，自动进行修正。
