Skip to main content

Ring Central Event Condition

Overview​

The Ring Central condition allows you to post text messages in your company's Ring Central chat. With the Ring Central condition, you can specify the scenarios when the package will be triggered to post message in the specified group chat.

An example scenario where this condition may be used is when posting authcodes for Microsoft logins. If the code needs to be sent somewhere accessible by a group of staff members and cannot be designated to a specific phone number, you can create a package to post the code in your company's Ring Central group chat.

The Ring Central condition can be selected in the conditions menu of the package editor:

Below is a basic example of a package that uses Ring Central Event Condition: 

conditions: 
- name: 'system_ringcentral'
  match: 'Hi Pia'

steps:

- task: rc_send_message
  inputs:
    message: 'Hello World!.'
    chat_id: =system_ringcentral.message.body.groupId

In the above example, the message 'Hello World!' is posted by the package everytime the Ring Central user writes 'Hi Pia' in the defined Ring Central chat.

Condition Behaviour​

The Ring Central Event condition triggers the package based on the chat input by the user in the Ring Central chat. When the defined package condition is met, this condition automatically starts package execution.

With the Ring Central Event condition, you can use Regex to define the type of text message posted in the Ring Central chat which will start package execution. You can also add filter so that the package is executed only in specific scenarios.

Input Properties​

Use properties to modify the behaviour of the condition.

Property Name: match
Property Required: No
Property Description: Use regex to create a matching criteria for the text message sent in the chat.

Property Name: filter
Property Required: No
Property Description: Use c# syntax to create a logic condition which evaluates to true or false. You can use the entity you are filtering on E.g. message.body.type == "PersonsAdded". The properties of the entity are on the event inputs to the package - check live packages to see an example.

Output Properties​

Here are the output properties which the Ring Central condition makes available.

Property Name: message
Property Description: The message which was passed via Ring Central chat for which this package is running.

Property Name: regex_groups
Property Description: Any named regex groups used in the "match" input condition.