Source: https://gitlab-test-org.docs.pageloop.ai/rcs-template

# RCS Templates

When you add the **RCS** channel to a template, the **Create your RCS template** screen opens. The first field, **Type**, decides what you build.

| Type                                                    | Use it to                                                                                                                                          |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Pre-approved RCS Template](#pre-approved-rcs-template) | Send an RCS template you created and got approved in your RCS provider account. Typically used for OTPs and transactional messages, replacing SMS. |
| [Reply: Simple](#reply-simple)                          | Reply with a text, image, video or file message.                                                                                                   |
| [Reply: Card](#reply-card)                              | Reply with an interactive rich card, with media and buttons.                                                                                       |
| [Reply: Carousel](#reply-carousel)                      | Reply with up to 10 rich cards that the user can scroll through.                                                                                   |

## Pre-approved RCS Template

A pre-approved template message has a 160-character limit.

![](assets/rcscreate-v-2-pre-approved-simple.png)

1. **Select the type**

   In **Type**, select **Pre-approved RCS Template**.
2. **Enter the template name**

   In **Template Name**, enter the template name defined in your RCS provider account.
3. **Choose the template type**

   In **Template Type**, select **Simple Text**, **Rich Card** or **Carousel**, matching the template in your provider account.
   #### Simple Text
   ![](assets/rcscreate-v-2-pre-approved-simple.png)
   #### Rich Card
   ![](assets/rcscreate-v-2-rich-card.png)
   #### Carousel
   ![](assets/rcscreate-v-2-carousel.png)
4. **Map the body placeholders (optional)**

   If your template uses variables, map each one under **Body Placeholders**. For each variable defined in the RCS template, enter the **RCS Variable** and either map it to a **Fyno Placeholder** or enter a specific value. Click **Add** to add more rows, or the delete icon to remove one.

> [!NOTE]
>
> The Preview is not available for pre-approved template content.

## Reply: Simple

Under **Content Type**, choose **Text**, **Image**, **Video** or **File**, and add the content. The Preview on the right shows how the message looks.

#### Text

Enter any text, with placeholders. Text messages are limited to 1,000 characters.

![](assets/rcscreate-v-2-simple-text.png)

#### Image

Enter the **Image URL**, or use the upload icon to upload an image. The image size should not exceed 5MB, and it should be a valid HTTPS image URL. The URL can have a maximum of 2,048 characters.

Supported file types: jpeg, jpg, png, gif.

![](assets/rcscreate-v-2-simple-image.png)

#### Video

Enter the **Video URL**, or use the upload icon to upload a video. The video size should not exceed 16MB, and it should be a valid HTTPS video URL. The URL can have a maximum of 2,048 characters.

Supported file types: h263, m4v, mp4, mpeg, webm.

![](assets/rcscreate-v-2-simple-video.png)

#### File

Enter the **File URL**, or use the upload icon to upload a file, and enter a valid **File Name**. The file size should not exceed 100MB, and it should be a valid HTTPS file URL. The URL can have a maximum of 2,048 characters.

Supported file type: pdf.

![](assets/rcscreate-v-2-simple-file.png)

> [!TIP]
>
> **Force Refresh Media**
>
> For Image, Video and File, select **Force Refresh Media** so that if the media at the URL is updated, Fyno always fetches the latest version.

## Reply: Card

Send a preview of your website or product as an interactive rich card. Customers can click the link on the card to view your website or product. Rich cards can include images, buttons and suggested replies and actions. You can always see how your message looks in the Preview on the right.

| Element              | Description                                                                                               | Supported file types               |
| -------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| **Card Title**       | The title of the card.                                                                                    | Not applicable                     |
| **Card Description** | The description of the card.                                                                              | Not applicable                     |
| **Card Orientation** | Choose **Vertical** or **Horizontal**.                                                                    | Not applicable                     |
| **Card Alignment**   | For a horizontal card, choose **Left** or **Right**. For a vertical card, choose **Short** or **Medium**. | Not applicable                     |
| **Image**            | Enter an image URL or upload an image file. The file size is limited to 5MB.                              | JPG, JPEG, GIF                     |
| **Video**            | Enter a video URL or upload a video file. The file size is limited to 16MB.                               | H263, M4V, MP4, MPEG-4, MPEG, WEBM |
| **File**             | Enter a file URL or upload a file. The file size is limited to 100MB.                                     | PDF                                |
| **Buttons**          | Add up to 4 buttons, giving customers quick replies or actions. See [Card buttons](#card-buttons).        | Not applicable                     |

### Card buttons

You can add up to 4 buttons to a card. There are six types of buttons.

#### Quick Reply

- **Button Title**: The text that appears on the button.
- **Button Payload** (optional): The payload sent back to the system when the button is clicked.

![](assets/815-df-37-button-qr.png)

#### Visit Website

- **Button Title**: The text that appears on the button.
- **Button Payload** (optional): The message or payload sent back to the system when the button is clicked.
- **URL**: The webpage or resource users are taken to when they click the button. Use a base URL before adding variables as suffixes. For example, with the base URL `https://www.fyno.io/customers/` followed by `[customer_name]`, the full URL is `https://www.fyno.io/customers/[customer_name]`.

![](assets/51-cd-4-c-6-button-website.png)

#### Phone Number

The phone number must include a leading `+` and the country code, with no separators. For example, `+919999900000`.

#### Date Select

- **Button Title**: The text that appears on the button.
- **Button Payload** (optional): The message or payload sent back to the system when the button is clicked.
- **Start Date**: When the event starts, for example a conference.
- **End Date**: When the event ends.
- **Event Title**: The title of the event.
- **Event Description** (optional): A description of the event.

![](assets/10-a-1-aa-6-button-dates.png)

#### Send Location

Show a location by entering the latitude and longitude, or by entering a query.

- **Latitude**: The latitude in degrees, in the range -90.0 to +90.0. Positive values are north of the equator, negative values are south.
- **Longitude**: The longitude in degrees, in the range -180.0 to +180.0. Positive values are east of the Prime Meridian, negative values are west.
- **Label**: The label of the pin dropped at the location.
- **Query**: A search query. For example, "Wework Co-working Space" shows all Wework co-working locations near the user, while "32, 5th Block, Jaya Nagar, Bengaluru 560041" selects that specific address, regardless of the user's location.

#### Request Location

Asks the user to share their location.

## Reply: Carousel

Add up to 10 rich cards in a carousel. Each card has the same fields as a [rich card](#reply-card).

## How to add dynamic content

You can add dynamic content to your templates using one of the four options below:

- [Placeholders](./template-dynamic-content#placeholders)
- [System Variables](./template-dynamic-content#system-variables)
- [Handlebars](./template-dynamic-content#handlebars)
- [Components](./template-dynamic-content#components)

## Save and go live

Click **Save** to save the template as a **Test** version. Use **Go Live** when you are ready to move your template to the **Live** version.

> [!NOTE]
>
> If template approvals are enabled in your workspace, **Go Live** needs an additional approval step. Choose from your designated approvers, who review and authorize the template changes. See [Approval flow](./approval-flow) for the steps.
