Integrating with Intercom

Before you begin

To integrate your assistant with Intercom, contact your administrator for support.

One-time agent creation

You or someone in your organization must complete these one-time prerequisite steps before you add the Intercom integration to your assistant.

1. Create a functional email account for your assistant.

   Each assistant must have a valid, unique email address before it can be added to a team in Intercom.

2. From your Intercom workspace, add the assistant to your team as a new agent.

   Go to the teammate settings page in your Intercom workspace, invite the assistant as a new agent by adding the email you created in the previous step to the invite field.

   If you don't have an Intercom workspace set up yet, create one at www.intercom.com. At a minimum, you need a subscription to the Inbox product from Intercom to be able to create a workspace.

3. From the assistant email account you created earlier, find the invitation from Intercom. Click the link in the email to join the team. Sign up using the assistant's functional email address, and then join the team.

4. Optional: Update the profile for your assistant.

   You can edit the name and profile picture for your assistant. This profile represents the assistant in private agent communications within your workspace, and in public interactions with customers through your Intercom apps. Create a profile that reflects your brand.

   Click the Intercom profile icon in the navigation bar to access profile and workspace settings.

Preparing the dialog

Complete these steps in your dialog skill so the assistant can handle user requests, and can pass the conversation to a live agent when a customer asks for one.

1. Add an intent to your skill that can recognize a user's request to speak to a live agent.

   You can create your own intent or add the prebuilt intent that is named #General_Connect_to_Agent that is provided with the General content catalog that is developed by IBM.

2. Add a root node to your dialog that conditions on the intent that you created in the previous step. Choose Connect to human agent as the response type.

3. Prepare each dialog branch to be triggered by the assistant from the Intercom app.

   Every root dialog node in the dialog can be processed by the assistant while it is functioning as an Intercom teammate, including root nodes in folders. You specify the action that you want the assistant to take for each dialog branch later when you configure the Intercom integration. Therefore, although you cannot hide a node from Intercom, you can configure the assistant to do nothing when the node is triggered.

   Complete the following fields of the root node of each dialog branch:

   • Node name: Give the node a name. This name is how you identify the node when you configure interactions for it later. If you don't add a name, you must choose the node based on its node ID instead.

   • External node name: Add a summary of the purpose of the dialog branch. For example, Find a store.

     This information is shown to other agents on the assistant's team when the assistant offers to answer a user query. If there is more than one node that can address the query, the assistant shares a list of responses with live agents to get their advice about which response to use.

     Do not add an external node name to the root node that you created in Step 2. When an escalation occurs, your assistant looks at the external node name of the last processed node to learn which user goal was not met successfully. If you include an external node name in the node with the connect to live agent intent, then you prevent your assistant from learning the last goal-oriented node that the user interacted with before they escalated the issue.

4. If a child node in the branch conditions on a follow-up request or question that you do not want the assistant to handle, add a Connect to human agent response type to the node.

   For example, you might want to add this response type to nodes that cover sensitive issues only a live agent can handle or that track when an assistant repeatedly fails to understand a user.

   At run time, if the conversation reaches this child node, the dialog is passed to a live agent at that point. Later, when you set up the Intercom integration, you can choose a live agent as a backup for each branch.

Your dialog is now ready to support your assistant in Intercom.

Adding an Intercom integration

1. From the Assistants page, click to open the assistant tile that you want to deploy.

2. From the Integrations section, click Add integration.

3. Click Intercom.

   Follow the instructions that are provided on the screen. The following sections help you with the steps.

Connecting the assistant to Intercom

As soon as you give Intercom permission to use the assistant, the assistant becomes a viable member of the Intercom team.

Live agents can assign messages to the assistant by using Intercom's assignment rules. Messages can be assigned to the assistant in the following ways:

• Automatic assignment of inbound conversations to a teammate or team inbox based on some criteria

• Manual reassignment is made by a live agent at run time.

1. When your dialog is ready, click Connect now.

2. Click Access Intercom to be redirected to the Intercom site.

   Log in to Intercom by using the assistant's functional email address and password, not your own. You want to establish the connection to a functional ID that is shared by more than one person in your organization.

3. Click Authorize access.

4. Click Back to overview.

Configuring message routing

Assign teammates as backups for the assistant in case the assistant needs to transfer an in-progress conversation to a live agent. You can choose a different team or teammate to be the backup contact for each dialog branch.

To set up routing assignments for escalations from the assistant to a live agent, complete the following steps:

1. From the Intercom integration page, click My Dialog Skill is ready to confirm that you prepared your dialog, if you completed the Preparing the dialog procedure.

2. In the Settings section, click Manage rules.

   If you make no changes, the backup contact for all of the nodes remains unassigned.

3. Click New rule.

4. From the Choose node list, choose the node for the dialog branch you want to configure.

   Remember, branches are identified by their node name. If you did not specify a node name, then the node's ID is displayed instead.

5. Choose the team or live agent to be the backup contact for this dialog branch. The user query is escalated to this person if the assistant cannot answer the query or uses a child node with a Connect to human agent response type.

6. To define routing rules for other dialog branches, click New rule again, and repeat the previous steps.

   Don't forget to set up an assignment for any root nodes that have a Connect to human agent response type in a child node in their branch. If you do not transfer the associated root node to a specific person or team, a sensitive matter can be transferred to the Unassigned inbox.

7. After you add rules, click Return to overview to exit the page.

Give the assistant permission to monitor and answer user queries

When you want the assistant to start monitoring an Intercom inbox, and answering messages on its own, turn on monitoring.

Your assistant watches user inquiries as they are logged in Intercom. When the assistant is confident that it knows how to answer a user query, the assistant responds to the user directly. (The assistant is confident when the top intent that is identified by your assistant has a confidence score of 0.75 or higher.)

If you do not want the assistant to answer certain types of user queries, then you can add rules to specify other actions for the assistant to take per dialog branch. For example, you might want to start incorporating the assistant into the team conservatively, allowing the assistant to suggest responses as it transfers user messages to other teammates. Over time, after the assistant proves itself, you can give it more responsibility.

To configure how you want the assistant to handle specific dialog branches, define rules.

1. From the Intercom integration page, in the Enable your assistant to monitor an inbox section, switch monitoring On.

2. In Settings, click Manage rules.

   If you do not define rules, the assistant is configured to monitor the Unassigned inbox and automatically answer user inquiries that it is confident it can address.

3. From the Monitor Intercom inbox field, choose the Intercom inbox that you want the assistant to monitor.

4. Click New rule to define a unique interaction pattern for a specific dialog branch.

5. From the Choose node list, choose the node for the branch you want to configure.

   Remember, branches are identified by their node name. If you did not specify a node name, then the node's ID is displayed instead.

6. Pick the type of action that you want the assistant to do when this dialog node is triggered. The action type options are:

   • Do nothing: The assistant is not involved in the response. The user's message remains in the inbox for someone else to address.

   • Send to team or teammate: The assistant evaluates the user input to determine its goal, and then transfers it to the appropriate teammate.

   • Suggest to team or teammate: The assistant provides the teammate with suggestions for how to respond by sharing notes with the live agent through the internal Intercom app.

     • If the user input triggers a dialog branch, meaning a root dialog node with child nodes that represents a comprehensive interaction, then the assistant indicates that it can address the request, and offers to do so.
     • If the user input triggers a root node with no children, then the assistant shares the programmed response with the live agent, but doesn't respond directly to the user.
     • If the input triggers more than one dialog node with high confidence, the assistant provides the live agents a list of possible responses and asks the teammate to choose the best response.

     In every case, the live agent decides whether to let the assistant take over.

   • Answer: The assistant responds to the user directly, without conferring with any other teammates.

   Teammate involvement is required for any nodes to which you assign the Send to team or teammate or Suggest to team or teammate action types. Be sure to go back and add a rule that assigns the right person or team as the backup for this dialog node in particular.

7. To define unique interaction settings for other dialog branches, click New rule again, and repeat the previous steps.

8. After you add rules, click Return to overview to exit the page.

Testing the integration

To effectively test your Intercom integration from end-to-end, you must have access to an Intercom application. The workspace must have an associated user interface client. If it does not, see How do I create an app? for help with setting one up.

Submit test user queries through a client application that is associated with your Intercom workspace to see how the messages are handled by Intercom. Verify that messages that are meant to be answered by the assistant are generating the appropriate responses, and that the assistant is not responding to messages that it is not configured to answer.