Version 3 is not backward compatible with version 2.
The main changes are that it now supports multiple clients within the same process, direct support for Personal Access Tokens, and support for the Bulk API.
Multiple client support makes its possible to work with more than one Intercom App:
from intercom.client import Client intercom_app_1 = Client("PAT_1") intercom_app_2 = Client("PAT_2") app_1_users = intercom_app_1.users.find() app_2_users = intercom_app_2.users.find()
As can be seen in that code snippet, to create the client you use a PAT (Personal Access Token) which you can create via the App Settings in Intercom. Previously an app id and an app key were used, but Intercom is removing support for these in January 2017.
The following are the full list of changes in version 3 thus far:
- Moved to new client based approach. #108