Skip to main content
[Zendesk Sell] Mapsly setup guide

Follow this guide to set up your Mapsly account with Zendesk Sell

Sergey Shurygin avatar
Written by Sergey Shurygin
Updated over 4 months ago

Mapsly is a standalone software platform that exchanges data with your Zendesk Sell account through its API.

IMPORTANT! While Mapsly does work with Zendesk's Sell Team plan, there are a few limitations due to the absence of Firehose API, which comes only with the Sell Growth plan or higher. So we recommend upgrading to Sell Growth to enable this API. For details β€” see the section Limitations on Sell Team plan below.

Create your Mapsly trial

1. Install Mapsly extension

Open the Mapsly extension page and click on the Install button:

Select the account where you need to install Mapsly:

2. Open Mapsly

There are two ways to open and then use Mapsly:

  1. In the Mapsly tab inside Zendesk Sell. If you prefer this way, simply click on the Mapsly icon at the top bar:

  2. Or in a separate tab at app.mapsly.com. If you prefer this way, at app.mapsly.com click the Zendesk logo and - if prompted - sign in with your Zendesk credentials on the Zendesk pop-up login page.

3. Follow the Mapsly account sign-up wizard

Click Create new Mapsly account:

and follow the sign-up wizard instructions.

Limitations on the Sell Team Plan

When you remove records in your Zendesk Sell, Mapsly uses Zendesk Sell's Firehose API to get notified of these events β€” to reflect these updates in Mapsly quickly. Also, all events related to appointments, like their creation, updates, or removal, are passed exclusively through the Firehose API.

The Firehose API comes only on the Sell Growth plan and is unavailable on the Sell Team. So when on Sell Team, Mapsly has to occasionally reimport all Zendesk data to detect which records were removed in Zendesk. The frequency of such reimports is determined based on the number of records in your Zendesk, so you may expect a several-hour delay in the sync of removed records or even days for accounts with tens of thousands of records. Also, On Sell Team Mapsly cannot sync calendar events from your Zendesk.

You may avoid these limitations by upgrading to Sell Growth. Once you upgrade, Mapsly will automatically start using the Firehose API and the sync of removed records and calendar events will become part of the regular sync that by default happens every 30 minutes, with the option to increase it to every 10 minutes.

Adding more users to Mapsly

New Zendesk users are automatically added to your Mapsly account with restricted access when they open the Mapsly tab or log in to Mapsly with their Zendesk credentials at app.mapsly.com; you don't need to add them manually. Learn more about users and Single Sign-On here.

Implementation is included in your Mapsly subscription!

Your Mapsly subscription comes with implementation services, so we're inviting you to book a web call with our engineer today - to learn more about your use scenario and help you integrate Mapsly with your system. You may also ask us for help in chat any time 24/7.

More useful articles

If you'd like to see on the map only standard objects like contacts, the wizard's instructions are self-explanatory. In more complex scenarios when you'd like to see other objects in Mapsly as well or use coordinates instead of an object's address, please refer to these articles:

Did this answer your question?