Skip to content
Nappai Documentation

Google Chat Messages

Google Chat Messages connects your flow to Google Chat to work with messages: post a message in a space, read a space’s messages or a specific one, reply inside a thread, write a direct message to a person, correct a message you already sent or delete it.

It is useful when you want your team to get notices in the tool they already use every day, or when an AI agent needs to read what is said in a space to summarize it or act on it.

When to use it

  • Notify the support team’s space every time an urgent ticket comes in.
  • Send a summary of yesterday’s sales to a space every morning.
  • Write a direct message to a sales rep when one of their customers asks for a quote.
  • Read the messages of a project space so an agent can prepare a weekly summary.
  • Reply in the same conversation thread with the result of a task.

Configuration

You need a Google Chat credential, which connects by signing in with your Google account. When you create it you choose the access level: Read and Send Messages, Manage Spaces and Members to send, edit and delete, or Read Only if you only need to read. 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: Send Message.
SpaceThe Google Chat space you work with. Once you pick the credential, the list shows your spaces. Used in Send Message, Get Messages and Reply to Message. It does not appear in Send Direct Message.
Message TextThe message text. Used in Send Message, Reply to Message, Send Direct Message and Update Message.
Message IDThe message’s ID, in the form spaces/AAAA/messages/BBBB. You find it in the result of Get Messages or Send Message. Required in Get Message, Update Message and Delete Message.
Thread IDOnly in Reply to Message. The thread to reply in, in the form spaces/AAAA/threads/CCCC. You find it in the result of Get Messages. If the thread does not exist, the message starts a new thread.
Recipient EmailOnly in Send Direct Message. The email of the person you are writing to.

Operations

OperationWhat it does
Send MessagePosts a message in the chosen space.
Get MessagesReturns the messages of the chosen space.
Get MessageReturns one message from its Message ID.
Reply to MessagePosts a message inside a thread of the space.
Send Direct MessageSends a direct message to a person from their email. If you had no direct conversation yet, one is created.
Update MessageReplaces the text of a message already sent.
Delete MessageDeletes a message.

Output

The Data output returns the message you worked with. When you send or reply, it includes the new message’s ID (message_name), the text and the creation date. With Get Messages you get one item per message, with its ID, text, sender name, date and the thread it belongs to (thread_name). Update Message and Delete Message return a confirmation.

You can connect the result to an agent to summarize or analyze the conversations, or keep the message ID to edit it later. The component can also be connected to an Agent as a tool, so the agent decides when to read or send messages. See Tool Mode.

Example

A maintenance company wants to alert its technical team about urgent breakdowns.

  1. The breakdown form reaches the flow with the customer’s address and a description of the problem.
  2. Add Google Chat Messages with the Send Message operation.
  3. In Space, choose the technical team’s space.
  4. In Message Text, write Urgent breakdown at followed by the address and the description.
  5. When the breakdown is fixed, another flow uses Reply to Message with the notice’s Thread ID to record it in the same thread.

Good practices

  • To edit, delete or reply to a message you need its ID. Keep it when you send the message, for example in your spreadsheet or your CRM.
  • Messages are posted on behalf of the Google account you used to create the credential. Use an account your team recognizes.