Intercom Elixir Save

Elixir helpers for generating the Intercom snippet and interacting with the Intercom API

Project README

Intercom snippet

Intercom can be installed in your web app to help you chat to logged-in and logged-out users.

Full configuration options can be found here.

require Intercom

# Generate the full Intercom snippet
  %{email: "[email protected]"}, # Key value pairs identifying your user.
  app_id: "<your app id>", # Your app's identifier.
  secret: "<your secret key>" # Your app's secret key. This enables secure mode

For example, this shows how to generate the web snippet in a Phoenix web app:

defmodule HelloPhoenix.PageController do
  use HelloPhoenix.Web, :controller
  require Intercom

  plug :intercom

  def index(conn, _params) do
    # Intercom injectable via <%= raw @intercom %>
    render conn, "index.html"

  defp intercom(conn, _params) do
    {:ok, snippet} = Intercom.snippet(
      %{email: "[email protected]"},
      app_id: "<your app id>",
      secret: "<your secret>"
    assign(conn, :intercom, snippet)

Intercom REST API:

The Intercom REST API provides full access to Intercom resources. This library provides a thin wrapper over httpoison:

require Intercom.Client


  hackney: Intercom.Client.auth("<personal access token>", "")

If you already have an access token you can find it here. If you want to create or learn more about access tokens then you can find more info here

If you are building a third party application you will need to use OAuth by following the steps in setting-up-oauth for Intercom.

Pull Requests

  • Add tests! Your patch won't be accepted if it doesn't have tests.

  • Document any change in behaviour. Make sure the README and any other relevant documentation are kept up-to-date.

  • Create topic branches. Don't ask us to pull from your master branch.

  • One pull request per feature. If you want to do more than one thing, send multiple pull requests.

  • Send coherent history. Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please squash them before sending them to us.

Open Source Agenda is not affiliated with "Intercom Elixir" Project. README Source: intercom/intercom-elixir
Open Issues
Last Commit
9 months ago

Open Source Agenda Badge

Open Source Agenda Rating