Help Center RCS-viestit

RCS-viestit

RCS (Rich Communication Services) on seuraavan sukupolven viestipalvelu Android-laitteille, joka tarjoaa multimediaa, interaktiivisuutta ja edistyneitä ominaisuuksia perinteisten tekstiviestien lisäksi.

Yleiskatsaus

RCS tarjoaa parannettuja viestintäominaisuuksia:

  • Multimedia (kuvat, videot, GIF-tiedostot)
  • Interaktiiviset painikkeet ja karusellit
  • Lue kuitit ja kirjoitusilmaisimet
  • Korkeammat merkkirajoitukset (jopa 3072 merkkiä)
  • Parempi toimitusten seuranta
  • Merkitty lähettäjän tunniste

Saatavuus

  • Alusta: vain Android-laitteet
  • Verkko: Edellyttää operaattorin RCS-tukea
  • Varatoimi: Palaa automaattisesti tekstiviestiin, jos RCS ei ole käytettävissä

RCS-perusviesti

RCS-esimerkki

Pyyntö

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

Parametrit

ParametriTyyppiPakollinenKuvaus
”alkaen”merkkijonoKylläAakkosnumeerinen lähettäjän tunnus
”to”merkkijonoKylläVastaanottajan puhelinnumero (E.164)
“tyyppi”merkkijonoKylläAseta arvoksi "rcs"
”teksti”merkkijonoKylläViestin sisältö (jopa 3072 merkkiä)
messageDataesineEiMultimedia ja painikkeet

Viestityypit

Vain teksti

Yksinkertainen tekstiviesti laajennetulla merkkirajoituksella:

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

Teksti + kuva

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

Teksti + kuva + painike

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

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

Teksti + useita painikkeita

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

Näytä useita kohteita vieritettävässä karusellissa:

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

Painikkeiden toiminnot

Avaa URL-osoite

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

Valitse puhelinnumero

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

Lähetä sijainti

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

Kalenteritapahtuma

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

Median tekniset tiedot

Kuvat

  • Muodot: JPEG, PNG, GIF
  • Enimmäiskoko: 2 Mt
  • Suositeltu resoluutio: 800x600 tai 1200x800
  • Kuvasuhde: 16:9 tai 4:3

Videot

  • Formaatit: MP4, 3GP
  • Enimmäiskoko: 10 Mt
  • Enimmäiskesto: 2 minuuttia
  • Suositeltu resoluutio: 1280x720

Ääni

  • Formaatit: MP3, AAC
  • Enimmäiskoko: 5 Mt
  • Enimmäiskesto: 5 minuuttia

Takaisin tekstiviestiin

RCS palaa automaattisesti tekstiviestiin, kun:

  • Vastaanottajalla ei ole RCS:ää
  • RCS on poistettu käytöstä vastaanottavalla laitteella
  • Verkko ei tue 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"
  }
}

Käyttötapaukset

Verkkokauppa

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

Pankkitoiminta

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

Matkailu

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

Parhaat käytännöt

Sisältö

  • ✅ Käytä korkealaatuisia kuvia (vähintään 800x600)
  • ✅ Pidä painikkeen teksti lyhyenä (2-3 sanaa)
  • ✅ Tarjoa tekstiviestillä varasisältöä monipuolista sisältöä varten
  • ✅ Testaa eri Android-laitteilla
  • ❌ Älä ylitä 4-5 painiketta viestiä kohden
  • ❌ Vältä suuria videotiedostoja (>5 Mt)

Media

  • Käytä HTTPS-URL-osoitteita kaikkeen mediaan
  • Optimoi kuvat mobiililaitteille
  • Sisällytä vaihtoehtoinen teksti esteettömyyttä varten
  • Testaa median URL-osoitteet ennen lähettämistä

Painikkeet

  • Enintään 4 painiketta viestiä kohden
  • Selkeä toimintakehotusteksti
  • Testaa kaikki painiketoiminnot
  • Harkitse varatoimia, jos toimintoja ei ole saatavilla

Brändäys

  • Käytä yhdenmukaista lähettäjän tunnusta
  • Liitä mukaan tuotemerkin logo tarvittaessa
  • Säilytä tuotemerkin ääni ja sävy
  • Varmista visuaalinen johdonmukaisuus

Toimituksen tila

RCS tarjoaa parannetun toimitusseurannan:

  • Lähetetty: Viesti lähetetty operaattorille
  • Toimitettu: Viesti toimitettu laitteeseen
  • Luettu: Vastaanottajan avaama viesti
  • Epäonnistui: Toimitus epäonnistui, varatoiminto laukaistiin

Tarkista tila käyttämällä tilapäätepistettä.

Seuraavat vaiheet