Skip to content

Commit 460affa

Browse files
VedranZoricicclaude
andcommitted
Add conversation part event details for SolidRoad feature requests
- 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 <noreply@anthropic.com>
1 parent 0fc8273 commit 460affa

File tree

1 file changed

+259
-2
lines changed

1 file changed

+259
-2
lines changed

descriptions/0/api.intercom.io.yaml

Lines changed: 259 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20136,8 +20136,13 @@ components:
2013620136
properties:
2013720137
name:
2013820138
type: string
20139-
description: Value of the CDA updated
20139+
description: Current value of the CDA updated
2014020140
example: vip_status
20141+
previous:
20142+
type: string
20143+
nullable: true
20144+
description: Previous value of the CDA (null for older events)
20145+
example: regular_status
2014120146
conversation_attribute_updated_by_admin:
2014220147
title: Part type - conversation_attribute_updated_by_admin
2014320148
type: object
@@ -20155,8 +20160,44 @@ components:
2015520160
properties:
2015620161
name:
2015720162
type: string
20158-
description: Value of the CDA updated
20163+
description: Current value of the CDA updated
2015920164
example: PROJ-007
20165+
previous:
20166+
type: string
20167+
nullable: true
20168+
description: Previous value of the CDA (null for older events without this data)
20169+
example: PROJ-006
20170+
conversation_attribute_updated_by_user:
20171+
title: Part type - conversation_attribute_updated_by_user
20172+
type: object
20173+
description: Contains details about Custom Data Attributes (CDAs) that were modified by a user for conversation part type <code>conversation_attribute_updated_by_user</code>.
20174+
properties:
20175+
user:
20176+
type: object
20177+
properties:
20178+
name:
20179+
type: string
20180+
description: Email of the user who updated the attribute
20181+
example: john@example.com
20182+
attribute:
20183+
type: object
20184+
properties:
20185+
name:
20186+
type: string
20187+
description: Name of the CDA updated
20188+
example: Priority
20189+
value:
20190+
type: object
20191+
properties:
20192+
name:
20193+
type: string
20194+
description: Current value of the CDA updated
20195+
example: High
20196+
previous:
20197+
type: string
20198+
nullable: true
20199+
description: Previous value of the CDA (null for older events)
20200+
example: Medium
2016020201
custom_action_started:
2016120202
title: Part type - custom_action_started
2016220203
type: object
@@ -20281,15 +20322,231 @@ components:
2028120322
type: string
2028220323
description: Result of the workflow event
2028320324
example: Finsihed waiting
20325+
conversation_tags_updated:
20326+
title: Part type - conversation_tags_updated
20327+
type: object
20328+
description: Contains details about tags that were added or removed from a conversation for conversation part type <code>conversation_tags_updated</code>.
20329+
properties:
20330+
tags_added:
20331+
type: array
20332+
items:
20333+
type: string
20334+
description: Array of tag names that were added
20335+
example: ["feature-shopify-multi-store", "second-tag"]
20336+
tags_removed:
20337+
type: array
20338+
items:
20339+
type: string
20340+
description: Array of tag names that were removed
20341+
example: ["feature-embercom-app-serializer-limit-external-plans"]
20342+
snoozed:
20343+
title: Part type - snoozed
20344+
type: object
20345+
description: Contains details about conversation snooze timing for conversation part type <code>snoozed</code>.
20346+
properties:
20347+
until:
20348+
type: string
20349+
description: Human-readable description of snooze duration
20350+
example: "until tomorrow"
20351+
custom_until_time:
20352+
type: string
20353+
format: date-time
20354+
nullable: true
20355+
description: ISO timestamp for custom snooze times (null for general snoozes)
20356+
example: "2025-09-03T18:44:20.146Z"
20357+
priority_changed:
20358+
title: Part type - priority_changed
20359+
type: object
20360+
description: Contains details about priority changes for conversation part type <code>priority_changed</code>.
20361+
properties:
20362+
current_priority:
20363+
type: string
20364+
enum: ["priority", "not_priority"]
20365+
description: Current priority state
20366+
example: "priority"
20367+
previous_priority:
20368+
type: string
20369+
enum: ["priority", "not_priority"]
20370+
description: Previous priority state
20371+
example: "not_priority"
20372+
conversation_sla_applied_by_rule:
20373+
title: Part type - conversation_sla_applied_by_rule
20374+
type: object
20375+
description: Contains details about SLA applied by modern Operator workflows for conversation part type <code>conversation_sla_applied_by_rule</code>.
20376+
properties:
20377+
sla_name:
20378+
type: string
20379+
description: Name of the SLA that was applied
20380+
example: "Premium SLA"
20381+
sla_definition:
20382+
type: object
20383+
description: Target times configured for the SLA (in seconds)
20384+
properties:
20385+
first_reply_time:
20386+
type: integer
20387+
nullable: true
20388+
description: First response time target in seconds
20389+
example: 300
20390+
next_reply_time:
20391+
type: integer
20392+
nullable: true
20393+
description: Next reply time target in seconds
20394+
example: 600
20395+
resolution_time:
20396+
type: integer
20397+
nullable: true
20398+
description: Resolution time target in seconds
20399+
example: 3600
20400+
time_to_close:
20401+
type: integer
20402+
nullable: true
20403+
description: Time to close target in seconds
20404+
example: 7200
20405+
conversation_sla_applied_by_workflow:
20406+
title: Part type - conversation_sla_applied_by_workflow
20407+
type: object
20408+
description: Contains details about SLA applied by legacy Inbox Rules for conversation part type <code>conversation_sla_applied_by_workflow</code>.
20409+
properties:
20410+
sla_name:
20411+
type: string
20412+
description: Name of the SLA that was applied
20413+
example: "Standard SLA"
20414+
sla_definition:
20415+
type: object
20416+
description: Target times configured for the SLA (in seconds)
20417+
properties:
20418+
first_reply_time:
20419+
type: integer
20420+
nullable: true
20421+
description: First response time target in seconds
20422+
example: 300
20423+
next_reply_time:
20424+
type: integer
20425+
nullable: true
20426+
description: Next reply time target in seconds
20427+
example: 600
20428+
resolution_time:
20429+
type: integer
20430+
nullable: true
20431+
description: Resolution time target in seconds
20432+
example: 3600
20433+
time_to_close:
20434+
type: integer
20435+
nullable: true
20436+
description: Time to close target in seconds
20437+
example: 7200
20438+
conversation_sla_target_missed:
20439+
title: Part type - conversation_sla_target_missed
20440+
type: object
20441+
description: Contains complete status of all SLA targets when a breach occurs for conversation part type <code>conversation_sla_target_missed</code>.
20442+
properties:
20443+
sla_name:
20444+
type: string
20445+
description: Name of the SLA
20446+
example: "HandleConversation"
20447+
sla_target_type:
20448+
type: string
20449+
enum: ["first_reply_time", "next_reply_time", "resolution_time", "time_to_close"]
20450+
description: Which specific target was missed
20451+
example: "first_reply_time"
20452+
current_sla_status:
20453+
type: string
20454+
enum: ["hit", "missed", "active", "paused", "canceled"]
20455+
description: Overall SLA status
20456+
example: "missed"
20457+
sla_states:
20458+
type: object
20459+
description: Status of all SLA targets at the time of breach
20460+
additionalProperties:
20461+
type: object
20462+
properties:
20463+
status:
20464+
type: string
20465+
enum: ["hit", "missed", "active", "paused"]
20466+
description: Status of this specific target
20467+
seconds_remaining:
20468+
type: integer
20469+
nullable: true
20470+
description: Time remaining for active/paused targets (null for hit/missed)
20471+
example:
20472+
first_reply_time:
20473+
status: "missed"
20474+
seconds_remaining: null
20475+
time_to_close:
20476+
status: "active"
20477+
seconds_remaining: 210
20478+
conversation_sla_paused:
20479+
title: Part type - conversation_sla_paused
20480+
type: object
20481+
description: Contains SLA status at the moment of pausing for conversation part type <code>conversation_sla_paused</code>.
20482+
properties:
20483+
sla_name:
20484+
type: string
20485+
description: Name of the SLA being paused
20486+
example: "Premium SLA"
20487+
current_sla_status:
20488+
type: string
20489+
enum: ["active", "hit", "missed", "canceled"]
20490+
description: Overall SLA status at pause time
20491+
example: "active"
20492+
sla_states:
20493+
type: object
20494+
description: Status of all SLA targets at pause time
20495+
additionalProperties:
20496+
type: object
20497+
properties:
20498+
status:
20499+
type: string
20500+
enum: ["paused"]
20501+
description: Status of this specific target (always paused)
20502+
seconds_remaining:
20503+
type: integer
20504+
nullable: true
20505+
description: Time remaining when paused
20506+
example:
20507+
first_reply_time:
20508+
status: "paused"
20509+
seconds_remaining: 3600
20510+
time_to_close:
20511+
status: "paused"
20512+
seconds_remaining: 7200
20513+
conversation_sla_unpaused:
20514+
title: Part type - conversation_sla_unpaused
20515+
type: object
20516+
description: Contains basic SLA information when unpaused for conversation part type <code>conversation_sla_unpaused</code>.
20517+
properties:
20518+
sla_name:
20519+
type: string
20520+
description: Name of the SLA being unpaused
20521+
example: "Premium SLA"
20522+
conversation_sla_removed:
20523+
title: Part type - conversation_sla_removed
20524+
type: object
20525+
description: Contains basic SLA information when removed for conversation part type <code>conversation_sla_removed</code>.
20526+
properties:
20527+
sla_name:
20528+
type: string
20529+
description: Name of the SLA that was removed
20530+
example: "Standard SLA"
2028420531
event_details:
2028520532
title: Event details of Workflow & actions
2028620533
type: object
2028720534
anyOf:
2028820535
- "$ref": "#/components/schemas/conversation_attribute_updated_by_workflow"
2028920536
- "$ref": "#/components/schemas/conversation_attribute_updated_by_admin"
20537+
- "$ref": "#/components/schemas/conversation_attribute_updated_by_user"
2029020538
- "$ref": "#/components/schemas/custom_action_started"
2029120539
- "$ref": "#/components/schemas/custom_action_finished"
2029220540
- "$ref": "#/components/schemas/operator_workflow_event"
20541+
- "$ref": "#/components/schemas/conversation_tags_updated"
20542+
- "$ref": "#/components/schemas/snoozed"
20543+
- "$ref": "#/components/schemas/priority_changed"
20544+
- "$ref": "#/components/schemas/conversation_sla_applied_by_rule"
20545+
- "$ref": "#/components/schemas/conversation_sla_applied_by_workflow"
20546+
- "$ref": "#/components/schemas/conversation_sla_target_missed"
20547+
- "$ref": "#/components/schemas/conversation_sla_paused"
20548+
- "$ref": "#/components/schemas/conversation_sla_unpaused"
20549+
- "$ref": "#/components/schemas/conversation_sla_removed"
2029320550
email_setting:
2029420551
type: object
2029520552
title: Email Setting

0 commit comments

Comments
 (0)