AI agents for Groove

Find conversations

Lists conversations matching keywords, state (UNREAD, OPENED, CLOSED, SNOOZED, SPAM, TRASH), a contact's email, an assigned agent ID, tag names, a channel ID or created/updated dates.

Get a conversation

Reads one conversation by its number (the # shown in Groove).

List messages in a conversation

Reads a conversation's events by its ID (like cnv_123): messages, notes, replies and changes such as state or tags, oldest first, 50 a page.

Find contacts

Finds contacts by a search term (name or email) or an exact email, 25 a page.

List agents

Lists the organization's agents.

List tags

Lists tags, or those whose name matches a search.

List channels

Lists the account's channels (email inboxes, chat widgets, social).

Reply to a conversation

Sends an email reply (HTML allowed) to a conversation's contact as the connected agent, optionally with cc and bcc, a new subject, and a state to leave it in (CLOSED after answering, for example).

Add a note

Adds an internal note (HTML allowed) to a conversation; only agents see it.

Start an email conversation

Starts a new outgoing email conversation from a channel (an inbox, from List channels) to one or more recipients, with a subject and body.

Close a conversation

Sets a conversation's state to CLOSED.

Reopen a conversation

Sets a conversation's state to OPENED (also ends a snooze).

Snooze a conversation

Snoozes a conversation until a date and time, or indefinitely when until is left out.

Assign a conversation

Assigns a conversation to an agent, a team, or both (IDs from List agents; teams from Groove), optionally without notifying them.

Tag a conversation

Adds tags to a conversation by tag ID (find IDs with List tags); its other tags stay.

Remove tags from a conversation

Removes tags (by tag ID) from a conversation.