GETTING STARTED
Kore.ai XO Platform
Virtual Assistants Overview
Natural Language Processing (NLP)
Concepts and Terminology
Help & Learning Resources
Quick Start Guide
Accessing the Platform
Navigating the Kore.ai XO Platform
Building a Virtual Assistant
Using Workspaces
Release Notes
Current Version
Previous Versions
Deprecations
Request a Feature
CONCEPTS
Design
Storyboard
Overview
FAQs
Conversation Designer
Overview
Dialog Tasks
Mock Scenes
Dialog Tasks
Overview
Navigate Dialog Tasks
Build Dialog Tasks
Nodes & Connections
Overview
Node Types
Intent Node
Dialog Node
Entity Node
Entity Rules
Form Node
Confirmation Node
Message Nodes
Logic Node
Bot Action Node
Service Node
Webhook Node
Script Node
Process Node
Agent Transfer
Node Connections Setup
Sub-Intent Scoping
User Prompts
Voice Call Properties
Dialog Task Management
Supported Entity Types
Supported Company Names
Supported Colors
Knowledge Graph
Introduction
Knowledge Extraction
Build Knowledge Graph
Create Node Structure
Build the Graph
Add FAQs
Add FAQs from an Existing Source
Run a Task
Traits, Synonyms, and Stop Words
Manage Variable Namespaces
Update Knowledge Graph
Introduction
Move Question and Answers Between Nodes
Edit and Delete Terms
Edit Questions and Responses
Knowledge Graph Analysis
Knowledge Graph Import and Export
Prepare Data for Import
From a CSV File
From a JSON File
Importing Knowledge Graph
Exporting Knowledge Graph
Auto-Generate Knowledge Graph
Alert Tasks
Small Talk
Digital Skills
Overview
Digital Forms
Digital Views
Introduction
Widgets
Panels
Session and Context Variables
Context Object
Train
NLP Optimization
ML Engine
Overview
Model Validation
FM Engine
KG Engine
Traits Engine
Ranking and Resolver
Training Validations
NLP Configurations
NLP Guidelines
Intelligence
Introduction
Event Handlers
Default Standard Responses
Contextual Memory
Contextual Intents
Interruption Management
Multi-intent Detection
Amending Entities
Default Conversations
Conversation Driven Dialog Builder
Sentinment Management
Tone Analysis
Test & Debug
Overview
Talk to Bot
Utterance Testing
Batch Testing
Conversation Testing
Health and Monitoring
Deploy
Channels
Publishing
Versioning
Analyze
Introduction
Overview Dashboard
Conversations Dashboard
Users Dashboard
Performance Dashboard
Custom Dashboards
Introduction
Custom Meta Tags
Create Custom Dashboard
NLP Insights
Conversations History
Conversation Flows
Analytics Dashboard Filters
Usage Metrics
Containment Metrics
Smart Bots
Universal Bots
Introduction
Universal Bot Definition
Universal Bot Creation
Training a Universal Bot
Universal Bot Customizations
Enabling Languages
Store
Manage Assistant
Plan & Usage
Overview
Usage Plans
Support Plans
Invoices
Authorization
Multilingual Virtual Assistants
Get Started
Supported Components & Features
Manage Languages
Manage Translation Services
Multiingual Virtual Assistant Behavior
Masking PII Details
Variables
Collections
IVR Settings
General Settings
Assistant Management
Manage Namespace
Data as Service
Data Table
Table Views
App Definitions
Sharing Data Tables or Views
HOW TOs
Build a Travel Planning Assistant
Travel Assistant Overview
Create a Travel Virtual Assistant
Design Conversation Skills
Create an ‘Update Booking’ Task
Create a Change Flight Task
Build a Knowledge Graph
Schedule a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Train the Assistant
Use Traits
Use Patterns
Manage Context Switching
Deploy the Assistant
Configure Agent Transfer
Use Bot Functions
Use Content Variables
Use Global Variables
Use Web SDK
Build a Banking Assistant
Design Conversation Skills
Create a Sample Banking Assistant
Create a Transfer Funds Task
Create a Update Balance Task
Create a Knowledge Graph
Set Up a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Add Data to Data Tables
Update Data in Data Tables
Add Data from Digital Forms
Train the Assistant
Composite Entities
Use Traits
Use Patterns for Intents & Entities
Manage Context Switching
Deploy the Assistant
Configure an Agent Transfer
Use Assistant Functions
Use Content Variables
Use Global Variables
Intent Scoping using Group Node
Analyze the Assistant
Create a Custom Dashboard
Use Custom Meta Tags in Filters
APIs & SDKs
API Reference
API Introduction
API List
API Collection
koreUtil Libraries
SDK Reference
SDK Introduction
SDK Security
SDK Registration
Web Socket Connect and RTM
Using the BotKit SDK
BotKit SDK Tutorial - Blue Prism
Widget SDK Tutorial
Web SDK Tutorial
ADMINISTRATION
Introduction to Admin Console
Administration Dashboard
User Management
Add Users
Manage Groups
Manage Roles
Assistant Management
Enrollment
Invite Users
Send Bulk Invites
Import User Data
Synchronize Users from AD
Security & Control
Using Single-Sign On
Security Settings
Cloud Connector
Analytics
Billing
  1. Home
  2. Docs
  3. Virtual Assistants
  4. Channel Enablement
  5. Adding the Google Business Messaging Channel

Adding the Google Business Messaging Channel

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 a Google Business Messaging Partner to 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.

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?

The Kore.ai XO Platform registers each Business as a partner with Business Messages and the conversations between the customers and brands will be enabled by creating agents.

Customers can send messages to your brand or its locations through these agents. When a user finds a brand that Kore.ai manages with the business in Google Search or Google Maps.

When a customer clicks the button, a conversation is initiated with the brand’s virtual agent on the device. Businesses can receive and respond to customer messages through an agent, which is a conversational entity that represents business functions, such as website support, and brand locations. 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:

  1. Creating a Google Cloud Platform (GCP) project.
  2. Submitting the partner information to Google.
  3. 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 Learn more.

Important: Please note the project number to register as a partner.

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:

  1. Register as a Google Business Messaging Partner.
  2. Create an agent for your account.
  3. Set up the Webhook for the agent.
  4. Create a Service Account Key.
  5. Configure the Virtual Assistant for the service account.

Step1: Register as a GBM Partner

To integrate with the GBM channel, you need to register as a partner for Google Business Messaging with the steps below:

  1. Open the Business Communications Developer Console.
  2. Under Business Messages, click Create partner account.
  3. Enter the values for the following fields in the Create a Business Messages partner account window:
  • Your Name
  • Partner Name
  • Partner Website
  • Region
  1. Click Create.

Step 2: Create an Agent for your Account

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 with the steps below:

Note: To manage multiple brands, you must create an agent for each brand.

  1. Sign in to your account on the Business Communications Developer Console.
  2. Click Create Agent.
  3. Enter the values for the Brand name and Agent name fields.
  4. Select Enable the Business Messages Helper Bot to activate the agent.
  5. Click Create Agent.
  6. Click your agent’s name when your agent is available.

Please ensure you have the following values before you create an agent:

  • Brand name
  • Brand website
  • Agent name to appear in conversations with users.
  • Agent logo as a publicly available URL.
  • Agent welcome message
  • Live chat hours
  • A physical location of the brand for testing purposes. Please avoid the corporate headquarters or other locations not represented by the brand agent.
  • Partner name
  • Partner ID
  • GCP project number
  • (Optional) Business ID identifies the brand in messages the webhook receives.
  • Escalation of contact name, email, and phone number.

Note: Once your agent is available, you can add the business and branding information.

Step 3: Set up the Webhook for the Agent

After creating the agent, you need to copy the Webhook URL from the Kore.ai 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:

  1. Open the Business Communications Developer Console and sign in with your Business Messages Google account.
  2. Click on the panel with your agent’s name.
  3. On the Business Communications page, click Integrations on the left menu.
  4. For the Webhook option, click the Configure link.
  5. Copy the Webhook URL from the Kore.ai XO Platform under Deploy > Channels > Google Business Messaging > Configurations.
  6. Paste the copied link for the Webhook endpoint URL field in the Configure your webhook window on the Business Communications Developer Console.
  7. Click the Refresh icon for the Client token field to generate the Client token.
  8. Click Verify.

The GBM platform sends a POST request to the Kore.ai XO Platform’s webhook with the ClientToken and Secret Key parameters for 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:

  1. On the left menu, click Service account.
  2. Click the Create key button.
  3. Click Create on the confirmation window to download the JSON file with the service account key.

  4. Rename the downloaded file to rbm-agent-service-account-credentials.json.
  5. Store the key securely to recover it if required.

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:

  1. Copy the client_email, client_id, token_uri, and private_key values from the downloaded JSON file.
  2. Paste the values in the respective fields under Deploy > Channels > Enterprise Channels > Google Business Messaging > Configurations.
  3. Select Yes for the Enable Channel option.
  4. 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.

Menu