Connect any messaging channel to Intercom
You can use 1) Intercom's live chat on the web, or 2) any of Meya's supported messaging apps like Messenger, Kik, Slack, Telegram, etc.
- Sign up for Intercom
- Create a user that will act as your bot (this can be a new user or someone else on your team)
- Authorize your Meya account to use your Intercom account (click "Connect" button)
- Select the admin that will be acting as your bot (the Intercom team member you previously created)
Use an Intercom TEST app while your bot is still in development. See Intercom's docs on how to setup a test app.
If your user is connecting via Intercom's live chat web widget, Meya will pre-populate some user data accessible to your bot.
Your data stored in the user scope database will automatically be synced with your Intercom user profile. The special field "source" will include the messaging channel used (eg. "messenger" or "slack")
User scope data auto-synced to Intercom
You can assign the conversation using the
By agent ID:
By agent name:
assignee: "Elon Musk"
By team name:
Text to display to the user.
Private text only the agent will see. Markdown is supported.
The five tabs in the code block below demonstrate different ways of assigning the chat using
- Assign by agent name
- Assign by agent ID
- Assign to random team
- Assign by team name
- Assign to random agent
states transfer componenthuman.transfer properties text"I'm getting an agent for you. This may take a few minutes." assignee"Inigo Montoya" note"The chat has been transferred to Inigo Montoya!"
states transfer componenthuman.transfer properties text"I'm getting an agent for you. This may take a few minutes." assignee41400 note"The chat has been transferred to you!"
states transfer componenthuman.transfer properties text"I'm getting an agent for you. This may take a few minutes." assignee"team" note"The chat has been transferred to your team!"
states transfer componenthuman.transfer properties text"I'm getting an agent for you. This may take a few minutes." assignee"team:Success" note"The chat has been transferred to the Success team!"
states transfer componenthuman.transfer properties text"I'm getting an agent for you. This may take a few minutes." assigneeadmin note"The chat has been transferred to you!"
When assigning the conversation to a human teammate or team, the bot will pause itself and leave a note confirming that it's been paused. Conversely, if you assign the conversation to the bot agent or "Nobody" the bot will unpause.
Pausing the bot by assigning to a human.
From your Intercom integration you can adjust the default assignment behaviors:
Bot response rules
- Silence on human assignment: Silence bot once assigned to teammate or team.
- Silence when unassigned: Silence bot when conversation is unassigned to "Nobody".
- Cancel active flows: Cancel active flows when assigned to an agent. If this is turned off, users can resume existing flows once agent has assigned back to bot
- Send notes: Send a note "Bot is paused" or "Bot is active" when the conversation is assigned.
Tip: pair bot silencing with Intercom Resolve Rules
It's possible to have the bot conditionally respond based on Intercom rules: 1) silence the bot when unassigned or assigned to a human. 2) add one or more rules that automatically assign the conversation to the bot based on user attributes.
You can have the bot selectively respond when pairing with Intercom Resolve rules and Bot silencing
Agents can initiate bot flow by using "slash commands" within the note section. For example, by entering "/hello_world" in the note section, the bot will:
- unpause and assign the conversation to itself
- start the flow named "hello_world"
- leave a note confirming the flow has started
Control your bot via /slash command notes
If no Meya flow exists matching the Slash command the bot will leave a note "❌ Error: Flow not found."
Your customer agents can respond to your users for both Intercom live chat and any of Meya's messaging channels.
When responding to third party messaging channels, your users may not know when a human vs. a bot is speaking. Depending on your use-case you may want to have your human agents identify themselves by name in text.
Agent's can respond to any messaging channel.
In Messenger, the agent text will be indistinguishable from bot text.
If the Intercom API is slow to respond, you may get a
A SoftTimeLimitExceeded error.
These errors appear when the Intercom API doesn't respond within 3 seconds. If this happens regularly, you may request an increased timeout limit by contacting email@example.com. Note that your request may not be approved.