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

@VedranZoricic
Copy link
Contributor Author

@claude review PR

@VedranZoricic VedranZoricic requested a review from a team January 7, 2026 15:10
@VedranZoricic VedranZoricic enabled auto-merge (squash) January 7, 2026 15:33
VedranZoricic and others added 4 commits January 7, 2026 12:59
- 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]>
Remove the incorrectly added previous field from conversation_attribute_updated_by_workflow -
this feature was never implemented (PRs #432721 and #433432 were closed without merging).

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

Co-Authored-By: Claude <[email protected]>
@VedranZoricic VedranZoricic force-pushed the solid_road_conversation_parts_update branch from 5a20624 to ad08e87 Compare January 7, 2026 15:59
Copy link
Contributor

@VarshSuresh VarshSuresh left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:shipit:

@VedranZoricic VedranZoricic merged commit e98b779 into intercom:main Jan 7, 2026
3 checks passed
@VedranZoricic VedranZoricic deleted the solid_road_conversation_parts_update branch January 7, 2026 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants