You can set up a test version of Intercom in your development/staging environment before adding it to production. Lots of our customers like to do this as part of installing Intercom so that they can be sure it’s working correctly before putting it live.

Note: There is no additional charge for creating a test workspace of Intercom. 

Why is it helpful?

  1. It's great for getting familiar with how Intercom works. You'll be able to hit the ground running then when you do put it live :)
  2. It allows you to sanity check your user data to see that it's doing what it should be.
  3. Some people like to get comfortable with sending test messages first, before contacting their real customers. Setting up a test workspace can be helpful for this because it lets you test your auto messages to make sure that they are sending as expected.
  4. You should use the test workspace as an opportunity to test any custom attributes that you're thinking of sending to Intercom.

What you need to know about test workspaces 

  • Test workspaces are completely separate workspaces with separate data, conversations, messages, etc. You can use Test versions to send real messages to users. 
  • There's no additional costs to creating a test workspace and there are no user limits. 
  • Your test workspace's products are inherited from your main workspace (e.g. if your main workspace doesn't have Engage, your test workspace won't either). 

So, here's how to do it:

Step 1: 

Go to your settings.

Step 2: 

You'll then be directed to your General Settings screen where you need to tick the box next to 'Test Version', and click Save.

Step 3

You'll receive a confirmation message at the top of the screen and your test workspace ID (App ID) will be displayed next to the 'Test Version' check box that you selected, as shown below.

Step 4

Make sure to add the Intercom snippet to your non-prod environment. When you do, your test workspace will inherit the messaging abilities of your production workspace in Intercom but it will have its own workspace id (app ID), to keep data separate. You need to make sure to update your intercomSettings so that the app_id field has the correct value based on the environment that your site/app is running in. If you're using identity verification, you'll need to go into your setup guide to get the new API secret for your test workspace. Similarly, you'll need to grab a test specific access token. 

And... you're done!

To find your test workspace hover over your avatar, then hover over your real workspace and you'll see the test workspace you've created.  

Did this answer your question?