Custom Actions allow you to build no-code integrations to get live data and take actions in your external systems. Store this response data in Intercom and use it to power Inbox automations via Workflows and Macros and set Custom Attributes on:
Standard Objects - User and Conversation.
Custom Objects - Your custom data types.
Using Custom Actions in the Inbox allows you to update data in Intercom and send data to external tools directly from your Inbox.
To use Custom Actions in the Inbox, you must have already set up a live Custom Action. If you haven't done so, refer to our guide on Setting up a Custom Action.
Using Custom Actions in Workflows
Navigate to the Workflows section by clicking on AI & Automation > Workflows.
Click New workflow or edit an existing Workflow.
Select Add step, then select Custom actions (using API).
Choose the desired Custom Action from the list of available actions.
Complete the Workflow path with any other actions you'd like to take.
Set live the new Workflow.
Example use case
You can use a Custom Action to create a new Jira issue whenever a Conversation meets certain criteria.
For example, you can set up a Workflow that triggers a Custom Action to create a new Jira issue whenever a Conversation is tagged with "Feature Request". The Custom Action can automatically populate the issue with the conversation details and assign it to a specific Jira project.
Using Custom Actions in macros
Navigate to Settings > Inbox > Macros.
Click New macro or edit an existing macro.
In the macro configuration, click Add an action and select Custom Actions (using API) from the dropdown menu.
Choose the desired Custom Action from the list of available actions.
Complete the macro configuration by defining conditions and other settings.
Save the macro.
Example use case
You can use a Custom Action to create a task in a project management tool, such as Asana, Trello or Jira, based on the content of the conversation or the customer's email domain. Then, you can include this Custom Action in a macro to easily create tasks and keep track of important action items.
Using Custom Actions with CMD + K
In the Inbox, select a Conversation where you want to apply a Custom Action.
Press
CMD + K(Mac) orCtrl + K(Windows) to open the command menu.Select Trigger custom action, type the name of the Custom Action you want to use and select it from the list.
The Custom Action will be executed, and any resulting data or updates will be applied.
Example use case
You can set up a Custom Action to create a calendar event in Google Calendar directly from the Intercom conversation using CMD + K . With a high volume of Conversations, this can be helpful for scheduling meetings with customers and keeping track of important dates.
Using Custom Actions in the Conversation Part actions
In the Inbox, open a Conversation and locate the specific Message for which you want to trigger a Custom Action.
Hover over the message and click on the three-dot menu icon that appears.
Select Trigger custom action from the list of available actions, type the name of the Custom Action you want to use and select it from the list.
The Custom Action will be executed, and any resulting data or updates will be applied.
Example use case
You can set up a Custom Action that updates a Salesforce record based on the content of a specific Conversation Part (message). This can help keep customer information current and ensure important details are captured in your Customer Relationship Management tool.
Custom Attributes updated by a Custom Action using macros and CMD + K might not be reflected in the Inbox until refreshed.
Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts