Configuring the Zendesk Integration

Publishing to an external service requires the use of one site on your account. If you need additional sites on your account you can contact support to purchase additional sites.

1. Go to Account Settings > Integrations

  1. Select Account Settings
  2. Select Integrations
  3. Select Zendesk Help Center

2. Configure your connection

Configure your connection
  1. Your Zendesk account name is the name at the front of your Zendesk URL. For example, if your help desk is at https://mycompany.zendesk.com then the account name would be 'mycompany'.
    ImportantIf you are using a custom domain name on your Zendesk account then you will need to enter the full domain name with protocol. For example: https://support.mydomain.com.
  2. Your Zendesk host name is an option paramater. This should be the host name where your customers come to view your Zendesk site.
  3. The email should be the email address you use to login to Zendesk
  4. You can retrieve your Zendesk API Token by following these instructions.
  5. The Locale setting defaults to US English. If you are using a different language in your Zendesk then you should set the locale here.
  6. Select Create.

You will be taken to your newly created ScreenSteps site that is connected to Zendesk.

3. Import structure

3.1. Select Import structure from Zendesk

From the Site Contents menu, select Import structure from Zendesk HC

Select Import structure from Zendesk

3.2. Select Import

Confirm that you want to import your structure from Zendesk.

Select Import

4. View imported manual

Select the manual title for one of the manuals that were imported from Zendesk.

Open imported manual

5. Create or import articles

You should now see all of the Zendesk sections for the current manual in ScreenSteps.

You can now create new articles in ScreenSteps and have them published to Zendesk or import existing Zendesk articles to edit them in ScreenSteps.

Create or import articles

4 Comments

Aaron Cho

How do I update the Zendesk API Token in SSL? It seems I can't without first removing the Zendesk integration (getting the error "site has already been taken"). Please advise.

Dov

How do I delete a ZenDesk integration? We set it up and were going to import existing ZD content. But now we want to start fresh and create all new content to then push out to ZD.

Trevor DeVore

@Dov - email support@screensteps.com and we will help you with that.

Add your comment

E-Mail me when someone replies to this comment