Google Chat

Send messages in Google Chat spaces and conversations.

CommunicationOAuth6 actionsAll integrations

On this page

Connect
Call it from a workflow
Actions (6)
addASpaceMember
findMember
getDirectMessageDetails
getMessageDetails
searchMessages
sendAMessage
Details

Connect

Auth type: OAuth (oauth2). Click Connect and approve access on the provider's page. Appbricx runs the OAuth flow (signed single-use state, PKCE where the provider supports it), stores the tokens encrypted and refreshes them before they expire.

Scopes requested: https://www.googleapis.com/auth/chat.messages

OAuth needs an OAuth app: the platform's when the operator configured one, or your own (admin panel, Integrations, Configure). You can also bring your own credentials.

In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
For every project in a workspace: Workspace settings, Integrations.
Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow

// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("googlechat", "addASpaceMember", {
    "spaceId": "<spaceId>",
    "personId": "<personId>"
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Google Chat answered", { output: res.output });
}

defineWorkflow module

// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "googlechat-addaspacemember",
  name: "Google Chat: Add a Space Member",
  description: "Calls Google Chat when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("googlechat", {
      "action": "addASpaceMember",
      "spaceId": "<spaceId>",
      "personId": "<personId>"
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});

From an app (connector proxy)

curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/googlechat/addASpaceMember" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"spaceId":"<spaceId>","personId":"<personId>"}}'

Actions

addASpaceMemberin catalog

Add a Space Member. Add a user to a Google Chat space.

Input	Type	Description
`spaceId`required	id (picked from your account)	Select a Space
`personId`required	id (picked from your account)	Select a person

findMemberin catalog

Find Member. Search space member by email

Input	Type	Description
`spaceId`required	id (picked from your account)	Select a Space
`email`required	text	The email address of the member to find

getDirectMessageDetailsin catalog

Get Direct Message Details. Retrieve details of a specific direct message by ID.

Input	Type	Description
`directMessageId`required	id (picked from your account)	Select a Direct Message

getMessageDetailsin catalog

Get Message Details. Retrieve details of a specific message by ID. Supports both system-generated and custom message IDs.

Input	Type	Description
`name`required	text	The full resource name of the message. Format: spaces/{space}/messages/{message}

searchMessagesin catalog

Search Messages. Search within Chat for messages matching keywords or filters.

Input	Type	Description
`spaceId`required	id (picked from your account)	Select a Space
`keyword`required	text	Search for messages containing this text
`limit`optional	number	Maximum number of messages to return

sendAMessagein catalog

Send a Message. Send a message to a space or direct conversation.

Input	Type	Description
`spaceId`required	id (picked from your account)	Select a Space
`text`required	long text	The message content to send. Supports basic formatting like bold, _italic_, and @mentions.
`thread`optional	id (picked from your account)	Select a thread to reply to, leave empty for new thread
`messageReplyOption`optional	one of "REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD" \| "REPLY_MESSAGE_OR_FAIL"	How to handle replies when thread ID is provided.
`customMessageId`optional	text	Optional unique ID for this message (auto-generated if empty). Useful for deduplication.
`isPrivate`optional	boolean	Send this message privately to a specific user. Requires app authentication.
`privateMessageViewer`optional	id (picked from your account)	Select the user who can view this private message.

Details

Id: googlechat
Category: Communication
Tags: chat, google, workspace, team
Package: @activepieces/piece-googlechat@0.1.3
Tier: Community