Edit agent information

Once you've created an agent, you'll need to define the agent information. This is required before you can submit the agent for verification and launch. You can define and edit the agent information using the API or the Business Communications Developer Console. If you switch to the tile view in the Console, you'll see the status of the agent. If the status is "Incomplete", you haven't provided all the agent information yet.

Note: You cannot edit agent information after your agent's verification information is submitted. See Verify and launch your agent for more information.

Edit your agent's information

Note: You can test your agent without filling out all the details. However, to proceed with launch, you need to fill out all the required information.

The following steps describe how you can edit your agent's information in the Business Communications Developer Console. You can also edit an agent with the RBM Management API.

1. Go to the Console and sign in with your RBM partner Google Account.
2. On the homepage, select your agent from the list.
3. On the sidebar, select Agent information.

4. Provide the following information for your agent. As you enter this information, the agent preview updates automatically.

   Field	Description	Details
   Display name	Name that displays to users when they interact with your agent. Typically, this is the brand name.
   Description	Brief description or tagline of the brand.
   Color	Color of certain elements displayed above the phone number. Use this to match your brand colors.	A minimum 4.5:1 contrast ratio to white (for example, #E91B0C). For more details, see Check the contrast ratio.
   Images	Images for your agent. The banner image displays when a user views your business information, while the logo appears when your agent sends a message to a user.	Banner image: 1440x448 px JPEG file, no larger than 200 kB. Logo: 224x224 px, no larger than 50 kB. In conversations, logos display as 224 px diameter circles. To check if your logo displays well as a circle, use the Logo preview tool.
   Contact	Primary phone number that your users can reach out to in case of queries.	Phone number should be in E.164 format. If your agent's phone number is not in E.164 format (for example, 1800 toll free numbers in India), put in a placeholder phone number and send a request to [e-mail] to change it to the required number. To add multiple phone numbers, click + Add phone number.
   	Label for primary phone number	For example, Customer care number
   	Primary website	To add multiple websites, click + Add website.
   	Label for primary website	For example, ABC website
   	Primary email	To add multiple websites, click + Add website.
   	Label for primary email	For example, Customer care email
   Privacy and terms of service	Your Privacy Policy and Terms of Service URLs.

   Note: Only one form of contact is required, but all three are recommended for the best user experience.

5. Click Save.

The Overview and Agent information pages preview how your agent appears in the Messages app.

Check the contrast ratio

Contrast ratio is a comparison of the contrast and ease of distinguishing between two colors. A high contrast ratio between two colors, such as between a background and text, increases readability in bad lighting and for people with accessibility considerations. WCAG 2.0 defines 4.5:1 as a minimum contrast ratio for text.

You can verify that the agent color you identified has at least a 4.5:1 contrast ratio to white using online tools like the WebAIM Contrast Checker.

Format and crop your logo

A visually appealing logo and hero image can significantly boost your agent's credibility and engagement with users. Ensure your logo is well-formatted and cropped to maintain a professional appearance. Follow these tips to create a good looking logo:

• Logo:

  • Remember that logos are cropped into circles, even if the original image is rectangular. So, always check how your logo appears when cropped into a circle.
  • You don't need to worry about the border around logos, it won't overlap the logo itself.

• Hero images:

  • Remember that hero images, displayed in the agent's Info & options screen, partially overlap with the logo, so design accordingly for a visually pleasing result.
  • Create hero images with a 45:14 aspect ratio to ensure they display correctly alongside the logo.

Logo tips

• Leave sufficient space in your image to account for cropping. When a logo takes up the entire height and width of the image parts of the logo often get cropped out.

  Practice	Good example	Bad example
  Spacing logo
  Spacing logo in cropping circle
  Cropping logo in mock

• Space your logo equidistant from all sides of the image to make sure it displays properly and fully.

  Practice	Good example
  Logo with equal measurements from image borders
  Logo with equal measurements from image borders in cropping circle

• Use a 45:14 aspect ratio for hero images, and keep in mind that the logo partially overlaps the hero image.

  Practice	Good example	Bad example
  Using 45:14 aspect ratio for hero images

• If a hero image doesn't match the correct aspect ratio, parts of the hero image get cropped out. The result is an image that doesn't look good or represent your agent well.

  Practice	Good example	Bad example
  Cropping hero image in mock

• Avoid images with transparencies. Logos without sufficient contrast bend into dark mode backgrounds and suffer reduced visibility. If a transparent background doesn't suit your logo, use a white background.

  Practice	Good example	Bad example
  Encounting dark mode

Resources

Use the following resources to help you design your logo or troubleshoot issues.

• Circle logo template as a base for agent logos you create.

  Download:  [PNG]   [SVG]

  

• Rectangle hero image template as a base for agent hero images you create.

  Download:  [PNG]   [SVG]

  

• Logo preview tool.

  Enter a URL for your logo to see how it would look to users.

  Note: The web server hosting the image must allow images to be embedded on other websites.

Next steps

Now that you've specified the agent information, you can invite test devices, send messages, make other calls from the API reference, or use a sample agent.