Skip to content

Conversation

VedranZoricic
Copy link
Contributor

@VedranZoricic VedranZoricic commented Oct 3, 2025

Context

Summary

This PR adds comprehensive event_details documentation for conversation parts in the unstable API version (descriptions/0/api.intercom.io.yaml), implementing changes from SolidRoad feature requests.

Changes

New Conversation Part Schemas (9)

Tags, Snooze, and Priority (from #428476)

  • conversation_tags_updated - Tracks tags added/removed from conversations
  • snoozed - Captures snooze duration with human-readable format and custom timestamp
  • priority_changed - Documents priority state transitions (priority/not_priority)

SLA Events (from #430980)

  • conversation_sla_applied_by_rule - SLA applied via modern Operator workflows with target definitions
  • conversation_sla_applied_by_workflow - SLA applied via legacy Inbox Rules with target definitions
  • conversation_sla_target_missed - Complete SLA breach details including which target was missed and all target states
  • conversation_sla_paused - SLA status snapshot at pause time with remaining seconds for each target
  • conversation_sla_unpaused - Basic SLA information when conversation is unpaused
  • conversation_sla_removed - SLA information when removed from conversation

Updated Schemas (3)

Attribute Updates with Previous Value Tracking (from #430942)

  • conversation_attribute_updated_by_admin - Added previous field to track CDA value history
  • conversation_attribute_updated_by_workflow - Added previous field to track CDA value history
  • conversation_attribute_updated_by_user - New schema for user-initiated attribute updates with previous field

event_details Schema Updates

Updated the event_details anyOf array to include references to all 10 new/updated conversation part schemas.

Related Issues

  • intercom/intercom#428476 (Parent issue - SolidRoad feature requests)
  • intercom/intercom#430980 (SLA-related event parts)
  • intercom/intercom#430942 (Attribute update events with previous values)

Test Plan

  • Validate OpenAPI spec syntax
  • Verify all schema references are correct
  • Confirm examples match expected data structures
  • Test generated documentation renders properly

🤖 Generated with Claude Code

- Add 9 new conversation part schemas with event_details:
  - conversation_tags_updated (tags added/removed)
  - snoozed (snooze timing with custom_until_time)
  - priority_changed (current/previous priority states)
  - conversation_sla_applied_by_rule (SLA with definition)
  - conversation_sla_applied_by_workflow (SLA with definition)
  - conversation_sla_target_missed (SLA breach with states)
  - conversation_sla_paused (SLA pause status)
  - conversation_sla_unpaused (SLA unpause)
  - conversation_sla_removed (SLA removal)

- Add conversation_attribute_updated_by_user schema with previous value tracking

- Update existing attribute update schemas with previous field:
  - conversation_attribute_updated_by_admin
  - conversation_attribute_updated_by_workflow

Related to intercom/intercom#428476, #430980, #430942

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant