RCS Channel

1. Introduction

In order to set up the RCS channel, every Business Messenger app Instance Owner has to be registered as a partner with RCS Business Messaging.

After registration with RCS Business Messaging (RBM), for every Business Messenger Account an Agent has to be created. An Agent is a conversational entity that interacts with users by sending messages and reacting to users' responses. Users interact with Agents with an RCS-enabled messaging app, such as the Messages app, on their devices. Agents are managed through Google's RBM Admin (Business Communication) Console.

Every RBM Agent has to be launched in order to become publicly available.

2. Setting Up the Channel

The following instructions are for setting up the RCS channel for every Business Messenger Account.

2.1 How to Create an RBM Agent

To create new RCS Business Messaging (RBM) Agent please follow the steps:

  1. Open the Business Communications Developer Console and sign in with your RBM Platform Google account.

  2. Click Create agent.

  3. Enter your Agent's name and region. Region determines where your Agent will operate from and where it will store its data. Click Create agent.

    More details about Agent's Region please find on How to identify the agent's region page.

  4. When your Agent is available, click your Agent's name to see an overview.

    Agent Info Window

    Important: Here you can find Agent ID that you will need later for setting up the RCS channel in the Business Messenger app. You will need also Agent Name and Region.

  5. In the left navigation, click Service account. You need to create a Service Account for each RBM Agent in order to allow API calls authentication.

    Service Account Window

  6. Click Create key, then click Create. Your browser downloads a service account key for your Agent.
    Store you service account key in a secure, private location.

    More details about Agent's Service Account Key, please find on How to create a service account key page.

  7. Until you launch your Agent, it can only communicate with designated test devices.
    In the left navigation select Devices to set up your test device.

    RCS works only on Android phones with Google Messages app as default SMS client.

    To communicate with an unlaunched RBM Agent, a test device needs to be RCS-enabled.

    Details about Test Devices please read on How to set up test devices page.

  8. When you finish testing your Agent, select Launch from the side menu, to launch your Agent.

    Agents launching is very specific for RBM/RCS and related to mobile operators. Please find details on how to launch an Agent on RBM Launch an Agent page.

For details about RCS Agents, please visit RCS Business Messaging Agents page.

2.2 Setting Up the RCS Channel in the Business Messenger App

From the BM Settings Channels page by clicking on the Edit Channels button Edit channels, a new window will be opened where the RCS channel can be set up.

Channel Setup RCS

  • Region - region determines where your Agent operates from and where it stores its data. Select the region you already set when creating the Agent for this BM account.

  • Agent ID - the Agent ID is a string provided by Google RBM console while setting up the Agent. It can be found on the Agent overview page.

  • Agent Name - the Agent Name is a name of your RCS Agent defined in RBM Console.

  • Service Account - Service Account is a .json file provided by RBM console.

By clicking on the Save button, a new pop-up window will appear with additional details for channel setup, Webhook URL and Client Token.

To complete the RCS channel setup, you need to setup manually Webhook URL and Client Token for your RBM Agent.

Open the Business Communications Developer Console and sign in with your RBM Platform Google account.

Select your Agent, and in the left navigation, click Integrations.

Integration Window

Click View subscription, and select Push, then click Save.

Subscription Window

Here you can add Webhook Endpoint URL and Client Token you got from the BM app. By clicking on the Verify button, the RCS channel configuration will be set up.

The RCS channel details will be presented on the Channels page in the Business Messenger app.

Channels

2.3 Setting Up Opt-in/Opt-out Rules

Opt-in/Opt-out Rules should be created in the BM Opt-in/Opt-out Manager>RCS section.

Creating Opt-in/Opt-out rules is very important. Without defined Opt-in/Opt-out rules and configured keywords, no contacts will be stored, since there is no definition about if and how to store new contacts.

If the Easy Dialog default contact list is set in the Default Settings section, which is recommended, all the contacts that send a message to the Business Messenger app by using RCS channel, will be saved in the Easy Dialog default contact list.

There are no QR codes, links or so to access a chat with a business/agent. Agent needs to message users first. Businesses/Agents can reply to any contact.

3. Updating the Channel Configuration

From the BM Settings Channels page by clicking on the Edit Channels button Edit Channel in the top left corner of the screen, opens a window where the Channels configuration data are presented.

Edit Channel Settings

For the RCS channel, you can update an Agent details if it is needed.