Intercom Docker SDKs (beta)

We've created the following Intercom Docker SDK images to help you get started with the Intercom API quickly in your favored language.

These are in beta at the moment since we are trialling their effectiveness, so if you have any feedback please let us know - you can tweet us at @intercomdevs or reach to us through our messenger.

If you're not familiar with Docker, we recommend first taking a look at our guide to Docker basics.

Before you start

The beauty of Docker is that it takes care of most of the set up so you only need to worry about a few things before you start:

1. A personal access token
You will need to have an Intercom account to use the Docker image since it will require a personal access token. You'll need to have your personal access token on hand so you can pass this in as an environment variable, which will allow you get hit the ground running more quickly rather than having to copy and paste it into your code.

2. Install Docker
The only bit of software you need to have installed is Docker, which pretty simple to get up and running. Refer to our short guide to in install Docker, if you haven't already.

Launch your container

If you want more details on the specifics of the command to run these Docker images please see our Docker basics page explaining it in more detail. You can find specific details of how to run each container in the relevant Docker Hub repository below.

docker run --env PAT="<PERSONAL ACCESS TOKEN>" -it --rm --name <YOUR CONTAINER NAME> intercom/sdk-images:<TAG> 

#For example, to download and run the node image
docker run --env PAT="XXXXXXXXXXXXXXXXXXXX" -it --rm --name  node1 intercom/sdk-images:node-sdk

Docker images

There are images for the following SDKs. The links below will take you to Docker Hub. The images are in one repo called intercom/sdk-images. Each SDK images is then identified by a tag in the form of intercom/sdk-images:.

If you click on the Tag tab in the repo you will see a list of the images. Then simply use the above command to run the image for your SDK tag with your personal access token and you should have your own local SDK environment.

Ruby

Once you have your container running you should be able to run a simple script to retrieve a user:

ruby example-ruby/users/user.rb "USER_ID"

Node

Once you have your container running you should be able to run a simple script to retrieve a user:
node example-node/users/get_user.js "USER_ID"

go

Once you have your container running you should be able to run a simple script to retrieve a user:

go build example-go/users/get_user.go
./get_user "USER_ID*

php

Once you have your container running you should be able to run a simple script to retrieve a user:
php example-php/users/get_user.php "USER_ID"