intercom

What This Skill Does

The Intercom skill for OpenClaw provides a robust interface for interacting with the Intercom customer messaging platform directly through your AI agent. It enables seamless management of customer relations, support conversations, and lead data. By leveraging this skill, you can programmatically fetch contact lists, perform precise searches to identify specific users, create new contact profiles, send automated messages, and manage ticket responses. It effectively turns your AI agent into a full-featured support operations assistant, reducing the need for manual navigation of the Intercom dashboard.

Installation

To integrate this skill into your environment, use the OpenClaw CLI tool. Ensure you have your Intercom API access token ready.

1. Run the install command: clawhub install openclaw/skills/skills/mrgoodb/intercom
2. Set your environment variable: export INTERCOM_ACCESS_TOKEN="your_access_token_here"
3. Restart your agent or refresh the skills configuration to enable the new endpoints.

Use Cases

This skill is designed for Customer Success and Support teams who need to scale their response times. Use it to:

• Automate triage by searching for contacts based on email and triggering personalized welcome messages.
• Sync lead data from other systems into your Intercom workspace without switching contexts.
• Provide fast, informed replies to ongoing customer conversations by having the AI scan previous interactions.
• Manage help desk queues by monitoring conversation lists in real-time.

Example Prompts

• "Search for the user with email '[email protected]' and create a new contact profile if they don't exist yet."
• "List the last five open conversations in our support inbox and summarize the pending issues."
• "Reply to conversation ID '12345' with: 'Thanks for reaching out! We are currently investigating your issue and will get back to you shortly.'"

Tips & Limitations

• Security: Ensure that your INTERCOM_ACCESS_TOKEN is stored in a secure secret manager and never hardcoded into your workflows.
• Rate Limiting: Intercom imposes API rate limits. If you are running high-volume automated tasks, implement retries in your logic to avoid 429 errors.
• Permissions: Ensure the API token generated has sufficient scope (permissions) to perform the specific actions (e.g., 'read_conversations' vs 'write_contacts').
• Admin IDs: For replying to conversations, you must ensure the admin_id provided matches an active admin in your Intercom workspace.