feat(intercom): added additional params to intercom tools

[waleedlatif1]

Summary

• added additional params to intercom tools
• changed visibility for many existing params to user-or-llm so the llms can inject them at runtime as well

Type of Change

• Bug fix

Testing

Tested manually

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

referenced docs:

• https://developers.intercom.com/docs/references/rest-api/api.intercom.io/contacts/createcontact
• https://developers.intercom.com/docs/references/2.4/rest-api/contacts/contacts-model
• https://developers.intercom.com/docs/references/rest-api/api.intercom.io/models/create_message_request
• https://developers.intercom.com/docs/references/rest-api/api.intercom.io/tickets/createticket
• https://developers.intercom.com/docs/references/1.0/rest-api/companies/create-or-update-company
• https://developers.intercom.com/docs/references/2.1/rest-api/common-structures/pagination-search

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
docs	Ready	Preview, Comment	Dec 22, 2025 6:17pm

[greptile-apps]

Greptile Summary

Enhanced Intercom tools with additional API parameters and improved LLM runtime injection capabilities by changing visibility from user-only to user-or-llm for most parameters.

Key Changes:

• Added new parameters across multiple tools: role, avatar, signed_up_at, last_seen_at, owner_id, unsubscribed_from_emails, company_id for contacts
• Added remote_created_at for companies, created_at for messages/tickets/replies
• Added pagination and sorting parameters: starting_after, sort_field, sort_order for search and list operations
• Added display_as, include_translations for conversation retrieval
• Added admin_id, attachment_urls for conversation replies
• Changed visibility from user-only to user-or-llm to enable LLM runtime parameter injection
• Updated block configuration to include UI fields for all new parameters
• Cleaned up debug console.log statements in documentation generator

All parameters follow Intercom API documentation and include proper validation (JSON parsing with error handling for custom_attributes, contacts, etc.).

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• All changes are additive parameter additions that align with official Intercom API documentation. The visibility changes from user-only to user-or-llm follow the codebase pattern and enable better LLM integration. JSON parsing includes proper error handling, and all parameters are properly typed and validated.
• No files require special attention

Important Files Changed

Filename	Overview
apps/sim/tools/intercom/create_contact.ts	Added additional parameters (role, avatar, signed_up_at, last_seen_at, owner_id, unsubscribed_from_emails, company_id) with proper validation and user-or-llm visibility
apps/sim/tools/intercom/update_contact.ts	Added matching parameters to update_contact tool for consistency with create_contact
apps/sim/tools/intercom/create_ticket.ts	Added company_id, created_at, conversation_to_link_id, and disable_notifications parameters with user-or-llm visibility
apps/sim/tools/intercom/search_contacts.ts	Added pagination parameters (per_page, starting_after) and sorting parameters (sort_field, sort_order) with user-or-llm visibility
apps/sim/blocks/blocks/intercom.ts	Added UI fields for all new parameters with proper conditional rendering

Sequence Diagram

sequenceDiagram
    participant User
    participant LLM
    participant IntercomTool
    participant IntercomAPI
    
    User->>IntercomTool: Configure parameters
    Note over User,IntercomTool: Parameters now have<br/>user-or-llm visibility
    
    alt LLM can inject parameters
        LLM->>IntercomTool: Inject runtime values<br/>(role, timestamps, etc.)
    end
    
    IntercomTool->>IntercomTool: Validate & parse JSON fields<br/>(custom_attributes, contacts, etc.)
    
    IntercomTool->>IntercomAPI: POST/PUT/GET with params
    Note over IntercomAPI: New parameters: role, avatar,<br/>signed_up_at, owner_id,<br/>company_id, sort_field, etc.
    
    IntercomAPI-->>IntercomTool: Response
    IntercomTool-->>User: Formatted output

Loading