Bulutfon SMS hizmeti sahibiyseniz Bulutfon API üzerinden SMS gönderme işlemi oldukça basittir. Bu yazımızda SMS gönderme işleminin Ruby dili ile nasıl yapılacağını ufak bir örnek üzerinden inceleyeceğiz.

API Anahtarı edinme

Bulutfon API’yi kullanabilmeniz için bir erişim jetonuna (access_token) ihtiyacınız var. Bu access_token’a bulutfon paneliniz Ayarlar > API Kullanıcıları menüsünden ulaşabilirsiniz.

Bulutfon API V2 Token alma
Api anahtarınızı alma

Bulutfon API SMS Endpointi

Bulutfon API ile SMS gönderebilmeniz için gerekli bazı alanlarımız bulunmakta. Bu alanları Bulutfon API Sms gönderme linki üzerinden ulaşabilirsiniz ancak bu yazımızda bu gerekli alanları aşağıdaki tabloya tekrar ekliyorum.

titleSMS’in gönderilmesini istediğiniz başlık. Sadece hesabınızdaki onaylı SMS başlıklarını kullanabilirsiniz.
contentGönderilmek istenen mesaj içeriği
receiversAlıcı listesi. Array formatında olmalıdır. Limit: 5000
reject_linkSizden SMS almak istemeyen kişiler için SMS içeriğine, kişinin numarasını SMS kara listesine ekleyen bir bağlantı ekler. Kişiler bağlantıya tıkladıklarında, numaraları SMS kara listesine eklenir. Örnek bağlantı: http://bl.tc/3xh5
send_dateGönderilmek istenen mesaj ileri tarihli ise bu alanda gönderilmek istenen zaman belirtilmelidir. Boş gönderilmesi halinde sms anında gönderilir.

Ruby ile SMS gönderimi

Ruby için REST isteklerini çeşitli yollarla yapabilirsiniz, akla gelen ilk method Ruby standart kütüphanesi olan net/http kullanmak olsada ben REST ve HTTP istekleri için bence en basit yol olan rest-client gem’ini kullanacağım.

SMS göndermek için http://api.bulutfon.com/v2/sms/messages adresine yukarıdaki tablomuzda yer alan gerekli alanları ile birlikte API anahtarımızı göndermemiz gerekmekte.

require 'rest-client'

url = 'http://api.bulutfon.com/v2/sms/messages?apikey=<API ANAHTARINIZINI YAZIN>'

API anahtarınızı göndereceğiniz endpointe query parametersi olarak ekleyebilirsiniz. Sonrasında gönderilecek veriyi oluşturalım.

payload = {
  title: "FIRMA",
  content: "SMS içeriğiniz burada yer alacak.",
  receivers: ["905xxxxxxxxx"],
  reject_link: true
}

İleri tarihli bir SMS yollamak istemediğimden send_date alanını eklemiyorum ve reject_link ile SMS almak istemeyen müşterileriniz için ufak bir bağlantıyı SMS mesajı sonuna ekleyelim.

response = RestClient.post(url, payload)

puts response

Bu noktada dönen veriyi ekrana yazdırdık. Dilerseniz json gemini kullanarak dönen veriyi parse edebilirsiniz.

require 'json'

...

response = RestClient.post(url, payload)

result = JSON.parse(response)

REST yapısını kullanan Bulutfon API ile SMS gönderiminde gördüğünüz gibi çağrı yönetimi, faks gönderimi gibi birçok servisimizide oldukça basit bir şekilde kullanabilirsiniz.

require 'json' 
require 'rest-client' 

url = 'http://api.bulutfon.com/v2/sms/messages?apikey=APIKEY' 

payload = { 
  title: "FIRMA", 
  content: "Hesabınıza girişte kullanacağınız kod: xxxx", 
  receivers: ["905xxxxxxxx"], 
  reject_link: true 
} 

response = RestClient.post(url, payload) puts JSON.parse(response)
Yazar

Yorum Yap