Mesaje RCS

RCS (Rich Communication Services) este următoarea generație de mesagerie pentru dispozitivele Android, oferind conținut media bogat, interactivitate și funcții avansate dincolo de SMS-urile tradiționale.

Prezentare generală

RCS oferă capabilități îmbunătățite de mesagerie:

Rich media (imagini, videoclipuri, GIF-uri)
Butoane și carusele interactive
Citiți chitanțe și indicatoare de tastare
Limite mai mari de caractere (până la 3072 de caractere)
Urmărire mai bună a livrărilor
Identificarea expeditorului de marcă

Disponibilitate

Platformă: numai dispozitive Android
Rețea: necesită suport RCS operator
Fallback: Revine automat la SMS dacă RCS nu este disponibil

Mesaj RCS de bază

Exemplu RCS

Solicitare

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

Parametri

Parametru	Tip	Necesar	Descriere
`din`	șir	Da	ID alfanumeric al expeditorului
`la`	șir	Da	Număr de telefon al destinatarului (E.164)
`tip`	șir	Da	Setați la `"rcs"`
`text`	șir	Da	Conținutul mesajului (până la 3072 de caractere)
`messageData`	obiect	Nu	Rich media și butoane

Tipuri de mesaje

Numai text

Mesaj text simplu cu limită extinsă de caractere:

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

Text + Imagine

{
  "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 + Imagine + Buton

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

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

Text + mai multe butoane

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

Afișați mai multe elemente într-un carusel derulabil:

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

Buton Actions

Deschideți adresa URL

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

Formați numărul de telefon

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

Trimiteți locația

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

Eveniment din calendar

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

Specificații media

Imagini

Formate: JPEG, PNG, GIF
Dimensiune maximă: 2MB
Rezoluție recomandată: 800x600 sau 1200x800
Raport de aspect: 16:9 sau 4:3

Videoclipuri

Formate: MP4, 3GP
Dimensiune maximă: 10MB
Durata maximă: 2 minute
Rezoluție recomandată: 1280x720

Audio

Formate: MP3, AAC
Dimensiune maximă: 5MB
Durata maximă: 5 minute

Revenire la SMS

RCS revine automat la SMS atunci când:

Destinatarul nu are RCS
RCS este dezactivat pe dispozitivul destinatar
Rețeaua nu acceptă 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"
  }
}

Cazuri de utilizare

Comerț electronic

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

Bancar

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

Călătorie

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

Cele mai bune practici

Conținut

✅ Utilizați imagini de înaltă calitate (minimum 800x600)
✅ Păstrați textul butonului scurt (2-3 cuvinte)
✅ Oferiți SMS-uri de rezervă pentru conținut bogat
✅ Testați pe diferite dispozitive Android
❌ Nu depășiți 4-5 butoane pe mesaj
❌ Evitați fișierele video mari (>5MB)

Media

Utilizați adrese URL HTTPS pentru toate mediile
Optimizați imaginile pentru mobil
Includeți text alternativ pentru accesibilitate
Testați adresele URL media înainte de a trimite

Butoane

Maxim 4 butoane per mesaj
Ștergeți textul îndemnului
Testați toate acțiunile butoanelor
Luați în considerare acțiunile de rezervă pentru acțiunile indisponibile

Branding

Utilizați ID-ul expeditorului consecvent
Includeți sigla mărcii acolo unde este cazul
Menține vocea și tonul mărcii
Asigurați consistența vizuală

Starea livrării

RCS oferă urmărire îmbunătățită a livrărilor:

Trimis: Mesaj trimis operatorului
Livrat: Mesaj livrat pe dispozitiv
Citește: Mesaj deschis de destinatar
Eșuat: livrarea a eșuat, s-a declanșat alternativ

Verificați starea utilizând status endpoint.

Următorii pași

Mesaje Viber - Mesaje alternative bogate
Mesaje SMS - Mesaje de rezervă
Verificați starea - Urmăriți livrarea
Fallback Strategies - Configurați alternative