Modern business applications require agent integrations on web/mobile devices to enable seamless customer communication via SMS/chats.
The Kore.ai XO Platform now helps you create rich and asynchronous messaging experiences within apps and during calls through the GBM channel enablement. This feature helps seamlessly integrate real-time business agents to Virtual Assistants through your own account or your GBM Partner account.
Google Business Messaging (GBM) is a mobile conversational channel that combines digital customer touchpoints or entry points on Google Maps, Search, and brand websites.
How does it work?
When Google Business Messaging is configured as a Channel on the XO Platform, the conversations between the customers and brands is enabled by creating agents. You can manage agents with either your own account or a GBM Partner Account. The process to create an agent differs in each scenario.
- If you have a GBM Partner Account, the XO Platform registers each Business as a partner. You can enable conversations for brands you manage by creating Business Messages agents directly on GBM Developer Console.
- If you have your own account, you can enable conversations for brands you manage by creating Business Messages agents using Business Communications APIs.
Customers can send messages to your brand or its locations through these agents.
With Business Messages, you can place messaging buttons for brands managed by Kore AI within organic Google search results.
The Messaging Flow
- When a customer clicks the button, a conversation is initiated with the brand’s virtual agent on the device.
- Google delivers the message defined as a JSON payload to the Webhook that Kore.ai provides.
- The agent uses this Webhook and the Conversational Agent API to receive and respond to the customer’s messages.
Set up on the GBM Channel
The important steps to set up the GBM channel are summarized below:
- Creating a Google Cloud Platform (GCP) project.
- Submitting the partner information to Google.
- Enabling the Conversational Agent API.
Prerequisites
- An active Google account.
- The Partner Name field appears in the Google My Business (GMB) Console for locations associated with the agents you manage.
- A webhook endpoint URL that can accept messages (Kore.ai generates the webhook URL, which will be associated with a virtual assistant built on the platform).
Create a Google Cloud Platform Project
You must create and register a Google Cloud Platform (GCP) project to enable the Google Cloud API service for your partner account. Learn more.
GBM Channel Enablement on the Platform
To set up the GBM channel on the Kore.ai XO Platform and launch the agent, follow the steps below:
- Register as a Google Business Messaging Partner.
- Create an agent for your account.
- If Business Helper Bot is Disabled, set an Agent-level Webhook.
- Create a Service Account Key.
- Configure the Virtual Assistant for the service account.
Step1: Register as a GBM Partner
When you register as a partner with Google Business Messages, you can enable conversations between users and brands by creating agents—conversational entities that represent business functions, such as website support, and brand locations. This helps enable seamless messaging experiences for customer services, sales, and other business applications. To register as a partner, follow the steps below:
- Open the Business Communications Developer Console.
- Under Business Messages, click Create partner account.
- Enter the values for the following fields in the Create a Business Messages partner account window:
-
- Your Name: Your full name.
- Partner Name: Your organization’s name.
- Partner Website: Your organization’s website.
- Region: The region you want to host the Business Messages service.
You are now registered as a Business Messages partner and have access to the Business Messages and Business Communications APIs. The Business Messages API sends messages to users, while the Business Communications API manages agents.
Step 2: Create an Agent for your Account
After you register as a partner, you can enable conversations for brands you manage by creating Business Messages agents for them.
When creating an agent, you can enable the Business Messages Helper Bot that lets you quickly start a conversation with your agent by leveraging the available features and resources. This is especially useful when creating your first agent.
Also, to create an agent for your GBM Partner account, you must submit information on the brand and the agent on the Business Communications Developer Console.
Expectations Before Creating Agents
- Agents should follow the design guidance outlined in Conversation design for Business Messages.
- Agents should have human representatives available to answer questions when automation is unable to fulfill a request or when requested by users.
- Without human representatives, your agent can’t be launched from location-based entry points or non-local entry points. Specify a human interaction type for your agent, so it can surface on Google-managed entry points.
- Agents should maintain a customer satisfaction rating (CSAT) of at least 80% and a merchant response rate (MRR) of at least 95% as outlined in Metrics.
Prerequisites
- If you registered for a partner account before March 7, 2022, you need to enable the Business Messages API before creating your first agent. See Enable the Business Communications API and Business Messages API.
- Please ensure you have the following values for each brand you manage before you create an agent:
- Brand name
- Agent name to appear in conversations with users.
Steps to Create an Agent
Once you’ve gathered the above information, to create an agent follow the steps below:
Note: If you manage multiple brands, repeat the steps to create an agent for each brand.
- Sign in to your account on the Business Communications Developer Console.
- Click Create Agent.
- For Agent type, select Business Messages.
- Do one of the following:
- To experience a conversation with your agent by leveraging the rich features of the GBM Platform, select Enable Business Messages Helper Bot. The Helper Bot allows you to Explore rich features, learn how to implement features, and find resources for agent setup. When the Helper Bot is enabled, it sends and receives messages for your agent, and No Webhook is required.
- To customize your agent and prepare it for message handling, deselect Enable the Business Messages Helper Bot.
- Click Create Agent.
If you enabled the Business Messages Helper Bot, you can start a conversation with your agent immediately. Otherwise, proceed to set your Webhook (Step 3).
Step 3: If Business Helper Bot is Disabled, Set an Agent-level Webhook
To customize your agent and how it handles messaging, you must set an agent Webhook on the Google Business Messages platform. You will receive messages sent to your agent at this Webhook. For setting up the Webhook, you must copy the Webhook URL from the XO platform and generate the Client Token for the agent to integrate for messaging and events.
To set up the agent Webhook, follow the steps below:
- Open the Business Communications Developer Console and sign in with your Business Messages Google account.
- Click on the panel with your agent’s name.
- On the Business Communications page, click Integrations on the left menu.
- For the Webhook option, click the Configure link.
- Copy the Webhook URL from the Kore.ai XO Platform under Deploy > Channels > Google Business Messaging > Configurations.
- Paste the copied link for the Webhook endpoint URL field in the Configure your webhook window on the Business Communications Developer Console.
- Click the Refresh icon for the
clientToken
field to generate the Client token. Note yourclientToken
value. You need it to verify that messages you receive are coming from Google. - In the console, click Verify.
The GBM platform sends a POST
request to Webhook you configured on the XO Platform with the specified ClientToken
parameter and sends a success response with the value of the Secret Key
parameter as verification before sending/receiving messages.
Step 4: Create a Service Account Key
To send messages and events as your agent, you need to authenticate API calls with a service account key. The Business Communications Developer Console creates a service account for you, but you need to create a unique key to access your agent with the steps below:
Step 5: Configure the Virtual Assistant for the Service Account
To configure the virtual assistant for the service account on the Kore.ai XO Platform, follow the steps below:
- Copy the client_email, client_id, client_token (alphanumeric value), and private_key values from the downloaded JSON file.
- Paste the values in the respective fields under Deploy > Channels > Enterprise Channels > Google Business Messaging > Configurations.
- Select Yes for the Enable Channel option.
- Click Save
After enabling the channel and verifying all the configurations, you can test the new channel integration by publishing your virtual assistant. Learn more.
To learn more about working with messaging channels within the Kore.ai XO Platform, please see Channel Enablement.