Mesazhe RCS

RCS (Rich Communication Services) është gjenerata e ardhshme e mesazheve për pajisjet Android, që ofron media të pasur, interaktivitet dhe veçori të avancuara përtej SMS-ve tradicionale.

Përmbledhje

RCS ofron aftësi të përmirësuara të mesazheve:

Media e pasur (imazhe, video, GIF)
Butonat dhe karuselet interaktive
Lexoni faturat dhe treguesit e shtypjes
Kufij më të lartë të karaktereve (deri në 3072 karaktere)
Ndjekje më e mirë e dorëzimit
Identifikimi i dërguesit të markës

Disponueshmëria

Platforma: Vetëm pajisjet Android
Rrjeti: Kërkon mbështetje RCS të operatorit
Kthesë: Kthehet automatikisht në SMS nëse RCS nuk disponohet

Mesazhi bazë RCS

Shembull RCS

Kërkesë

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

Parametrat

Parametri	Lloji	Kërkohet	Përshkrimi
"nga"	varg	Po	ID-ja e dërguesit alfanumerik
`për`	varg	Po	Numri i telefonit të marrësit (E.164)
'lloj'	varg	Po	Cakto në `"rcs"`
`tekst`	varg	Po	Përmbajtja e mesazhit (deri në 3072 karaktere)
`Të dhënat e mesazhit`	objekt	Jo	Media dhe butona të pasura

Llojet e mesazheve

Vetëm tekst

Mesazh i thjeshtë me tekst me kufi të zgjatur të karaktereve:

KODI_BLOCK_1

Tekst + Imazhi

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

Tekst + Imazh + Butoni

KODI_BLOCK_3

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

Tekst + Butona të Shumëfishtë

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

Shfaq artikuj të shumtë në një karusel të lëvizshëm:

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

Veprimet e butonit

Hap URL

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

Telefononi numrin e telefonit

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

Dërgo vendndodhjen

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

Ngjarja e kalendarit

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

Specifikimet e medias

Imazhe

Formatet: JPEG, PNG, GIF
Madhësia maksimale : 2 MB
Rezolucioni i rekomanduar: 800x600 ose 1200x800
Raporti i pamjes: 16:9 ose 4:3

Video

Formatet: MP4, 3GP
Madhësia maksimale : 10 MB
Kohëzgjatja maksimale: 2 minuta
Rezolucioni i rekomanduar: 1280x720

Audio

Formatet: MP3, AAC
Madhësia maksimale: 5MB
Kohëzgjatja maksimale: 5 minuta

Rikthim në SMS

RCS kthehet automatikisht në SMS kur:

Marrësi nuk ka RCS
RCS është çaktivizuar në pajisjen marrës
Rrjeti nuk e mbështet 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"
  }
}

Rastet e përdorimit

Tregti elektronike

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

Bankare

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

Udhëtim

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

Praktikat më të mira

Përmbajtja

✅ Përdorni imazhe me cilësi të lartë (minimumi 800x600)
✅ Mbaje tekstin e butonit të shkurtër (2-3 fjalë)
✅ Siguroni kthim SMS për përmbajtje të pasur
✅ Testoni në pajisje të ndryshme Android
❌ Mos i kaloni 4-5 butona për mesazh
❌ Shmangni skedarët e mëdhenj video (> 5 MB)

Media

Përdorni URL HTTPS për të gjitha mediat
Optimizoni imazhet për celular
Përfshi tekst alternativ për aksesueshmëri
Testoni URL-të e medias përpara se të dërgoni

Butonat

Maksimumi 4 butona për mesazh
Pastro tekstin e thirrjes për veprim
Testoni të gjitha veprimet e butonit
Merrni parasysh kthimin për veprimet e padisponueshme

Branding

Përdorni ID të qëndrueshme të dërguesit
Përfshi logon e markës aty ku është e përshtatshme
Ruani zërin dhe tonin e markës
Siguroni qëndrueshmëri vizuale

Statusi i dorëzimit

RCS ofron gjurmim të përmirësuar të dorëzimit:

Dërguar: Mesazh i dërguar operatorit
Dorëzuar: Mesazhi i dorëzuar në pajisje
Lexo: Mesazhi u hap nga marrësi
Dështoi: Dorëzimi dështoi, kthimi u aktivizua

Kontrollo statusin duke përdorur status endpoint.

Hapat e ardhshëm

Viber Messages - Mesazhe alternative të pasura
Mesazhet SMS - Mesazhe mbrapa
Kontrollo statusin - Gjurmo dorëzimin
Strategjitë e kthimit - Konfiguro kthimet