RCS Messages

Ang RCS (Rich Communication Services) ay ang susunod na henerasyon ng pagmemensahe para sa mga Android device, na nag-aalok ng rich media, interactivity, at advanced na feature na higit sa tradisyonal na SMS.

Pangkalahatang-ideya

Nagbibigay ang RCS ng mga pinahusay na kakayahan sa pagmemensahe:

Rich media (mga larawan, video, GIF)
Mga interactive na button at carousel
Basahin ang mga resibo at tagapagpahiwatig ng pagta-type
Mas mataas na limitasyon ng character (hanggang 3072 character)
Mas mahusay na pagsubaybay sa paghahatid
May tatak na pagkakakilanlan ng nagpadala

Availability

Platform: Mga Android device lang
Network: Nangangailangan ng suporta sa RCS ng carrier
Fallback: Awtomatikong bumabalik sa SMS kung hindi available ang RCS

Pangunahing Mensahe ng RCS

RCS Example

Kahilingan

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

Mga Parameter

Parameter	Uri	Kinakailangan	Paglalarawan
`mula sa`	string	Oo	Alphanumeric sender ID
`sa`	string	Oo	Numero ng telepono ng tatanggap (E.164)
`uri`	string	Oo	Itakda sa `"rcs"`
`teksto`	string	Oo	Nilalaman ng mensahe (hanggang 3072 character)
`messageData`	bagay	Hindi	Rich media at mga button

Mga Uri ng Mensahe

Text Lang

Simpleng text message na may pinahabang limitasyon ng character:

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

Teksto + Larawan

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

Text + Image + Button

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

Teksto + 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"
    }
  }
}

Teksto + Maramihang Pindutan

{
  "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 Carousel

Magpakita ng maraming item sa isang na-scroll na carousel:

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

Mga Pagkilos ng Pindutan

Buksan ang URL

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

I-dial ang Numero ng Telepono

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

Ipadala ang Lokasyon

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

Kaganapan sa Kalendaryo

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

Mga Detalye ng Media

Mga larawan

Mga Format: JPEG, PNG, GIF
Max na laki: 2MB
Inirerekomendang resolution: 800x600 o 1200x800
Aspect ratio: 16:9 o 4:3

Mga video

Mga Format: MP4, 3GP
Max na laki: 10MB
Max na tagal: 2 minuto
Inirerekomendang resolution: 1280x720

Audio

Mga Format: MP3, AAC
Max na laki: 5MB
Max na tagal: 5 minuto

Fallback sa SMS

Awtomatikong bumabalik ang RCS sa SMS kapag:

Walang RCS ang tatanggap
Hindi pinagana ang RCS sa device ng tatanggap
Hindi sinusuportahan ng network ang RCS

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

Mga Kaso ng Paggamit

E-commerce

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

Pagbabangko

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

Paglalakbay

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

Pinakamahuhusay na Kasanayan

Nilalaman

✅ Gumamit ng mataas na kalidad na mga larawan (800x600 minimum)
✅ Panatilihing maikli ang text ng button (2-3 salita)
✅ Magbigay ng SMS fallback para sa rich content
✅ Pagsubok sa iba't ibang mga Android device
❌ Huwag lumampas sa 4-5 na button sa bawat mensahe
❌ Iwasan ang malalaking video file (>5MB)

Media

Gumamit ng mga URL ng HTTPS para sa lahat ng media
I-optimize ang mga larawan para sa mobile
Isama ang alt text para sa accessibility
Subukan ang mga URL ng media bago ipadala

Mga Pindutan

Pinakamataas na 4 na mga pindutan sa bawat mensahe
I-clear ang text ng call-to-action
Subukan ang lahat ng mga aksyon na pindutan
Isaalang-alang ang fallback para sa mga hindi available na pagkilos

Pagba-brand

Gumamit ng pare-parehong sender ID
Isama ang logo ng brand kung naaangkop
Panatilihin ang boses at tono ng tatak
Tiyakin ang visual consistency

Katayuan ng Paghahatid

Nagbibigay ang RCS ng pinahusay na pagsubaybay sa paghahatid:

Sent: Ipinadala ang mensahe sa carrier
Naihatid: Naihatid ang mensahe sa device
Basahin: Binuksan ng tatanggap ang mensahe
Nabigo: Nabigo ang paghahatid, na-trigger ang fallback

Suriin ang status gamit ang status endpoint.

Mga Susunod na Hakbang

Viber Messages - Alternatibong rich messaging
SMS Messages - Fallback na pagmemensahe
Suriin ang Katayuan - Subaybayan ang paghahatid
Mga Diskarte sa Fallback - I-configure ang mga fallback