Author: Rucha Khisti
Zoho, is a web-based online office suite containing word processing, spreadsheets, presentations, databases, note-taking, wikis, web conferencing, customer relationship management (CRM), project management, invoicing, and other applications. Zoho applications are distributed as software as a service (SaaS).
Zoho uses an open application programming interface for its Writer, Sheet, Show, Creator, Meeting, and Planner products.
Zoho Meeting API:
The API methods are classified in two different categories-
Private- The private API URIs are used for getting user specific details the results of which are only available to the particular Zoho Meeting user. The URIs for getting private details start with “api/private”
Public- The public API URIs are used for getting presentation related details that have already been made public and hence available for all the users to view. These URIs start with “api/public” and no authentication is required for them. It means that we need not pass a “ticket” as one of the query parameters for accessing them.
The Create Meeting API (private) has been discussed in detail.
- A valid email address
- Permission to access API service (System-level security settings).
The API key needs to be generated by accessing the Zoho Office Integrator Dashboard. This key is unique to each user.
- AuthToken to access the API
This token needs to be generated with a specific API. The authentication token should be passed in the request header for every API request. The details for API to generate AuthToken have been provided in Zoho. The below image shows the URL to be consumed, mandatory query Parameters and sample of the output generated for the same.
Create Meeting API:
The method used to Create Meeting is POST.
To create a Meeting in Zoho, ApiKey and AuthToken are mandatory. The below images show the URL to be consumed and the mandatory query Parameters.
The Image 3 shows the sample response received, which contains the unique meetingKey. This meetingKey is shared with the participants joining the meeting.
Image 4 shows the mule API to Generate the AuthToken, Create Meeting and send a calendar invite to the participants.
Image 5 shows the postman request generated to trigger the above flow. The query parameters provided in the request are stored in different variables in the flow.
The generated meetingKey is shown in output.
Mule API to Generate AuthToken:
Image 6 shows the Request to generate the Auth Token. The “Email Id” of the person creating the meeting is provided in the properties file and the “Password’ of the Zoho account is provided in the secure-properties file.
Mule API to Create Meeting:
The AuthToken generated is saved in variable and used in the Create Meeting API. Image 7 shows the query parameters required to create the meeting.
The ApiKey is provided in the secure-properties file, the AuthToken, participants and date are saved in variables.
Image 8 shows the calendar invite sent to the participants.
The below Image 9 shows the notification email sent to the creator of the meeting.