Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Django integration for Intercom API

Project Description

Django integration for Intercom API

The aa-intercom package allows to

  • upload user data to Intercom including the last seen feature
  • push data to the Intercom API according to any event happening in your app


To use, add aa_intercom to your INSTALLED_APPS, and then migrate the project.

Setting up models

aa-intercom requires a few fields in the user model to be set. To make it work, you need to apply the aa_intercom.mixins.IntercomUserMixin to your custom user model (if you do not have your own custom user model set, check the documentation). The IntercomUserMixin.get_intercom_data() method can be overloaded to change the default user data sent to the Intercom API.

If you want to use the user last seen feature on Intercom, execute the following task right after the user logs in:

from aa_intercom.tasks import push_account_last_seen_tasks
push_account_last_seen_task.apply_async(args=[], countdown=100)


Another step is to add event types to project settings, for example:

  ("example", _("Example Type")),
  ("generic", _("Generic Type"))

The last thing is to specify Intercom credentials in project settings:

INTERCOM_API_ACCESS_TOKEN = "your access token"

Make sure, you have the CACHES set (see: docs), and also as this app uses Celery, you need to have it configured.

To provide id prefix for Intercom user id, set INTERCOM_ID_PREFIX to desired value.

Using the IntercomEvent model

If you want to send any kind of event data to the Intercom API, create an instance of IntercomEvent filled with desired information, for example:

  user=request.user, type="generic", text_content=post.content,

Then it will be automatically sent to the Intercom API. Unfortunately Intercom API has a tendency to go down often, therefore to make sure all events will be sent, setup a cronjob running the resend_intercom_events command which will push all remaining IntercomEvent objects to the API.

Sending unregistered user data

In case an upload of unregistered user data is needed, the aa_intercom.tasks.push_not_registered_user_data_task task can be used (email and name keys are required), for example:

  "email": "",
  "name": "Foo Bar",
  "pseudonym": "foobar"


  • resend_intercom_events - resends all events (in case something went wrong, should be run chronically)


  • Django 1.11
  • Python 2.7, 3.6
Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
aa_intercom-1.0.1-py2.py3-none-any.whl (17.0 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Jun 12, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting