Connect your Intercom workspace to Goodweek to manage conversations, contacts, companies, and support tickets directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Intercom, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Intercom integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
⚠️ Intercom Admin required to connect
Only users with the Admin role in Intercom can authorize OAuth connections. Standard teammates (non-admin users) cannot complete the connection flow — they will see a permissions error when attempting to connect.
If your organization wants non-admin teammates to use the Intercom integration in Goodweek, an Intercom Admin must complete the connection on their behalf, or the Admin must first grant the teammate an Admin role in Intercom under Settings → Teammates → [teammate] → Role.
User Connection
In Goodweek, go to Integrations.
Find Intercom and click Connect.
You will be redirected to Intercom, where you will be asked to sign in and authorize access.
Click Authorize Access to grant access and return to Goodweek.
Important Notes
Each user must connect their own account individually.
The connecting user must have Admin permissions in Intercom.
Goodweek can only access the Intercom data that your individual account has permission to see within your workspace.
You can revoke Goodweek's access at any time from Intercom → Settings → Integrations → Installed apps → Composio → Remove.
Available Tools
Tool | Description | Type |
List Conversations | Retrieves a paginated list of conversations from the Intercom workspace. | Read |
Get Conversation | Retrieves a specific Intercom conversation by its ID including all message parts. | Read |
Search Conversations | Searches Intercom conversations using multiple filter criteria. | Read |
Reply to Conversation | Sends a reply to an existing Intercom conversation from an admin or the assigned teammate. | Write |
Add Note to Conversation | Adds an internal note to an Intercom conversation, visible only to teammates. | Write |
Assign Conversation | Assigns an Intercom conversation to a specific teammate or team. | Write |
Snooze Conversation | Snoozes an Intercom conversation until a specified time. | Write |
Close Conversation | Closes an open Intercom conversation. | Write |
Reopen Conversation | Reopens a closed Intercom conversation. | Write |
Create Conversation | Creates a new outbound Intercom conversation with a contact. | Write |
List Contacts | Retrieves a paginated list of contacts from Intercom. | Read |
Get Contact | Retrieves complete details for a specific Intercom contact by ID. | Read |
Search Contacts | Searches for Intercom contacts using multiple filter criteria. | Read |
Create Contact | Creates a new contact in Intercom. | Write |
Update Contact | Updates the attributes of an existing Intercom contact. | Write |
List Companies | Retrieves a paginated list of companies from the Intercom workspace. | Read |
Get Company | Retrieves complete details for a specific Intercom company by ID. | Read |
Search Companies | Searches for Intercom companies using filter criteria. | Read |
Create or Update Company | Creates a new company or updates an existing one in Intercom. | Write |
List Tags | Retrieves all tags available in the Intercom workspace. | Read |
Create Tag | Creates a new tag in the Intercom workspace. | Write |
Tag Conversation | Applies one or more tags to a specific Intercom conversation. | Write |
Tag Contact | Applies one or more tags to a specific Intercom contact. | Write |
List Articles | Retrieves all articles in the Intercom Help Center. | Read |
Get Article | Retrieves complete details for a specific Intercom Help Center article. | Read |
Create Article | Creates a new article in the Intercom Help Center. | Write |
Update Article | Updates an existing article in the Intercom Help Center. | Write |
Delete Contact | Permanently deletes a contact from Intercom. | ⚠️ Destructive |
Archive Contact | Archives a contact in Intercom. | ⚠️ Destructive |
Use Cases
Triage and reply to support conversations. Retrieve open conversations, check their history, add internal notes, assign them to teammates, or reply to customers directly from Goodweek.
Search and manage contacts and companies. Find contacts by email or attribute, update their details, and create or update company records from Goodweek.
Tag and organize conversations. Apply tags to conversations or contacts from Goodweek to classify inbound requests and route them correctly.
Create and update Help Center articles. Draft and publish new Help Center articles or update existing ones from Goodweek.
Troubleshooting
Permissions error when connecting
The account attempting to connect does not have Admin permissions in Intercom. Only Intercom Admins can authorize OAuth connections. Ask your Intercom Admin to complete the connection, or grant the user an Admin role in Intercom under Settings → Teammates → [teammate] → Role.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Intercom integration from the Goodweek Admin Panel under the Integrations tab.