Zulip

With the Zulip modules, you can do the following in your Zulip account.

To get started with the Zulip, create an account at zulip.com

Note

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

Connect Zulip with Make

To connect the Zulip app with the Make:

  1. Log in to your Zulip account.

  2. Click Settings > Personal Settings.

    Zulip_3.png
  3. Click Bots > Add a New Bot. Enter the required details and click Create bot.

    Zulip_4.png
  4. Copy the Bot Email and API Key and store them in a safe place.

    Zulip_5.png
  5. Log in to your Make and add a module from the Zulip into a Make scenario.

  6. Click Add next to the Connection field.

    Zulip_1.gif
  7. In the Connection name field, enter a name for the connection.

  8. In the Email, API Key, and Zulip Domain fields, enter the details copied in step 4 and click Save.

You have successfully connected the Zulip app with Make and can now build scenarios.

Messages

You can send messages, and upload files using the following modules.

Sends a stream or a private message.

Connection

Establish a connection to your Zulip account.

Type

Select the message type:

  • Private Message

  • Stream Message

Send to

Select or map either the name or Integer ID of the stream to which you want to send the message.

Topic

Select or map the topic for which you want to send the message.

Content

Enter (map) the content of the message. The maximum message size is 10000 bytes.

Uploads a file. To share the uploaded file, you'll need to send a message containing the resulting link.

Connection

Establish a connection to your Zulip account.

File

Enter( (map) the details of the file:

File Name

Enter (map) a name for the file including the file extension. For example, invoice.xml.

File Data

Enter (map) the file data of a file t upload.

Checks whether a set of messages matches a narrow.

Connection

Establish a connection to your Zulip account.

Message IDs

Enter (map) a list of IDs whose messages you want to check.

Narrow

Select or map a structure defining the narrow to check against.

Operator

Select or map an operator for the messages.

Operand

Enter(map) an operand based on the operator selected.

Users

You want to

Create a User

Creates a new user account. The endpoint is only available to organization administrators.

Connection

Establish a connection to your Zulip account.

Email

Enter (map) the email address of the new user.

Password

Enter (map) the password of the new user.

Full Name

Enter (map) the full name of the new user.

Deactivate a User

Deactivates a user given their user ID. The endpoint is only available to organization administrators.

Connection

Establish a connection to your Zulip account.

User ID

Select or map the User ID you want to deactivate.

Reactivate a User

Reactivates a user given their user ID. This endpoint is only available to organization administrators.

Connection

Establish a connection to your Zulip account.

User ID

Select or map a User ID you want to reactivate.

Get a User

Fetches details for a single user in the organization.

Connection

Establish a connection to your Zulip account.

User ID

Select or map a User ID whose details you want to retrieve.

Get a User by Email

Fetches details for a single user in the organization given a Zulip display email address.

Connection

Establish a connection to your Zulip account.

Email

Select or map the user's email address whose details you want to retrieve.

List Users

Retrieves details on all users in the organization.

Connection

Establish a connection to your Zulip account.

Client Gravatar

Select whether the client supports computing Gravatars URLs. The default value is true.

Include Custom Profile Fields

Select whether the client wants custom profile field data to be included in the response. The default value is false.

Limit

Set the maximum number of conversations Make will return during one execution cycle. The default value is 10.

Other

You can call APIs using the following module.

Make an API Call

Performs an arbitrary authorized API call.

Connection

Establish a connection to your Zulip account.

URL

Enter a path relative to https://peoly.zulipchat.com/api/ . For example, /v1/users/me.

Note

For the list of available endpoints, refer to the latest Zulip API Documentation.

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 Streams

The following API call will list streams from your Zulip account:

URL:

/v1/streams

Method:

GET

Zulip_6.png

Matches of the search can be found in the module's Output under Bundles > Body >streams.

In our example, 2 streams were returned:

Zulip_7.png