Ş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

{        
    "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"                    
                	}
		 ]                
            }            
        }]        
    }    
}    

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

{        
    "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"                    
                }]                
            }            
        }]        
    }    
}   

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ı

Ç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.

{  
    "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"  
                    }]  
                }]  
            }  
        }]  
    }  
}   

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]

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.

{  
    "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"  
            }  
        }]  
    }  
}  

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]

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.

{  
    "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"  
            }  
        }]  
    }  
}  

Kullanıcı Aksiyonları

• Postback Cevabı
• QRCode Cevabı

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]

Sıralı Medya Mesajı

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

{  
    "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"  
                    }]  
                }]  
            }  
        }]  
    }  
} 

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]