Skip to content
Nappai Documentation

Google Chat Spaces

Google Chat Spaces connects your flow to Google Chat to manage spaces, the places where a group of people talk: see the list of your spaces, get the details of one, create a new space, see who belongs to it and add a person.

It is useful to organize communication automatically, for example to open a space for every new project or customer and bring in the people who will work on it.

When to use it

  • Open a Google Chat space every time a new project is signed.
  • Add a new hire to their department’s spaces.
  • Check who belongs to a space before sending a notice.
  • Get the list of your spaces so an agent can choose where to post.

Configuration

You need a Google Chat credential, which connects by signing in with your Google account. To create spaces and add members, choose the Read and Send Messages, Manage Spaces and Members access; with Read Only you can only look things up. See Credentials.

FieldWhat it does
Credential (required)The Google Chat credential used to access your account.
Operation (required)What the component does. See Operations. Default: Get Spaces.
SpaceThe space you work with. Once you pick the credential, the list shows your spaces. Used in Get Space Details, Get Space Members and Add Space Member.
Space NameOnly in Create Space. The name people will see on the new space.
Space TypeOnly in Create Space. The type of space. Default: SPACE, a named space.
User EmailOnly in Add Space Member. The email of the person you want to add.

Operations

OperationWhat it does
Get SpacesReturns the list of spaces you have access to.
Get Space DetailsReturns the details of the chosen space.
Create SpaceCreates a new space with the given name.
Get Space MembersReturns the people who belong to the space, with their name and role in it.
Add Space MemberAdds a person to the space from their email.

Output

The Data output returns the spaces or people you worked with. With Get Spaces you get one item per space, with its ID (name, in the form spaces/AAAA), its display name and its type. Create Space returns the ID and name of the new space. Get Space Members returns one item per person, with their name and role. Add Space Member returns a confirmation.

You can use the space ID in Google Chat Messages to post in it. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A marketing agency opens a space for every new customer.

  1. The new customer reaches the flow from the CRM with the company name and the email of their account manager.
  2. Add Google Chat Spaces with the Create Space operation and write Customer followed by the company name in Space Name.
  3. Add a second Google Chat Spaces with Add Space Member to bring in the account manager, with their email in User Email.
  4. Finish with Google Chat Messages to post a welcome message in the new space.

Good practices

  • The Space list loads when you pick the credential. If you have just created a space and it does not show, pick the credential again.
  • Spaces are created on behalf of the credential’s Google account, which becomes a member of the space.