Skip to content

Commit 88b8d79

Browse files
committed
Scaffold docs for Intercom Web and Cloud Actions
1 parent 041d643 commit 88b8d79

File tree

2 files changed

+88
-0
lines changed
  • src/connections/destinations/catalog

2 files changed

+88
-0
lines changed
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Intercom Cloud Mode (Actions) Destination
3+
hide-boilerplate: true
4+
hide-dossier: false
5+
hidden: true
6+
id: 62ded0cf5753c743883ca0f3
7+
versions:
8+
- name: 'Intercom Web (Actions)'
9+
link: '/docs/connections/destinations/catalog/actions-intercom-web'
10+
- name: 'Intercom (Classic)'
11+
link: '/docs/connections/destinations/catalog/intercom'
12+
---
13+
14+
{% include content/plan-grid.md name="actions" %}
15+
16+
Intercom is a customer communications platform. It shows you who is using your product and makes it easy to personally communicate with your users with targeted content, behavior-driven messages, and conversational support.
17+
18+
When you use the Intercom Cloud Mode (Actions) destination, Segment will send your data to [Intercom's REST API](https://developers.intercom.com/building-apps/docs/rest-apis){:target="_blank"}.
19+
20+
> info ""
21+
> The Intercom Cloud Mode (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
22+
23+
## Benefits of Intercom Cloud Mode (Actions) vs Intercom Classic
24+
Intercom Cloud Mode (Actions) provides the following benefits over the classic Intercom destination:
25+
26+
- **Fewer settings.** Data mapping for actions-based destinations happens during configuration, which eliminates the need for most settings.
27+
- **Clearer mapping of data.** Actions-based destinations enable you to define the mapping between the data Segment receives from your source, and the data Segment sends to the destination.
28+
- **Granular control over data sent.** You can customize the conditions under which the events will be sent to Intercom.
29+
- **Support for lead creation.** You can now create contacts with a role of `lead`, associate them with a company, send events for them, and convert them to a `user`.
30+
31+
32+
## Getting Started
33+
34+
1. From the Segment web app, click **Catalog**.
35+
2. Search for **Intercom Cloud Mode (Actions)** in the Destinations Catalog, and select the destination.
36+
3. Click **Configure Intercom Cloud Mode (Actions)**.
37+
4. Select the source that will send data to Intercom Cloud Mode (Actions) and follow the steps to name your destination.
38+
5. On the **Settings** tab, authenticate with Intercom using OAuth.
39+
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
40+
7. Enable the destination and configured mappings.
41+
42+
{% include components/actions-fields.html settings="true"%}
43+
44+
{% include components/actions-fields.html%}
45+
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: Intercom Web (Actions) Destination
3+
hide-boilerplate: true
4+
hide-dossier: false
5+
hidden: true
6+
id: 62d9daff84a6bf190da9f592
7+
versions:
8+
- name: 'Intercom Cloud Mode (Actions)'
9+
link: '/docs/connections/destinations/catalog/actions-intercom-cloud'
10+
- name: 'Intercom (Classic)'
11+
link: '/docs/connections/destinations/catalog/intercom'
12+
---
13+
14+
{% include content/plan-grid.md name="actions" %}
15+
16+
Intercom is a customer communications platform. It shows you who is using your product and makes it easy to personally communicate with your users with targeted content, behavior-driven messages, and conversational support.
17+
18+
When you use the Intercom Web (Actions) destination, Segment will load the [Intercom JavaScript library](https://developers.intercom.com/installing-intercom/docs/intercom-for-web){:target="_blank"} for you. The Intercom library enables you to track your user’s events on your website and interact with the Intercom messenger window.
19+
20+
> info ""
21+
> The Intercom Web (Actions) destination is in beta and is in active development. Some functionality may change before it becomes generally available.
22+
23+
## Benefits of Intercom Web Mode (Actions) vs Intercom Classic
24+
Intercom Web (Actions) provides the following benefits over the classic Intercom destination:
25+
26+
- **Fewer settings.** Data mapping for actions-based destinations happens during configuration, which eliminates the need for most settings.
27+
- **Clearer mapping of data.** Actions-based destinations enable you to define the mapping between the data Segment receives from your source, and the data Segment sends to the destination.
28+
- **Granular control over data sent.** You can customize the conditions under which the events will be sent to Intercom.
29+
- **Selectively show the Intercom chat widget.**
30+
31+
## Getting Started
32+
33+
1. From the Segment web app, click **Catalog**.
34+
2. Search for **Intercom Web (Actions)** in the Destinations Catalog, and select the destination.
35+
3. Click **Configure Intercom Web (Actions)**.
36+
4. Select the web source that will send data to Intercom Web (Actions) and follow the steps to name your destination. The web source chosen must use [Analytics.js 2.0](/docs/connections/sources/catalog/libraries/website/javascript/).
37+
5. On the **Settings** tab, input your Intercom App ID and other destination settings.
38+
6. Follow the steps in the Destinations Actions documentation on [Customizing mappings](/docs/connections/destinations/actions/#customizing-mappings).
39+
7. Enable the destination and configured mappings.
40+
41+
{% include components/actions-fields.html settings="true"%}
42+
43+
{% include components/actions-fields.html%}

0 commit comments

Comments
 (0)