Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.
Supported fields for conversations: created_at, updated_at, source.type, state, open, read
Pagination
Most list endpoints use cursor-based pagination
Check response for pages.next with starting_after cursor
Pass cursor in pagination.starting_after for next page
Continue until pages.next is null
Admin ID Resolution
1. Call INTERCOM_LIST_ALL_ADMINS to get all admins
2. Find the desired admin by name or email
3. Use admin.id for replies, assignments, and state changes
Known Pitfalls
Admin ID Requirement:
Admin ID is required for: reply (as admin), assign, close, reopen
Always resolve admin IDs first with LIST_ALL_ADMINS
HTML Content:
Conversation bodies are HTML
Plain text is auto-wrapped in paragraph tags
Sanitize HTML input to prevent rendering issues
Idempotency:
Replies and conversation creation are not idempotent
Duplicate sends can occur on retry or timeout
Track message IDs to prevent duplicates
Rate Limits:
Default: ~1000 requests per minute (varies by plan)
429 responses include rate limit headers
Implement exponential backoff for retries
Quick Reference
Task
Tool Slug
Key Params
List conversations
INTERCOM_LIST_CONVERSATIONS
(pagination)
Search conversations
INTERCOM_SEARCH_CONVERSATIONS
query
Get conversation
INTERCOM_GET_CONVERSATION
id
Create conversation
INTERCOM_CREATE_CONVERSATION
from, body
Reply to conversation
INTERCOM_REPLY_TO_CONVERSATION
conversation_id, body, admin_id
Assign conversation
INTERCOM_ASSIGN_CONVERSATION
conversation_id, admin_id, assignee_id
Close conversation
INTERCOM_CLOSE_CONVERSATION
id, admin_id
Reopen conversation
INTERCOM_REOPEN_CONVERSATION
id, admin_id
Search contacts
INTERCOM_SEARCH_CONTACTS
query
Get contact
INTERCOM_GET_A_CONTACT
contact_id
Contact by external ID
INTERCOM_SHOW_CONTACT_BY_EXTERNAL_ID
external_id
List contacts
INTERCOM_LIST_CONTACTS
(pagination)
Contact tags
INTERCOM_LIST_TAGS_ATTACHED_TO_A_CONTACT
contact_id
Contact segments
INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_CONTACT
contact_id
Detach contact
INTERCOM_DETACH_A_CONTACT
contact_id, company_id
List admins
INTERCOM_LIST_ALL_ADMINS
(none)
Identify admin
INTERCOM_IDENTIFY_AN_ADMIN
admin_id
List segments
INTERCOM_LIST_SEGMENTS
(none)
Company segments
INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_COMPANIES
company_id
Get counts
INTERCOM_GET_COUNTS
type, count
List companies
INTERCOM_LIST_ALL_COMPANIES
page, per_page
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
