Pharos Docs

Intercom

Functional guide for configuring the Intercom Messenger integration in Pharos.

This guide explains the Intercom integration in Pharos from a functional point of view.

What Is This Integration

The Intercom integration adds the Intercom Messenger experience to Pharos-managed surfaces.

It allows your business to show a support or sales chat entry point directly inside supported Pharos pages.

When to Use It

Use Intercom when you want:

  • buyers to contact your team during checkout
  • customers to access chat in the customer portal
  • a consistent Messenger experience across the surfaces you enable

Prerequisites

Before configuring Intercom, make sure:

  • you have an Intercom workspace
  • you have the Intercom App ID for that workspace
  • you know which Pharos surfaces should display the Messenger

How to Configure It in Pharos

  1. Open the Intercom integration page in admin settings.
  2. Enable the integration.
  3. Enter the Intercom App ID.
  4. Choose the surfaces where Intercom should appear:
  • payments
  • customer portal
  1. Choose whether the default launcher should be shown.
  2. Choose the launcher alignment.
  3. Save the settings.

What Happens After It Is Enabled

After the integration is enabled:

  • Pharos loads the Intercom Messenger only on the selected surfaces
  • the launcher follows the alignment and visibility options you configured
  • Messenger stays disabled on surfaces you did not enable

How to Verify It Is Working

You can verify the setup by:

  • opening a supported Pharos surface you enabled
  • confirming the Messenger launcher appears
  • confirming it does not appear on disabled surfaces
  • starting a conversation from the enabled page

Limitations or Important Notes

  • this integration is focused on Messenger behavior inside Pharos surfaces
  • if the integration is enabled without a valid App ID, it is not fully configured
  • visibility is controlled per surface inside Pharos

Troubleshooting

If Intercom does not appear:

  • confirm the integration is enabled
  • confirm the App ID is correct
  • confirm the specific surface is enabled
  • confirm you are testing on a supported Pharos page rather than an unrelated page

Functional Summary

The Intercom integration lets your team expose Messenger support or sales chat directly inside Pharos checkout and customer portal experiences based on the surfaces you enable.