Table of Contents

Gitter

Gitter

With Gitter modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More in Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, you can

watch, send, update, retrieve and list messages
update, list rooms, list room’s usersCan use the system on a limited basis based on the rights assigned by the admin. More, and delete rooms
retrieve unread itemsItems are rows in records (order/request/invoice/purchase...)

To get started with Gitter, create an account at gitter.im.

Connect Gitter to Boost.space Integrator

To connect Gitter app:

In your Boost.space Integrator account, insert a Gitter moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More in your scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More and click the Add button next to the ConnectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More field.
In the Connection name field, enter a name for the connection, and click Save.
Confirm the access by clicking Allow.

You have successfully connected the Gitter app and can now build scenariosA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More.

Messages

You can watch, send, update, retrieve and list messages using the following modules.

Watch Room’s Messages

TriggersEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... when a new message is sent in a room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID you want to watch.
Limit	Set the maximum number of rooms Boost.space Integrator will return during one execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default)..

Send a Message

Sends a message to a room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID to which you want to send a message.
Text	Enter the message in plaintext or markdown format
StatusCreate statuses for each module separately to create an ideal environment for efficient and consistent work. More	Select whether to indicate that the message is a status update.

Update a Message

Updates the selected message.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose message you want to update.
Message ID	Select or map the Message ID whose details you want to update.
Text	Enter the required body of the message in plaintext or markdown.

Get a Message

Retrieves a single message.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose messages you want to retrieve.
Message ID	Select or map the Message ID whose details you want to retrieve.

List Messages

Lists all messages in a room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose messages you want to list.
Search	Enter the search query to list the messages that match the specified query.
Limit	Set the maximum number of messages Boost.space Integrator will return during one execution cycle.

Rooms

You can update, list rooms, list room’s users, and delete rooms using the following modules.

Update a Room

Updates the selected room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose details you want to send a message.
Topic	Enter the updated room topic.
No Index	Select whether the room is indexed by search engines.
Tags	Enter the tags applicable to the room.

List Rooms

Lists all rooms.

Connection	Establish a connection to your Gitter account.
Limit	Set the maximum number of rooms Boost.space Integrator will return during one execution cycle.

See Gitter API reference for entering the field values to search for the products that match the specified value.

List Room’s Users

Lists all users in the room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose users you want to list.
Limit	Set the maximum number of room users Boost.space Integrator will return during one execution cycle.

Delete a Room

Deletes the selected room.

Connection	Establish a connection to your Gitter account.
Room ID	Select or map the Room ID you want to delete.

Items

You can retrieve unread items using the following modules.

Get Unread Items

Retrieves unread items and mentions from a room.

Connection	Establish a connection to your Gitter account.
Room ID	Select the Room ID whose unread items you want to retrieve.

Other

You can call APIs using the following module.

	Note
	For the list of available endpoints, refer to the Gitter API documentation.

Make an API Call

Performs an arbitrary authorized API call.

Connection	Establish a connection to your Gitter account.
URL	Enter a path relative to `https://api.gitter.im`. For example, `/v1/user/me.`
Method	GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.

Example of Use – List Rooms

The following API call returns all rooms from your account.

URL: /v1/rooms

Method: GET

Matches of the search can be found in the module’s Output under Bundle > Body.

In our example, 2 rooms were returned: