How to manage Zeus AI Intercom Integration
Last updated September 17, 2026
Overview
The Intercom integration allows administrators to connect Zeus AI with their Intercom workspace to automate ticket triage and customer response workflows. By analyzing incoming conversations against defined rules, protocols, and filtering criteria, Zeus AI can independently draft or deliver responses, route escalated conversations to the right team members, and keep ticket metadata up to date.
Key features
- Active Response Mode: Enables Zeus AI to process and respond to incoming Intercom conversations in real time based on custom triggering criteria.
- Ticket Filtering: Restricts automated actions to specific admin bot IDs, assigned team members, or targeted ticket tags.
- Automated Escalation Handling: Automatically reassigns unhandled or complex tickets to designated individual users or teams and adjusts tags accordingly.
- Context-Aware AI Protocols: Generates responses guided by predefined brand tones, knowledge sources, and platform protocols.
How to connect Intercom
Intercom is a customer communication platform where teams manage conversations in shared inboxes. The Intercom integration allows Zeus AI to connect to your Intercom inbox and work with those conversations.
Important: Before getting started, make sure you have the required Intercom credential and secret ("API Token" and "Client Secret").
- Go to " Zeus AI > Platform > Intercom ".
- Enter the "Intercom API Token".
- Enter the "Intercom Client Secret".
- Click "Connect".
Important: •Ensure you enter the correct credentials. If the connection cannot be established, verify that the "Intercom API Token" is correct and try connecting again. •The "Intercom Client Secret" is a webhook secret credential used to verify that webhook requests claiming to come from Intercom are authentic.
Response Modes
- Select the "Response Modes" for Zeus AI:
- "Read-Only Mode": Zeus AI generates responses for QA and preview purposes, no live replies are sent. Or
- "Active Response Mode": Zeus AI actively responds to Intercom tickets based on assigned rules and filters.
Important: The "Ticket Filter" and "When ticket is Escalated" sections are enabled only when "Active Response Mode" is turned on.
When ticket is Escalated
- In the "When ticket is Escalated" section, specify the automatic actions Zeus AI should take whenever an Intercom ticket is escalated:
- "Assign to a specific team": Route the escalated ticket directly to a designated team's queue.
- "Assign to an individual user": Direct the ticket to a specific team member for immediate handling.
- "Add tags to ticket": Automatically apply tags to categorize escalated tickets.
- "Remove tags from ticket": Clear existing tags that no longer apply once a ticket escalates.
Important: The "Ticket Filter" and "When ticket is Escalated" sections are enabled only when "Active Response Mode" is turned on.
Ticket Filter
- In the "Ticket Filter" section, specify the criteria Zeus AI should use to filter which incoming Intercom tickets to answer:
- "Bot Admin ID": Select the specific admin bot identification to only process Intercom tickets associated to that bot.
- "Ticket assigned to users": Select individual users to only process Intercom tickets assigned to them.
- "Ticket tagged with": Select specific tags to only process Intercom tickets that contain those tags.
- Click "Save" to update the settings.
Danger zone
The "Danger zone" section contains the option to disconnect the Intercom integration. Use the "Disconnect" option only if you want to remove the existing Intercom connection.
Important: After disconnecting Intercom, Zeus AI will no longer be able to process Intercom conversations through that integration.
FAQs & Troubleshooting
Which Intercom tickets will Zeus AI process when Active Response Mode is enabled?
Zeus AI only processes tickets that match all conditions defined under your "Ticket Filter" settings in " Zeus AI > Platform > Intercom " (e.g., specific tags, assigned users, or bot admin IDs).
What happens if Zeus AI cannot answer a customer query in Intercom?
If Zeus AI is unable to answer a customer query, it stops automated replies and executes the predefined "When ticket is Escalated" actions configured in " Zeus AI > Platform > Intercom ".
Does Zeus AI update existing Intercom tickets tags during an escalation?
Yes. Zeus AI automatically adds new tags and removes outdated ones according to the configured settings in " Zeus AI > Platform > Intercom ".
Why is Zeus AI not responding to incoming Intercom tickets?
The incoming ticket metadata likely does not match your active "Ticket Filter" parameters in " Zeus AI > Platform > Intercom ". Verify that the Intercom ticket's tags, assigned user, or Bot Admin ID match your exact filter configuration.
What is the difference between Read-Only Mode and Active Response Mode?
"Read-Only Mode" allows you to preview Zeus AI generated responses for testing and QA without sending replies to customers. "Active Response Mode" allows Zeus AI to send live replies directly to Intercom tickets.
How does Zeus AI filter which tickets to answer?
Zeus AI filters incoming tickets based on the selected Bot User ID under the "Ticket Filter" settings.
What happens when a ticket escalates?
You can configure Zeus AI to automatically reassign the ticket to a designated group or individual user, as well as add or remove specific tags.
The Intercom integration show the error: failed to fetch Intercom data
Verify that the Intercom "API Token" and "Intercom Client Secret" are correctly entered in the "Integration Setup" fields.
Zeus AI is not sending replies to the Intercom tickets
- Ensure the Intercom integration is connected
- Ensure "Active Response Mode" is toggled on
- Also verify that a valid user is selected in the "Bot Admin ID" dropdown.
Can I disconnect Intercom?
Yes. Use the option in the "Danger zone" section to disconnect the Intercom integration. Once disconnected, Zeus AI will no longer process conversations through that connection.