İçerik Tipleri

Başlarken

Şablon Medya Mesajları

Çeşitli formatlarda oluşturulan şablonların kullanıcıya gönderilmesini sağlar. Type değeri 13’tür, her bir şablon medya mesajının kendine özel tmmtype değeri vardır. Bunlar:

Tekli Medya Mesajı
Çoklu Medya Mesajı
Anket Medya Mesajı
Hızlı Cevap Medya Mesajı
Sıralı Medya Mesajı

Tekli Medya Mesajı

Bir adet fotoğraf, başlık, açıklama ve seçenekler içerebilen medya mesajıdır. Seçenek göndermek zorunlu değildir. Seçenek gönderildiyse; kullanıcı seçeneklere tıklayıp işlemler gerçekleştirebilir. Bu işlemler başka sayfaya yönlendirme veya servise doğru mesaj gönderme şeklindedir. Seçeneklere tıklama sonrası yapılan işleme göre 2 türe ayrılır:

Kullanıcıdan geri dönüş bekleyen
- Kullanıcı seçeneklere tıkladığında hangi seçeneğe tıkladığının servise iletilmesini sağlayan yapıdır. Mesajın takibi için postbackid, kullanıcının seçtiği seçeneğin takibi içinse payload kullanılır. Kullanıcı kendisine verilen seçeneklerden birine tıkladığında servise mesaj atma işlemini gerçekleştirmiş olur ve ilgili sençeneğin payload’ı servise iletilir.
Kullanıcıdan geri dönüş beklemeyen
- Kullanıcı seçeneklere tıkladığında bir bağlantıya yönlendirilmesi için kullanılır. postbackid ve payload değerleri JSON içerisinde belirtilmez.

Örnek: Kullanıcıdan geri dönüş bekleyen

İstek Özellik

{        
    "txnid": "200",  
    "receiver":  {            
       "type":  2,  
       "address":   "90XXXXXXXXX"        
    },  
     "composition":  {            
        "list":  [{                
           "type":  13,  
           "tmmtype":  0,  
           "singletmm":  {                    
              "title":   "Tekli Şablon Mesajı",  
              "postbackid":   "134",  
              "image":  {                        
                 "url":"https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png",  
                 "ratio": 1.0,  
                 "button":  {                            
                    "name": "İlk tuş",  
                    "url":  "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"                    
                    }                    
                },  
                "buttonlist":  [
		     {                        
                       "type":  1,  
                   	  "name":   "İlk tuş",  
                   	  "payload":   "İstanbul"                    
                   },   
	  	     {                        
                       "type":  1,  
                       "name":   "İkinci tuş",  
                       "payload":   "Ankara"                    
                	}
		 ]                
            }            
        }]        
    }    
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
*singletmm	object
*title	string	Şablon başlığı.
*description	string	Şablon açıklaması. Başlık girilmediyse bu alan zorunludur.
*postbackid	string	Kullanıcının hangi servise cevap verdiğini belirlemeye sağlayan id değeridir. Kullanıcıdan geri dönüş bekleniyorsa zorunludur.
*image	object	Şablonun en üstünde görünen fotoğraf.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*button		Fotoğraf ortasında görünen tuş.
*name	string	Tuşun ismi.
*url	string	Tıklandığında yönlendirilecek adres.
*buttonlist	list	Mesajın altında verilen tuş listesi.
*type	int	Kullanıcıdan geri dönüş beklenip beklenmediğini gösterir. 0 -> Kullanıcadan geri dönüş beklemez. Bu durumda url değerinin verilmesi zorunludur. 1-> Kullanıcıdan geri dönüş bekler. Bu durumda payload değerinin verilmesi zorunludur.
*name	string	Tuşun ekranda görünecek ismi.
*url	string	Kullanıcının tıkladığında yönlendirileceği url. Type değeri 0 ise zorunludur.
*payload	string	Kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. type değeri 1 ise zorunludur.

Örnek: Kullanıcıdan geri dönüş beklemeyen

İstek Özellik

{        
    "txnid":   "200",  
    "receiver":  {            
       "type":  2,  
       "address":   "90XXXXXXXXXX"        
    },  
    "composition":  {            
    "list":  [{                
       "type":  13,  
       "tmmtype":  0,  
       "singletmm":  {                    
          "title": "Tekli Şablon Mesajı",  
          "description": "Kullanıcıdan geri dönüş beklemeyen geri dönüş mesajı denemesi",  
          "image":  {                        
             "url":   "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png",  
             "ratio":  1.0,  
             "button":  {                            
		  "name":   "İlk tuş",  
                 "url":   "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"                        
                    }                    
                },  
           "buttonlist":  [{                        
              "type":  0,  
              "name":   "İlk tuş",  
              "url":   "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"                    
            },   {                        
              "type":  0,  
              "name":   "İkinci tuş",  
              "url":   "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"                    
                }]                
            }            
        }]        
    }    
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
*singletmm	object
*title	string	Şablon başlığı.
*description	string	Şablon açıklaması. Başlık girilmediyse bu alan zorunludur.
*postbackid	string	Kullanıcının hangi servise cevap verdiğini belirlemeye sağlayan id değeridir. Kullanıcıdan geri dönüş bekleniyorsa zorunludur.
*image	object	Şablonun en üstünde görünen fotoğraf.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*button		Fotoğraf ortasında görünen tuş.
*name	string	Tuşun ismi.
*url	string	Tıklandığında yönlendirilecek adres.
*buttonlist	list	Mesajın altında verilen tuş listesi.
*type	int	Kullanıcıdan geri dönüş beklenip beklenmediğini gösterir. 0 -> Kullanıcadan geri dönüş beklemez. Bu durumda url değerinin verilmesi zorunludur. 1-> Kullanıcıdan geri dönüş bekler. Bu durumda payload değerinin verilmesi zorunludur.
*name	string	Tuşun ekranda görünecek ismi.
*url	string	Kullanıcının tıkladığında yönlendirileceği url. Type değeri 0 ise zorunludur.
*payload	string	Kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. type değeri 1 ise zorunludur.

Doğrulamalar

tmmtype değeri null olamaz, boş olamaz. [1054]
singletmm değeri null olamaz, boş olamaz. [1055]
title değeri en fazla 200 karakter uzunluğunda olmalıdır. [1056]
description değeri en fazla 400 karakter uzunluğunda olmalıdır. [1057]
Hem title hem description değeri boş bırakılamaz. [1058]
image değeri için:
- url değeri en fazla 512 karakter uzunluğunda ve dosyanın MimeType’i image/* olmalıdır. [1059]
- ratio değeri null olamaz, boş olamaz. Burada belirtilen değer 0.1 ile 3 aralığında olmalıdır. [1059]
- button değeri için:
  - name değeri null olamaz, boş olamaz, 20 karakterden uzun olamaz. [1060]
  - url değeri null olamaz, boş olamaz, 512 karakterden uzun olamaz. [1060]
buttonlist değeri için:
- en fazla 6 adet eleman içerebilir. [1061]
- type değeri null olamaz, boş olamaz. [1061]
- name değeri null olamaz, boş olamaz. En fazla 20 karakter uzunluğunda olmalıdır. [1061]
- Aynı name veya payload değerine sahip başka eleman bulunamaz. [1061]
- type değeri 0 ise:
  - url değeri null olamaz, boş olamaz. En fazla 512 karakter uzunluğunda olmalıdır. [1061]
- type değeri 1 ise:
  - postbackid null olamaz, boş olamaz. En fazla 100 karakter uzunluğunda olmalıdır. [1069]
  - payload null olamaz, boş olamaz.En fazla 100 karakter uzunluğunda olmalıdır. [1061]

Hata Kodları

resultcode	Açıklama
1054	invalid tmm type
1055	invalid tmm
1056	invalid tmm title
1057	invalid tmm description
1058	missing tmm parameters
1059	invalid tmm image
1060	invalid tmm image button
1061	invalid tmm button list
1069	invalid tmm postbackid

Çoklu Medya Mesajı

Bir adet ana başlık, fotoğraf ve açıklama; bunun altında birden fazla tekli medya mesajı içerebilen medya mesajıdır. İsteğe bağlı olarak ana medya gönderilmez, tekli medya mesajlarını liste halinde göndermek için kullanılır.

İstek Özellik

{  
    "txnid": "14903401-3419034",  
    "receiver": {  
        "type": 2,  
        "address": "905XXXXXXXXX"  
    },  
    "composition": {  
        "list": [{  
            "type": 13,  
            "tmmtype": 1,  
            "multipletmm": {  
                "maintitle": "Sinemalarda Bu Hafta",  
                "maindescription": "Bu hafta 7 film gosterime giriyor...",  
                "postbackid": "ASDF",  
                "mainimage": {  
                    "url": "https://tims.turkcell.com.tr/scontent/caps/336b83ec3785d30c43016d3ac51fec1e.JPG",  
                    "ratio": 1,  
                    "button": {  
                        "name": "İzle",  
                        "url": "https://www.imdb.com/video/imdb/vi2514728473?playlistId=tt3783958&ref_=tt_ov_vi"  
                    }  
                },  
                "sublist": [{  
                    "title": "Efsane Film",  
                    "description": "İşte bu film efsane",  
                    "image": {  
                        "url": "https://tims.turkcell.com.tr/scontent/caps/336b83ec3785d30c43016d3ac51fec1e.JPG",  
                        "ratio": 0.5  
                    },  
                    "buttonlist": [{  
                        "type": "0",  
                        "name": "Fragman izle",  
                        "url": "https://www.imdb.com/video/imdb/vi2514728473?playlistId=tt3783958&ref_=tt_ov_vi"  
                    }, {  
                        "type": "1",  
                        "name": "Linki paylas",  
                        "payload": "Linki paylas"  
                    }]  
                }, {  
                    "title": "Daha efsane film",  
                    "description": "Kuzey Kore bela arıyor...",  
                    "image": {  
                        "url": "https://www.imdb.com/video/imdb/vi2514728473?playlistId=tt3783958&ref_=tt_ov_vi",  
                        "ratio": 0.5  
                    },  
                    "buttonlist": [{  
                        "type": "0",  
                        "name": "İzle",  
                        "url": "https://www.imdb.com/video/imdb/vi2514728473?playlistId=tt3783958&ref_=tt_ov_vi"  
                    }, {  
                        "type": "1",  
                        "name": "Yorumlar",  
                        "payload": "Yorumlar"  
                    }]  
                }]  
            }  
        }]  
    }  
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
*multipletmm	object
*maintitle	string	Şablon grubunun başlığı.
*maindescription	string	Şablon grubunun açıklaması.
*mainimage	object	Şablon grubunun en üstünde görünen fotoğraf.
*postbackid	string	Kullanıcının hangi servise cevap verdiğini belirlemeye sağlayan id değeridir. Kullanıcıdan geri dönüş bekleniyorsa zorunludur.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*button		Fotoğraf ortasında görünen tuş.
*name	string	Tuşun ismi.
*url	string	Tıklandığında yönlendirilecek adres.
*mainbuttonlist	list	Şablon gruplarının en altında verilen tuş listesi.
*type	int	Kullanıcıdan geri dönüş beklenip beklenmediğini gösterir. 0 -> Kullanıcadan geri dönüş beklemez. Bu durumda url değerinin verilmesi zorunludur. 1-> Kullanıcıdan geri dönüş bekler. Bu durumda payload değerinin verilmesi zorunludur.
*name	string	Tuşun ekranda görünecek ismi.
*url	string	Kullanıcının tıkladığında yönlendirileceği url. Type değeri 0 ise zorunludur.
*payload	string	Kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. type değeri 1 ise zorunludur.
*sublist	list	Tekli Medya Mesajlarından oluşan liste. İçerisine singletmm nesneleri verilir.
*title	string	Şablon başlığı.
*description	string	Şablon açıklaması. Başlık girilmediyse bu alan zorunludur.
*image	object	Şablonun en üstünde görünen fotoğraf.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*buttonlist	list	Mesajın altında verilen tuş listesi.
*type	int	Kullanıcıdan geri dönüş beklenip beklenmediğini gösterir. 0 -> Kullanıcadan geri dönüş beklemez. Bu durumda url değerinin verilmesi zorunludur. 1-> Kullanıcıdan geri dönüş bekler. Bu durumda payload değerinin verilmesi zorunludur.
*name	string	Tuşun ekranda görünecek ismi.
*url	string	Kullanıcının tıkladığında yönlendirileceği url. Type değeri 0 ise zorunludur.
*payload	string	Kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. type değeri 1 ise zorunludur.

Doğrulamalar

tmmtype değeri null olamaz, boş olamaz. [1054]
multipletmm değeri null olamaz, boş olamaz. [1055]
maintitle değeri en fazla 200 karakter uzunluğunda olmalıdır. [1056]
maindescription değeri en fazla 400 karakter uzunluğunda olmalıdır. [1057]
mainimage değeri için:
- url değeri en fazla 512 karakter uzunluğunda ve dosyanın MimeType’i image/* olmalıdır. [1059]
- ratio değeri null olamaz, boş olamaz. Burada belirtilen değer 0.1 ile 3 aralığında olmalıdır. [1059]
- button değeri için:
  - name değeri en fazla 20 karakter uzunluğunda olmalıdır. [1060]
  - url değeri en fazla 512 karakter uzunluğunda olmalıdır. [1060]
mainbuttonlist değeri için:
- en fazla 6 adet eleman içerebilir. [1061]
- type değeri null olamaz, boş olamaz. [1061]
- name değeri null olamaz, boş olamaz. En fazla 20 karakter uzunluğunda olmalıdır. [1061]
- type değeri 0 ise:
  - url değeri null olamaz, boş olamaz. En fazla 512 karakter uzunluğunda olmalıdır. [1061]
- type değeri 1 ise:
  - postbackid null olamaz, boş olamaz. En fazla 100 karakter uzunluğunda olmalıdır. [1069]
  - payload null olamaz, boş olamaz.En fazla 100 karakter uzunluğunda olmalıdır. [1061]
sublist değeri için:
- null olamaz, boş olamaz, en az 2 en fazla 5 eleman içerebilir. [1062]
- ilk elemanında başlık varsa sonraki elemanlarında da başlık olmalı, yoksa sonraki elemanlarında da başlık olmamalıdır. [1063]
- ilk elemanında açıklama varsa sonraki elemanlarında da açıklama olmalı, yoksa sonraki elemanlarında da açıklama olmamalıdır. [1063]
- İlk elemanında fotoğraf varsa sonraki elemanlarında da fotoğraf olmalı, yoksa sonraki elemanlarında da fotoğraf olmamalıdır. [1063]
- title değeri en fazla 200 karakter uzunluğunda olmalıdır. [1056]
- description değeri en fazla 400 karakter uzunluğunda olmalıdır. [1057]
- Hem title hem description değeri boş bırakılamaz. [1058]
- image değeri için:
  - url değeri en fazla 512 karakter uzunluğunda ve dosyanın MimeType’i image/* olmalıdır. [1059]
  - ratio değeri null olamaz, boş olamaz. Burada belirtilen değer 0.1 ile 3 aralığında olmalıdır. [1059]
- buttonlist değeri için:
  - en fazla 2 adet eleman içerebilir. [1061]
  - type değeri null olamaz, boş olamaz. [1061]
  - name değeri null olamaz, boş olamaz. En fazla 20 karakter uzunluğunda olmalıdır. [1061]
  - Aynı name veya payload değerine sahip başka eleman bulunamaz. [1061]
  - type değeri 0 ise:
    - url değeri null olamaz, boş olamaz. En fazla 512 karakter uzunluğunda olmalıdır. [1061]
  - type değeri 1 ise:
    - postbackid null olamaz, boş olamaz. En fazla 100 karakter uzunluğunda olmalıdır. [1069]
    - payload null olamaz, boş olamaz.En fazla 100 karakter uzunluğunda olmalıdır. [1061]

Hata Kodları

resultcode	Açıklama
1054	invalid tmm type
1055	invalid tmm
1056	invalid tmm title
1057	invalid tmm description
1058	missing tmm parameters
1059	invalid tmm image
1060	invalid tmm image button
1061	invalid tmm button list
1062	invalid tmm sublist
1063	tmm sublist optionals dont match
1069	invalid tmm postbackid

Anket Medya Mesajı

Anket yapıp cevaplarını almak için kullanılan; bir adet ana fotoğraf, başlık, açıklama, anket sorusu ve anket şıkları içeren şablon türüdür. polltype değeri 0 ise tek cevap verilebilen, 1 ise çok cevap verilebilen anket türü oluşur.

İstek Özellik

{  
    "txnid": "200",  
    "receiver": {  
        "type": 2,  
        "address": "905XXXXXXXX"  
    },  
    "composition": {  
        "list": [{  
            "type": 13,  
            "tmmtype": 2,  
            "polltmm": {  
                "title": "Anket Mesajı",
		  "description": "Hangisini seçiyorsunuz?", 
                "polltype": 0,  
                "image": {  
                    "url": "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png",  
                    "ratio": 1.0  
                },  
                "optionlist": [{  
                    "optionid": 1,  
                    "name": "A şıkkı"  
                }, {  
                    "optionid": 2,  
                    "name": "B şıkkı"  
                }],  
                "pollid": "12341234",  
                "buttonname": "Gönder"  
            }  
        }]  
    }  
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
*polltmm	object
*title	string	Şablon başlığı.
*description	string	Şablon açıklaması. Başlık girilmediyse bu alan zorunludur.
*image	object	Şablonun en üstünde görünen fotoğraf. Title ve description değerleri boş ise image olması zorunludur. Title veya description değerlerinden herhangi biri gönderilmiş ise image değeri zorunlu değildir.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*polltype	int	Anket tipi. Alabileceği değerler: 0 -> Kullanıcı tek seçenek işaretleyebilir. 1 -> Kullanıcı birden fazla seçenek işaretleyebilir.
*pollid	string	Ankete ait id değeri
*pollendtime	date	Anket bitiş tarihi
*optionlist	list	Anket seçenek listesi
*optionid	int	Seçeneğe ait id değeri
*name	string	Seçenek ismi
*buttonname	string	Anketi tamamlama tuşunun ismi

Doğrulamalar

tmmtype değeri null olamaz, boş olamaz. [1054]
poltmm değeri null olamaz, boş olamaz. [1055]
title değeri en fazla 200 karakter uzunluğunda olmalıdır. [1056]
description değeri en fazla 400 karakter uzunluğunda olmalıdır. [1057]
Title, description ve image değerleri aynı anda boş bırakılamaz. En az bir değerin gönderilmesi gerekir. [1058]
image değeri için:
- url değeri en fazla 512 karakter uzunluğunda ve dosyanın MimeType’i image/* olmalıdır. [1059]
- ratio değeri null olamaz, boş olamaz. Burada belirtilen değer 0.1 ile 3 aralığında olmalıdır. [1059]
polltype
pollid değeri null olamaz, boş olamaz, 100 karakterden uzun olamaz. [1064]
pollendtime değeri en as istek yapıldıktan 30 dk sonrası olmalıdır. 30 dk’dan daha kısa süreli anketlere hata dönülür. [1065]
optionlist değeri null olamaz, boş olamaz, 2’den az 6’dan fazla olamaz. [1067]
optionid null olamaz, boş olamaz. name değeri 50 karakterden fazla olamaz. [1067]
buttonname değeri null olamaz, boş olamaz, 40 karakterden fazla olamaz. [1068]

Hata Kodları

resultcode	Açıklama
1054	invalid tmm type
1055	invalid tmm
1056	invalid tmm title
1057	invalid tmm description
1058	missing tmm parameters
1059	invalid tmm image
1060	invalid tmm image button
1064	invalid tmm poll id
1065	invalid tmm poll end date
1067	invalid tmm poll expire time
1068	invalid tmm poll buttonname

Hızlı Cevap Medya Mesajı

Kullanıcıya tıklayabileceği tuş listesi gönderilir. Kullanıcının tıkladığı tuşa ait payload değeri servisinize dönülür.

İstek Özellik

{  
    "txnid": "200",  
    "receiver": {  
        "type": 2,  
        "address": "905XXXXXXXX"  
    },  
    "composition": {  
        "list": [{  
            "type": 13,  
            "tmmtype": 3,  
            "quickreplytmm": {  
                "buttonlist": [{  
                    "type": 1,  
                    "name": "İlk Şehir",  
                    "payload": "İstanbul"  
                }, {  
                    "type": 1,  
                    "name": "İkinci Şehir",  
                    "payload": "Ankara"  
                }],  
                "postbackid": "12343344"  
            }  
        }]  
    }  
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
*quickreplytmm	object
*buttonlist	string
*type	int	Buton tipi. Alabileceği değerler: 1 -> postback 2 -> voicecall 3 -> qrcode 4 -> bipvoicecall 5 -> bipvideocall
*name	string	Kullanıcıya gösterilen seçenek ismidir.
*payload	string	Buton tipi. Alabileceği değerler: Type değeri 1 ise payload; kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. Type değeri 2 ise payload; kullanıcının tıkladığında arayacağı telefon numarasıdır.voicecall
*postbackid	int	Kullanıcının hangi servise cevap verdiğini belirlemeye sağlayan değerdir.

Kullanıcı Aksiyonları

Postback Cevabı

{  
    "sender": "9053XXXXXXXX",  
    "type": "M",  
    "msgid": 89267364,  
    "sendtime": "18.05.2018 15:41:21.175 +0300",  
    "txnid": "Gp2s9-19",  
    "nickname": "cemal",  
    "postback": {  
        "postbackid": "134",  
        "payload": "cemal"  
    },  
    "ctype": "Postback"  
}

QRCode Cevabı

{  
    "sender": "9053XXXXXXXX",  
    "type": "M",  
    "msgid": 89267362,  
    "sendtime": "18.05.2018 15:41:21.175 +0300",  
    "txnid": "Gp2s9-19",  
    "nickname": "cemal",  
    "postback": {  
        "postbackid": "2134",  
        "payload": "qrcode"  
    },  
    "ctype": "qrcode-response"  
}

Doğrulamalar

tmmtype değeri null olamaz, boş olamaz. [1054]
quickreplytmm değeri null olamaz, boş olamaz [1055]
buttonlist değeri null olamaz, boş olamaz, 2’den az 15’den fazla elemana sahip olamaz. [1061]
type değeri 1,2,3,4,5’den farklı değere sahip olamaz. [1061]
name değeri null olamaz, boş olamaz, 20 karakterden fazla olamaz. [1061]
postbackid değeri null olamaz, boş olamaz. En fazla 100 karakter uzunluğunda olmalıdır. [1069]
payload değeri null olamaz, boş olamaz.En fazla 100 karakter uzunluğunda olmalıdır. [1069]
Liste içerisinde aynı name ve aynı payload değerine sahip eleman bulunamaz. [1061]

Hata Kodları

resultcode	Açıklama
1054	invalid tmm type
1055	invalid tmm
1061	invalid tmm button list
1069	invalid tmm postbackid

Sıralı Medya Mesajı

Tekli medya mesajlarını sıralı olarak göstermek için kullanılır.

İstek Özellik

{  
    "txnid": "200",  
    "receiver": {  
        "type": 2,  
        "address": "90XXXXXXXXX"  
    },  
    "composition": {  
        "list": [{  
            "type": 13,  
            "tmmtype": 4,  
            "carouseltmm": {  
                "postbackid": "134134",  
                "list": [{  
                    "title": "Sıralı Medya Mesajı Eleman 1",  
                    "description": "sıralı mesaj 1",  
                    "image": {  
                        "url": "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png",  
                        "ratio": 1.0  
                    },  
                    "buttonlist": [{  
                        "type": 0,  
                        "name": "İlk tuş",  
                        "url": "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"  
                    }]  
                }, {  
                    "title": "Sıralı Medya Mesajı Eleman 2",  
                    "description": "sıralı mesaj 2",  
                    "image": {  
                        "url": "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png",  
                        "ratio": 1.0  
                    },  
                    "buttonlist": [{  
                        "type": 0,  
                        "name": "İkinci tuş",  
                        "url": "https://timsac.turkcell.com.tr/scontent/p2p/14112016/11/P1e646f5c03a7b4b44f6da1329ac218e322da72356e79e5116dff86e3fc255a228.png"  
                    }]  
                }]  
            }  
        }]  
    }  
}

Özellik	Değer	Açıklama
*txnid	string	isteğe ait id değeri
*receiver	object
*type	int	Mesaj gönderilecek kullanıcının adres türü. Alabileceği değerler: 0 -> Hash (karıştırılmış) adres 1 -> Servisi takip eden tüm adresler 2 -> MSISDN (açık numara)
*address	string	type ile belirtilen türdeki adres. type 0 ise address karıştırılmış formattadır, bipussu tarafından verilen değer girilir. type 1 ise address değeri istek içerisinde yer almamalıdır. type 2 ise address 905XXXXXXXXX formatında verilir.
*composition	object
*list	list	Gönderilecek mesaj listesi. En az 1 tane eklenmelidir.
*type	int	Mesaj tipi. Alabileceği değerler: 0 – Metin 2 – Fotoğraf 3 – Ses 4 – Video 5 – Çıkartma 6 – Caps 7 – Konum 9 – Bitiş Çizgisi 10 – Kontak 13 – Şablon Medya Mesajı 14 – Doküman
*tmmtype	int	Şablon mesaj tipi. Alabileceği değerler: 0 -> Tekli Medya Mesajı 1 -> Çoklu Medya Mesajı 2 -> Anket Medya Mesajı 3 -> Hızlı Cevap Medya Mesajı 4 -> Sıralı Medya Mesajı
** carouseltmm	object
*postbackid		Kullanıcının hangi servise cevap verdiğini belirlemeye sağlayan id değeridir. Kullanıcıdan geri dönüş bekleniyorsa zorunludur.
*list	list	Tekli Medya Mesajlarından oluşan liste. İçerisine singletmm nesneleri verilir.
*title	string	Şablon başlığı.
*description	string	Şablon açıklaması. Başlık girilmediyse bu alan zorunludur.
*image	object	Şablonun en üstünde görünen fotoğraf.
*url		Tıklandığında yönlendirilecek adres.
*ratio		Yükseklik/genişlik oranı.
*buttonlist	list	Mesajın altında verilen tuş listesi.
*type	int	Kullanıcıdan geri dönüş beklenip beklenmediğini gösterir. 0 -> Kullanıcadan geri dönüş beklemez. Bu durumda url değerinin verilmesi zorunludur. 1-> Kullanıcıdan geri dönüş bekler. Bu durumda payload değerinin verilmesi zorunludur.
*name	string	Tuşun ekranda görünecek ismi.
*url	string	Kullanıcının tıkladığında yönlendirileceği url. Type değeri 0 ise zorunludur.
*payload	string	Kullanıcının tıkladığı seçeneğe ait servisinize geri dönüş değeridir. type değeri 1 ise zorunludur.

Doğrulamalar

tmmtype değeri null olamaz, boş olamaz. [1054]
carouseltmm değeri null olamaz, boş olamaz. [1055]
list değeri için:
- null olamaz, boş olamaz, en az 2 en fazla 15 eleman içerebilir. [1062]
- ilk elemanında başlık varsa sonraki elemanlarında da başlık olmalı, yoksa sonraki elemanlarında da başlık olmamalıdır. [1063]
- ilk elemanında açıklama varsa sonraki elemanlarında da açıklama olmalı, yoksa sonraki elemanlarında da açıklama olmamalıdır. [1063]
- İlk elemanında fotoğraf varsa sonraki elemanlarında da fotoğraf olmalı, yoksa sonraki elemanlarında da fotoğraf olmamalıdır. [1063]
- İlk elemandaki tuş sayısı kadar sonraki elemanlarda tuş sayısı olabilir. [1063]
- title değeri en fazla 200 karakter uzunluğunda olmalıdır. [1056]
- description değeri en fazla 400 karakter uzunluğunda olmalıdır. [1057]
- Hem title hem description değeri boş bırakılamaz. [1058]
- image değeri için:
  - url değeri en fazla 512 karakter uzunluğunda ve dosyanın MimeType’i image/* olmalıdır. [1059]
  - ratio değeri null olamaz, boş olamaz. Burada belirtilen değer 0.1 ile 3 aralığında olmalıdır. [1059]
- buttonlist değeri için:
  - en fazla 2 adet eleman içerebilir. [1061]
  - type değeri null olamaz, boş olamaz. [1061]
  - name değeri null olamaz, boş olamaz. En fazla 20 karakter uzunluğunda olmalıdır. [1061]
  - Aynı name veya payload değerine sahip başka eleman bulunamaz. [1061]
  - type değeri 0 ise:
    - url değeri null olamaz, boş olamaz. En fazla 512 karakter uzunluğunda olmalıdır. [1061]
  - type değeri 1 ise:
    - postbackid null olamaz, boş olamaz. En fazla 100 karakter uzunluğunda olmalıdır. [1069]
    - payload null olamaz, boş olamaz.En fazla 100 karakter uzunluğunda olmalıdır. [1061]

Hata Kodları

resultcode	Açıklama
1054	invalid tmm type
1055	invalid tmm
1057	invalid tmm description
1058	missing tmm parameters
1059	invalid tmm image
1061	invalid tmm button list
1063	tmm sublist optionals dont match
1069	invalid tmm button list

BiP

BiP Web
İndir
Marka
Güvenlik
Geliştiriciler

ŞİRKET

Hakkımızda
BiP Keşfet İş Birlikleri
Kuruma Özel İletişim Platformu

BiP İndir

Mac/PC
Android
iPhone
App Gallery

Diğer

Kullanım Koşulları
Kalite Politikası
Gizlilik Politikası
Çerez Politikası
İş Sürekliliği Politikası
Bilgi Güvenliği Politikası

Gizlilik Politikası Çerez Politikası Kullanım Koşulları