Skip to main content

RingCentral

RingCentral Team Messaging (Glip) connector for team collaboration — chats, posts, teams, conversations, notes, and tasks.

Categories: Communication, Team Messaging

What you can ask​

  • Post the release notes to the Engineering team chat
  • List the open tasks in the Support Escalations chat and who each is assigned to
  • Create a team for the Q3 Launch project and add its members

Set up​

RingCentral needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find RingCentral. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the RingCentral developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or RingCentral login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (5)

Grant the scopes for the tools you plan to allow.

  • EditMessages
  • ReadAccounts
  • ReadMessages
  • SMS
  • TeamMessaging

Tools​

RingCentral offers 51 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (22)​

View and search information without changing it.

ToolWhat it does
get_chatGet one RingCentral chat by ID, including its members.
get_conversationGet one RingCentral conversation by ID, including its members.
get_current_personGet the profile of the currently authenticated RingCentral person (the '~' account).
get_messageRead a full Message Store record, including text/subject, delivery state and attachments metadata.
get_message_attachmentDownload an SMS/MMS attachment through the file service by default.
get_noteGet one RingCentral note by ID, including its body.
get_personGet a RingCentral person by ID.
get_postGet one RingCentral post by ID within a chat.
get_taskGet one RingCentral task by ID, including assignees and due date.
get_teamGet one RingCentral team by ID.
list_chat_notesList notes in a RingCentral chat.
list_chat_tasksList tasks in a RingCentral chat.
list_chatsList RingCentral chats.
list_conversationsList the authenticated person's RingCentral conversations.
list_favorite_chatsList the authenticated person's favorite RingCentral chats.
list_messagesReceive/read SMS and MMS messages from the authenticated extension's Message Store.
list_postsList posts (messages) in a RingCentral chat.
list_recent_chatsList the authenticated person's recent RingCentral chats, most recent first.
list_sms_phone_numbersFind valid SMS/MMS sender numbers assigned to the authenticated extension before sending texts.
list_teamsList RingCentral teams the authenticated person can see.
read_message_attachment_textRead the words in an SMS/MMS PDF, DOCX, XLSX or text attachment using server-side extraction, limited to 25 MB.
validate_credentialCheck that the RingCentral connection works by fetching the signed-in person.

Write (10)​

Create or send data.

ToolWhat it does
add_team_membersAdd members to a RingCentral team by person ID.
create_chat_noteCreate a note in a RingCentral chat. title is required.
create_conversationOpen or create a RingCentral conversation with the given member person IDs.
create_postPost a message to a RingCentral chat. text is required.
create_taskCreate a task in a RingCentral chat. subject and assignees are required — a task cannot be unassigned.
create_teamCreate a RingCentral team. name is required.
favorite_chatAdd a RingCentral chat to the authenticated person's favorites.
join_teamJoin a public RingCentral team as the authenticated person.
send_mmsSend images, PDFs/documents or supported media with an optional caption.
send_smsSend an SMS text to one or more phone numbers, including links as ordinary text.

Delete or overwrite (19)​

Remove or replace existing data.

ToolWhat it does
archive_teamArchive a RingCentral team (make it read-only).
complete_taskComplete or reopen a RingCentral task.
delete_messageDelete a message from the authenticated extension's Message Store.
delete_noteDelete a RingCentral note permanently.
delete_postDelete a RingCentral post permanently.
delete_taskDelete a RingCentral task permanently.
delete_teamDelete a RingCentral team permanently.
leave_teamLeave a RingCentral team as the authenticated person.
lock_noteLock a RingCentral note for editing so others cannot change it.
publish_notePublish a RingCentral note (move it from Draft to Active).
remove_team_membersRemove members from a RingCentral team by person ID.
unarchive_teamUnarchive a RingCentral team (restore write access).
unfavorite_chatRemove a RingCentral chat from the authenticated person's favorites.
unlock_noteUnlock a RingCentral note so it can be edited by others.
update_message_read_statusMark a Message Store message Read after processing it, or Unread to restore its unread state.
update_noteUpdate a RingCentral note's title or body.
update_postEdit the text of a RingCentral post.
update_taskUpdate a RingCentral task.
update_teamUpdate a RingCentral team's name, description, or visibility.
⌘J