RCS Mesajları

RCS (Zengin İletişim Hizmetleri), geleneksel SMS'in ötesinde zengin medya, etkileşim ve gelişmiş özellikler sunan, Android cihazlara yönelik yeni nesil mesajlaşmadır.

Genel Bakış

RCS gelişmiş mesajlaşma yetenekleri sağlar:

Zengin medya (resimler, videolar, GIF'ler)
Etkileşimli düğmeler ve atlıkarıncalar
Makbuzları ve yazma göstergelerini okuyun
Daha yüksek karakter sınırları (3072 karaktere kadar)
Daha iyi teslimat takibi
Markalı gönderenin kimliği

Kullanılabilirlik

Platform: Yalnızca Android cihazlar
Ağ: Operatör RCS desteği gerektirir
Geri çekilme: RCS kullanılamadığında otomatik olarak SMS'e geri döner

Temel RCS Mesajı

RCS Örneği

Talep

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your RCS message text with rich formatting"
}

Parametreler

Parametre	Tür	Gerekli	Açıklama
'dan'	dize	Evet	Alfasayısal gönderen kimliği
'e'	dize	Evet	Alıcının telefon numarası (E.164)
'tür'	dize	Evet	`"rcs"` olarak ayarla
'metin'	dize	Evet	Mesaj içeriği (3072 karaktere kadar)
'mesajVerileri'	nesne	Hayır	Zengin medya ve düğmeler

Mesaj Türleri

Yalnızca Metin

Genişletilmiş karakter sınırına sahip basit kısa mesaj:

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Welcome to our service! RCS allows us to send much longer messages with rich formatting and interactive elements."
}

Metin + Resim

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg",
      "height": 600,
      "width": 800
    }
  }
}

Metin + Resim + Düğme

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Summer Sale - Up to 50% off!",
  "messageData": {
    "media": {
      "url": "https://example.com/sale-banner.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/sale"
        }
      }
    ]
  }
}

Metin + Video

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Watch our product demo",
  "messageData": {
    "media": {
      "url": "https://example.com/demo.mp4",
      "type": "video/mp4",
      "thumbnail": "https://example.com/thumbnail.jpg"
    }
  }
}

Metin + Çoklu Düğmeler

{
  "from": "YourService",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order #12345 is ready for pickup",
  "messageData": {
    "buttons": [
      {
        "text": "Track Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/12345"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      },
      {
        "text": "Cancel Order",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/cancel/12345"
        }
      }
    ]
  }
}

RCS Atlıkarınca

Kaydırılabilir bir atlıkarıncada birden çok öğeyi görüntüleyin:

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Featured Products",
  "messageData": {
    "carousel": {
      "cards": [
        {
          "title": "Product A",
          "description": "Premium quality product",
          "media": {
            "url": "https://example.com/product-a.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a"
              }
            },
            {
              "text": "Details",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-a/details"
              }
            }
          ]
        },
        {
          "title": "Product B",
          "description": "Best seller",
          "media": {
            "url": "https://example.com/product-b.jpg",
            "type": "image/jpeg"
          },
          "buttons": [
            {
              "text": "Buy Now",
              "action": {
                "type": "openUrl",
                "url": "https://example.com/product-b"
              }
            }
          ]
        }
      ]
    }
  }
}

Düğme Eylemleri

URL'yi aç

{
  "text": "Visit Website",
  "action": {
    "type": "openUrl",
    "url": "https://example.com"
  }
}

Telefon Numarasını Çevir

{
  "text": "Call Us",
  "action": {
    "type": "dial",
    "phoneNumber": "+380XXXXXXXXX"
  }
}

Konumu Gönder

{
  "text": "Share Location",
  "action": {
    "type": "shareLocation"
  }
}

Takvim Etkinliği

{
  "text": "Add to Calendar",
  "action": {
    "type": "createCalendarEvent",
    "title": "Appointment",
    "startTime": "2025-01-25T14:00:00Z",
    "endTime": "2025-01-25T15:00:00Z"
  }
}

Medya Özellikleri

Görseller

Biçimler: JPEG, PNG, GIF
Maksimum boyut: 2MB
Önerilen çözünürlük: 800x600 veya 1200x800
En boy oranı: 16:9 veya 4:3

Videolar

Biçimler: MP4, 3GP
Maksimum boyut: 10MB
Maksimum süre: 2 dakika
Önerilen çözünürlük: 1280x720

Ses

Biçimler: MP3, AAC
Maksimum boyut: 5MB
Maksimum süre: 5 dakika

SMS'e geri dönüş

RCS aşağıdaki durumlarda otomatik olarak SMS'e geri döner:

Alıcının RCS'si yok
Alıcı cihazda RCS devre dışı bırakıldı
Ağ RCS'yi desteklemiyor

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Check out our new product!",
  "messageData": {
    "media": {
      "url": "https://example.com/product.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Shop Now",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/shop"
        }
      }
    ]
  },
  "fallback": {
    "type": "sms",
    "text": "Check out our new product! Visit: https://example.com/shop"
  }
}

Kullanım Durumları

E-ticaret

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your order has been shipped!",
  "messageData": {
    "media": {
      "url": "https://example.com/package.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Track Package",
        "action": {
          "type": "openUrl",
          "url": "https://example.com/track/ABC123"
        }
      },
      {
        "text": "Contact Support",
        "action": {
          "type": "dial",
          "phoneNumber": "+380XXXXXXXXX"
        }
      }
    ]
  }
}

Bankacılık

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Low balance alert: Your account balance is $50",
  "messageData": {
    "buttons": [
      {
        "text": "View Balance",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/balance"
        }
      },
      {
        "text": "Transfer Money",
        "action": {
          "type": "openUrl",
          "url": "https://bank.example.com/transfer"
        }
      }
    ]
  }
}

Seyahat

{
  "from": "YourAirline",
  "to": "+380XXXXXXXXX",
  "type": "rcs",
  "text": "Your flight is departing in 3 hours",
  "messageData": {
    "media": {
      "url": "https://example.com/boarding-pass.jpg",
      "type": "image/jpeg"
    },
    "buttons": [
      {
        "text": "Check-in",
        "action": {
          "type": "openUrl",
          "url": "https://airline.example.com/checkin"
        }
      },
      {
        "text": "Add to Calendar",
        "action": {
          "type": "createCalendarEvent",
          "title": "Flight Departure",
          "startTime": "2025-01-25T10:00:00Z"
        }
      }
    ]
  }
}

En İyi Uygulamalar

İçerik

✅ Yüksek kaliteli görseller kullanın (minimum 800x600)
✅ Düğme metnini kısa tutun (2-3 kelime)
✅ Zengin içerik için SMS geri dönüşü sağlayın
✅ Farklı Android cihazlarda test edin
❌Mesaj başına 4-5 butonu aşmayın
❌ Büyük video dosyalarından kaçının (>5MB)

Medya

Tüm medya için HTTPS URL'lerini kullanın
Mobil cihazlar için görüntüleri optimize edin
Erişilebilirlik için alternatif metin ekleyin
Göndermeden önce medya URL'lerini test edin

Düğmeler

Mesaj başına maksimum 4 düğme
Harekete geçirici mesaj metnini temizleyin
Tüm düğme eylemlerini test edin
Kullanılamayan eylemler için geri dönüşü düşünün

Markalaşma

Tutarlı gönderen kimliği kullanın
Uygun olan yerlerde marka logosunu ekleyin
Markanın sesini ve tonunu koruyun
Görsel tutarlılığı sağlayın

Teslimat Durumu

RCS gelişmiş teslimat takibi sağlar:

Gönderildi: Mesaj operatöre gönderildi
İletildi: Mesaj cihaza iletildi
Oku: Mesaj alıcı tarafından açıldı
Başarısız: Teslimat başarısız oldu, geri dönüş tetiklendi

Durum uç noktasını kullanarak durumu kontrol edin.

Sonraki Adımlar

Viber Mesajları - Alternatif zengin mesajlaşma
SMS Mesajları - Yedek mesajlaşma
Durumu Kontrol Et - Teslimatı takip et
Geri Dönüş Stratejileri - Geri dönüşleri yapılandırın