RCS rich cards

A rich card combines media, a title, a description and action buttons in one message. Use it for product highlights, promotions and bookings.

At a glance

At least one of title, description or media is required. An empty card cannot be sent.

Card types in the API

Generic, without media, reply, dial, location, agenda, openUrl and openUrl with web view. Agenda and web view are not available in all countries. Suggested actions and replies can be combined within one card.

Create a rich card in the Campaigns app

1. Open the Campaigns app from the nine-tile menu and click Create new.

2. Choose a template or a blank campaign.

3. Select the channel RCS and message type Card.

4. Fill in title and description and add media.

5. Choose orientation and media height.

6. Add buttons if needed.

7. Check the phone preview.

8. Set a fallback message, the opt-out toggle if required in your country, and the send time.

Fallback message

If the device or carrier does not support RCS, the recipient gets a simplified plain-text version, optionally with a URL. Keep it short and actionable and add UTM parameters (source, medium, campaign) to the URL to measure clicks.

Sending options

• Select the time zone of your audience.

• Send immediately or schedule a date and time.

• Optionally spread delivery in batches over a period of time.

Best practices

Use a 3:2 image ratio (for example 1,620 x 1,080 px) and keep key content about 5% from the edges, because iPhone and Android display cards slightly differently. See the RCS design guidelines.

API example

{
  "messages": {
    "msg": [{
      "from": "RCS Sender Name",
      "allowedChannels": ["RCS"],
      "to": [{ "number": "0031612345678" }],
      "body": { "content": "" },
      "richContent": {
        "conversation": [{
          "header": "Card title",
          "text": "Card description",
          "cardOrientation": "HORIZONTAL",
          "media": {
            "mediaHeight": "small",
            "mediaName": "image.jpg",
            "mediaUri": "https://example.com/image.jpg",
            "mimeType": "image/jpg"
          },
          "suggestions": [
            { "action": "Reply", "label": "Email me" },
            { "action": "Openurl", "label": "Go to website", "url": "https://www.example.com" }
          ]
        }]
      }
    }]
  }
}

Related

• RCS carousels

• RCS billing and pricing

• Developer documentation: rich cards

E-learning video

For a walkthrough in the Campaigns app, watch the e-learning video on creating rich cards.