Gelen SMS (Inbound SMS)

Hesabınıza atanan kısa numara veya uzun numara üzerinden müşterilerinizin gönderdiği SMS’leri iki yöntemle alabilirsiniz: Push (Webhook) veya GET ile sorgulama.

Kullanım Senaryoları

Senaryo	Nasıl Çalışır?
Kampanya katılımı	“KATIL” yaz, kısa numaraya gönder
Abonelikten çıkış	“İPTAL” yaz, kısa numaraya gönder
Anket / oylama	Seçenek kodu SMS ile alınır
Bilgi sorgulama	Anahtar kelimeye göre otomatik yanıt döner

Push (Webhook) Yöntemi

Hesabınıza mesaj geldiği anda Verimor, OİM’de tanımladığınız URL’ye POST isteği gönderir.

OİM’de URL tanımlamak için: SMS Ayarlarım → Gelen SMS Push URL

POST https://sizin.adresiniz.com.tr/gelen_sms
Content-Type: application/json

[
  {
    "message_id": 1234,
    "type": "inbound",
    "received_at": "2025-06-01 09:00:00",
    "network": "TURKCELL",
    "source_addr": "905001234567",
    "destination_addr": "4609",
    "keyword": "VERIMOR",
    "content": "VERIMOR deneme"
  }
]

Alan	Açıklama
`type`	Her zaman `inbound`
`message_id`	Mesaja atanan tekil ID
`received_at`	Mesajın alındığı tarih-saat
`network`	Gönderenin operatörü: `TURKCELL`, `VODAFONE`, `TTMOBIL`
`source_addr`	Mesajı gönderen numara
`destination_addr`	Verimor’daki alıcı numara veya kısa numara (örn. `4609`)
`keyword`	Ortak kısa numaralarda ayırt edici anahtar kelime. Doğrudan numaranıza gelenlerde boştur.
`content`	Gelen mesajın tam içeriği
`created_at`	Kaydın oluşturulma zamanı (push yönteminde dönmez)

GET ile Sorgulama

GET https://sms.verimor.com.tr/v2/inbound_messages

Parametre	Zorunlu	Açıklama
`username`	Evet	API kullanıcı adı
`password`	Evet	API şifresi
`from_time`	Hayır	Başlangıç tarihi: `2025-06-01 09:00:00`
`to_time`	Hayır	Bitiş tarihi: `2025-06-01 12:00:00`
`greater_than`	Hayır	Verilen `message_id`’den büyük mesajları getirir — sayfalama için kullanılır, her seferinde 100 mesaj döner

# Tarih aralığına göre
curl "https://sms.verimor.com.tr/v2/[email protected]&password=api_sifreniz&from_time=2025-06-01+09:00:00&to_time=2025-06-01+12:00:00"

# Sayfalama ile
curl "https://sms.verimor.com.tr/v2/[email protected]&password=api_sifreniz&greater_than=1234"

Yanıt

[
  {
    "message_id": 1234,
    "created_at": "2025-06-01T09:00:01.000+03:00",
    "received_at": "2025-06-01T09:00:00.000+03:00",
    "network": "TURKCELL",
    "source_addr": "905001234567",
    "destination_addr": "4609",
    "keyword": "VERIMOR",
    "content": "VERIMOR deneme"
  },
  {
    "message_id": 1235,
    "created_at": "2025-06-01T10:00:01.000+03:00",
    "received_at": "2025-06-01T10:00:00.000+03:00",
    "network": "VODAFONE",
    "source_addr": "905007654321",
    "destination_addr": "908501234567",
    "keyword": "",
    "content": "Siparişim ne zaman gelecek?"
  }
]

Hiç mesaj yoksa boş dizi [] döner.

Sıkça Sorulan Sorular

Hangi numara üzerinden gelen SMS alınır? Kısa numara (4 haneli, örn. 4609) veya uzun numara tahsis edilir. Detay için satış ekibiyle iletişime geçin.

Otomatik yanıt kurabilir miyim? Evet. Webhook entegrasyonu ile gelen mesajın içeriğine göre otomatik yanıt tetikleyebilirsiniz.

OİM üzerinden görebilir miyim? Evet. OİM → SMS → Gelen SMS sayfasından tüm mesajlar listelenir ve dışa aktarılabilir.