Survey: Take a survey and shape our developer materials.

Test devices

Until you launch your agent, it can only communicate with designated test devices. This allows you to test your agent internally while preventing accidental early access to end-users.

To communicate with an RBM agent, a test device needs to be RCS-enabled, but not all Android devices can receive RCS messages by default. You can check the RCS status of your device and, if necessary, enable RCS by configuring your device with pre-release versions of the Messages and Carrier Services apps.

When your device is RCS-enabled, you can send a tester request to invite the device to test your agent. Once the device accepts the request, it can receive and respond to messages from your unlauched agent.

An agent can send 20 tester requests each day with a total maximum of 200 tester requests. If you send tester requests above those limits, the RBM platform returns a 429 RESOURCE_EXHAUSTED response.

Check the RCS status of your device

  1. In the Messages app, tap the button, then tap Settings
  2. Tap Chat features, and find the Status value.

    If Status is Connected, RCS is active on your device.

Next steps

If RCS is active on your device, you're ready to send a tester request. If RCS is inactive on your device, you need to enable RCS on your device before you can begin testing your RBM agent with it.

Enable RCS on your device

To enable RCS on an Android device, you can configure it with pre-release versions of the Messages and Carrier Services apps that connect it to an RCS backend.

Step 1: Sign up for the Messages with RCS partner preview

Sign up for the partner preview with the Messages with RCS Partner Preview form. The preview grants your RBM Platform Google account access to versions of the Messages app and Carrier Services apps that enable RCS. Once you submit the form, it can take up to three business days to give you access to the preview.

Step 2: Get the apps

Once you're in the partner preview, you need to become a tester for each of the apps before you can install them.

  1. Navigate to the opt-in page for the Messages app and then click Become a Tester.
  2. Navigate to the opt-in page for the Carrier Services app and then click Become a Tester.
  3. On your test device, sign in with your RBM Platform Google account.
  4. Visit the Play Store with your RBM Platform Google account, and install the latest versions of Messages and Carrier Services.
  5. In the Settings app on your Android device, clear the Messages app's data and the Carrier Services app's data.
  6. Open the Messages app.
  7. Follow the on-screen prompts to enable RCS.

Step 3: Verify RCS status

  1. In the Messages app, tap the button, then tap Settings
  2. Tap Chat features, and find the Status value.

If Status is Connected, RCS is active on your device. If RCS is inactive, attempt the steps under Get the apps again. If you continue having issues, contact us.

Next steps

Once RCS is active on your device, you're ready to send a tester request.

Send a tester request

To invite an RBM-capable device to become a tester, you send a tester request. If the device accepts the request, your agent can send messages, events, and requests to the device.

If the device isn't RBM-capable, hasn't responded to the tester request, or declines the request, your agent receives a 403 PERMISSION_DENIED error when it attempts to communicate with the device.

Option 1: Send a tester request with the Business Communications Developer Console

  1. Open the Business Communications Developer Console, sign in with your RBM Google account, and click your agent.
  2. In the left navigation, click Devices.
  3. For Add test devices, enter your device's phone number and click Add.

Test devices list details the tester request status for each device that you invite to test your agent.

Option 2: Send a tester request with the RBM API

The following code sends a tester request. For formatting and value options, see phones.testers.

cURL

Node.js

Java

Python

C#

Next steps

After the device accepts the tester request, it's a designated test device for your agent. You can send messages, events, and capability requests to your device to test your agent's functionality and workflows.

Remove a test device

When you remove a test device, the device can no longer receive messages from your unlaunched agent. The RBM platform doesn't delete messages sent by your agent that are in transit to or stored on the test device.

  1. Open the Business Communications Developer Console, sign in with your RBM Google account, and click your agent.
  2. In the left navigation, click Devices.
  3. Locate the device in Test device list, click the menu for that list item, then click Remove device.