Create a Custom App

Prerequisites:

The following shows the general steps/activities that will be carried out in setting up this integration. Note: It is advisable to use same E-Mail for signup across the 3 channels below. Step 1 -3 below are compulsory.

1. Sign up for Google Account (Part of pre-requisites)

2. Sign up for iX Hello platform (Part of pre-requisites)

3. Create a custom app in iX Hello.

4. Publish the app and Test

Let's Create a Custom App:

1. Fill following details in the Add Custom window and click ‘Save’.

   1. Name: GoogleOAuth Assistant Demo

   2. Custom Skill Type: Search

   3. Category: GoogleOAuth Assistant Demo_2512041349

   4. Set this app as the Gen AI-App

   5. Click Save

Create Data Source:

In the top menu tabs, select “Data Sources” then “Create New Data Source”. Provide the following details:

Data Source 1: Gen AI

Name: GenAIZendeskAssitant-DS

Integration Configuration: Gen AI

Click: Save

DataSource 2: Zendesk

Name: GoogleCalendar-DS

Integration Configuration: Rest API Service : Google AI API

Click: Save

Create Methods to fetch the data from Google Account

Next step is to create Methods. Methods allows you to fetch data from Google Account.

iX Hello platform currently supports following Google Account methods:

getByIdMethods

listEventsMethods

addEventMethods

deleteEventMethods

PutEventMethods

PostEventMethod

PatchEventMethod

For this document, we’ll create only few methods. Users can refer to the appendix to explore all other supported methods.

Method 1: getByIdMethod

This method requires three parameters. Please review the information below.

Method Name	You can give any name. This name will be displayed in the methods list. getByIdMethod
Request Type	Get This is the method that you are using
Method Path	/events/{{id}}
Query Path	? It indicates that the method can return one or more records
Result Type	Record
Empty Result Template	No results. How else can I help you?
Valid Result Template	Event found with status {{status}}\n{{summary}}\n{{description}}\n{{start}} {{end}} How else can I help you?

Sample Response

Method 2: listEventsMethod

This method requires three parameters. Please review the information below.

Method Name	You can give any name. This name will be displayed in the methods list. listEventsMethod
Request Type	Get This is the method that you are using
Method Path	/events
Query Path	? It indicates that the method can return one or more records
Result Type	ListOfRecord
Record Limit	10
Record JsonPath	$.items[*]
Record Template	{{summary}} [{{status}}] {{description}} {{start}} - {{end}}\n
Empty Result Template	Found the following records: {{Records}}
Valid Result Template	{{Records}}

Sample Response

Method 3: listEventsMethod

Parameters:

This method requires three parameters. Please review the information below.

DateEnd	2025-12-20T17:30:00+08:00
DateStart	2025-12-06T17:30:00+08:00
EventDescription	iX Hello - Testing
EventName	iX Hello - Conf

Other than these parameters, provide following standard inputs:

Method Name	You can give any name. This name will be displayed in the methods list. addEventMethod
Request Type	POST This is the method that you are using
Method Path	/events
Query Path	? It indicates that the method can return one or more records
Request Body	{"summary": "{{EventName}}","description": "{{EventDescription}}","start": { "dateTime": "{{DateStart}}" },"end": { "dateTime": "{{DateEnd}}" }}
Result Type	Record
Empty Result Template	Failed to create event. How else can I help you?
Valid Result Template	Meeting created with id {{id}}. How else can I help you?

Sample Response:

Method 4: Gen AI

• Name: Chat Completion RAG

• Request Type: chatcompletion-rag

• Parameters

  • Model: Select your preferred Generative AI model (e.g., Azure gpt-4o).

  • System Message: Provide instructions for the bot’s behavior:

  • This is a sample prompt/system message, this can be configured as per the use case need.

I am a concise and focused assistant, providing accurate information based solely on the provided google integrated methods. I aim to deliver clear and relevant answers to your queries from the google integrated methods.

• UserQuestion: {{UserInput}}

• Streaming: False

• SessionTime: 10

• OrganizationID: {{Context.OrganizationID}}

• EmployeeID: {{Context.OrganizationID}}

Configure Method Output:

• Result Type: ListofRecords

• Record Limit: 10

• Configure Method Result:

  • Record JsonPath: $.choices[0].message

  • Valid Result Template: {{Records}}

  • Record Template: {{content}}

  • Empty Result Template: "Is there anything else I can assist you with?"

• Uncheck: Automatically prompt for next question

• Save & Test

  • Click Save & Test. This will initiate a test API call.

Sample Response

Create New Intent

1. Click Create New Intent.

2. Enter Intent Details as Follows:

Name	addEventIntent
Intent Type	Search
Intent Action	Execute Method
Data Source	GoogleCalendar-DS
Data Source Method	addEventMethod
Dialog Delegation Strategy	Fallback To Skill
Action	Save the intent configuration

Similarly Create the Intents for rest of the Methods created:

• chatCompletionMethod - chatintent

• getByIdMethod - getByIdIntent

• ListEventsMethod - ListEventsIntent

Slot: CreateNewTicketIntent

Parameter 1: DateEnd

Parameter 2 : DateStart

Parameter 3: EventDescription

Parameter 4: EventName

Name	DateEnd	DateStart	EventDescription	EventName
Description	DateEnd	DateStart	EventDescription	EventName
Slot Order (Sequence Number)	1	2	3	4
Reprompt Message	(Its a message that the use will be asked when the slot cannot be retrieved in an utterance) Please provide ticket subject	-	-	-
Type	Date	Date	Text	Text
Custom App	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo
Intent	addEventIntent	addEventIntent	addEventIntent	addEventIntent
Enable	Is Required	Is Required	Is Required	Is Required
Action	Save the intent configuration	Save the intent configuration	Save the intent configuration	Save the intent configuration

Create rest of the slots as per the parameters suggested in the Methods.

Utterance

1. Navigate to Utterances

• In your Custom App, go to the Utterances tab.

Create New Utterance: Enter Intent Details as Follows:

Utterances/ Value	Create Event, Meetings, Add event, new event, Tasks	Ask any thing ?	ID of the event, Provide your ID, Existing event ID, ID, please share your ID	list the events
Custom App	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo
Intent	addEventIntent	chatintent	getByIdIntent	ListEventsIntent
Action	Save the intent configuration	Save the intent configuration	Save the intent configuration	Save the intent configuration

Create rest of the Utterances as per the Intents created.

Input Configuration

1. For Generative AI Intent

• Navigate to Input Configuration

• In your Custom App, go to the Input Configuration tab.

Name	addEventInput	getByIdInput	ChatInput	ListEventInput
Description	Create an Event	ID of the event	UserInput	ListEventInput
Custom Skill	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo	GoogleOAuth Assistant Demo
Custom Intent	addEventIntent	getByIdIntent	getClosedStatusTicketsIntent	ListEventIntent
Data Source	GoogleCalendar-DS	GoogleCalendar-DS	GoogleCalendar-DS	GoogleCalendar-DS
Data Source Method	addEventMethod	getByIdMethod	chatCompletionMethod	ListEventMethod
Enable Gen AI Toggle Button	Yes	Yes	No	Yes
Action	Save the intent configuration	Save the intent configuration	Save the intent configuration	Save the intent configuration

Test the App

Click on the three dots under "Action." A dropdown menu will appear; select the "Test" option to test the application.

Click the "Test" option to access the chat widget. Here, you'll see the bot's name and a welcome message, allowing you to start your conversation with the bot.

Congratulations! You have successfully completed building a custom app using Google OAuth 2.0.