Google Chat Integration

To successfully deploy the Leena AI assistant to your organization’s Google Chat workspace, we require a specific setup within your Google Cloud environment. As this integration will be a private application for your internal users, your IT/Cloud team will own the infrastructure, while Leena AI will host the bot's intelligence.

1. Prerequisites (Required Before We Start)

Please ensure the following are ready before the implementation call:

• Google Cloud Admin Access: You need a user with Project Creator or Owner permissions to create a new project in your organization's Google Cloud Console.
• Billing Account: A valid Google Cloud Billing Account (credit card or invoice billing) must be available to link to the new project.
  • Note: While the API usage for Google Chat is typically free, Google strictly requires a linked billing account to activate the service.
• Branding Assets: To publish the app internally, you will need:
  • Bot Name: (e.g., "HR Help", "Genie", "Ask Leena").
  • Avatar Icon: A high-res PNG of the bot’s logo.
  • Store Description: A short description (e.g., "AI Assistant for Employee Queries").

2. The Integration Process (High Level)

We will follow a simple 3-phase process to get your bot live.

Phase 1: Environment Setup (Client Action)

Your IT team will create a standard "shell" project in Google Cloud to act as the gateway for the bot.

• Create a new Google Cloud Project.
• Enable the Google Chat API and Google Workspace Marketplace SDK.
• Create a Service Account and generate a secure JSON Key.

Phase 2: Connection Handshake (Data Exchange)

We link your Google Cloud gateway to Leena AI’s brain.

• You send to Leena AI: The JSON Key (generated in Phase 1).
• Leena AI configures: We set up the backend and generate a unique webhook for you.
• Leena AI sends to you: A unique Bot Endpoint URL.

Phase 3: Deployment (Client Action)

You finalize the connection and make the app available to your employees.

• You enter the Bot Endpoint URL into your Google Chat API settings.
• You upload the branding assets (Logo/Name).
• You click "Publish" in the Google Workspace Marketplace (Private visibility) to make it discoverable for your staff.

3. Required Deliverables

To avoid delays, please be prepared to provide the following items to the Leena AI implementation team:

Frequently Asked Questions for IT Teams

Q: Will this cost us money on Google Cloud? A: Typically, no. The Google Chat API and Marketplace SDK are generally free for standard organizational use. However, Google requires a billing account to be linked as a verification step to prevent abuse.

Q: Does Leena AI access our entire Google Cloud? A: No. We only require a Service Account with permissions specific to the Google Chat API. We do not need access to your Compute Engines, Storage buckets, or other internal resources.

Q: Who hosts the application logic? A: Leena AI hosts the bot logic, NLP engine, and databases on our secure servers. Your Google Cloud Project acts only as a "pass-through" to forward messages from Google Chat to our endpoint.

Q: How to Change the Google Chat App Name?

Since the app name is recorded in two separate places within your Google Cloud Project, you must update both locations for the name change to be fully consistent and visible to your employees.

You must update the app name in the Google Cloud Console in the following two sequential steps: