Zendesk Guide

Getting Started with Zendesk Guide

Prerequisites

A Zendesk account. Create an account at www.zendesk.com/register.

Creating a connection to Zendesk Guide

  1. Go to the Zendesk Admin page and click the API link in the Channels section.

    61f27ec6f0798.png
  2. Open the OAuth Clients tab.

    61f27ec875164.png
  3. Fill the form. In the Redirect URLs field, insert the following: https://www.integromat.com/oauth/cb/zendesk/

    61f27ec9c655c.png
  4. Save the values from the Unique Identifier and Secret fields. You will need them for the Make module.

    61f27ecab42a4.png
    61f27ecbac59b.png
  5. Open the Make module and enter the Domain, Unique Identifier, and Secret values into the Create a connection dialog. Create a connection by clicking the Continue button.

    61f27eccc50ea.png

Triggers

Retrieves article information when an article is created or updated.

Connection

Establish a connection to your Zendesk account.

Section

Select the section you want to watch for changes.

Locale

Select which article language you want to watch.

Trigger by

Select whether you want to watch for new articles or changes in existing articles.

Limit

Set the maximum number of results in one scenario run.

Actions

Moves the selected article to the Archived articles.

Zendesk may need you to extend the access rights. Click the Allow button.

61f27ece136b9.png

Connection

Establish a connection to your Zendesk account.

Article ID

Enter the ID of the article you want to archive.

Connection

Establish a connection to your Zendesk account.

Section

Select the section you want to create the article in.

Locale

Select which article language you want to set.

Title

Enter the article title.

Body

Enter the article content.

Connection

Establish a connection to your Zendesk account.

Article ID

Enter the Article ID.

Inline

If checked, the attached file is shown in the dedicated admin UI for inline attachments and its URL can be referenced in the HTML body of the article. If not checked, the attachment is listed in the list of attachments.

Source file

Set the file you want to attach to the selected article. You can map it from another module, e.g. Dropbox> Get a file. More information about working with files.

Connection

Establish a connection to your Zendesk account.

Attachment ID

Enter the Attachment ID. It can be retrieved by the List Article Attachments module.

Connection

Establish a connection to your Zendesk account.

Article ID

Enter the ID of the article you want to retrieve information about.

Locale

Select the article locale from the drop-down menu.

Updates a translation article.

Note

The translation must already exist. This module does not create a new one!

Connection

Establish a connection to your Zendesk account.

Article ID

Enter the ID of the article you want to retrieve information about.

Locale

Select the translation article locale from the drop-down menu.

Title

Enter the title update for the selected translation.

Body

Enter the article content update for the selected translation.

Deletes an article vote.

Connection

Establish a connection to your Zendesk account.

Vote ID

Enter the Vote ID. It can be retrieved by the List Article Votes module.

Searches

Connection

Establish a connection to your Zendesk account.

Article ID

Enter the ID of the article you want to get a list of attachments.

Locale

Select the article locale from the drop-down menu.

Connection

Establish a connection to your Zendesk account.

Section

Select which section you want to get the list of articles from.

Locale

Select the locale of the retrieved articles.

Limit

Enter the limit for the number of articles in the list.

Lists all votes cast for a specified article.

Connection

Establish a connection to your Zendesk account.

Article ID

Enter (map) the article you want to get votes from.

Locale

Select the locale of the article whose votes you want to retrieve.