From 5522eec0a775a1a59f16ba244e5b6e323ba9b680 Mon Sep 17 00:00:00 2001 From: anubhav-intercom Date: Thu, 27 Aug 2026 13:41:27 +0100 Subject: [PATCH 1/2] Document `event_details` on standalone platform handoff parts Co-Authored-By: Claude Fable 5 --- descriptions/0/api.intercom.io.yaml | 47 ++++++++++++++++++++++++++++- 1 file changed, 46 insertions(+), 1 deletion(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index de71fc0c..681db9cf 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -12447,7 +12447,31 @@ paths: event_details: call_id: '3822007689' app_package_code: null - total_count: 5 + - type: conversation_part + id: 6 + part_type: standalone_platform_handoff + body: + created_at: 1740141910 + updated_at: 1740141910 + notified_at: 1740141910 + assigned_to: + author: + type: bot + id: '278' + name: Fin + email: operator+abcd1234@intercom.io + attachments: [] + external_id: + redacted: false + email_message_metadata: null + state: closed + tags: [] + event_details: + handoff: + type: zendesk_ticket + success: true + app_package_code: null + total_count: 6 email conversation with history found: value: type: conversation @@ -36662,6 +36686,26 @@ components: type: string description: The id of the call the summary describes example: "3822007689" + standalone_platform_handoff: + title: Part type - standalone_platform_handoff + type: object + description: Contains the escalation target Fin handed the conversation off to, for conversation part type standalone_platform_handoff. + properties: + handoff: + type: object + description: The escalation Fin attempted. + properties: + type: + type: string + description: Where Fin handed the conversation off to. zendesk_ticket means a Zendesk ticket was created, and zendesk_agent means the conversation was handed over to a Zendesk agent for live chat. + enum: + - zendesk_ticket + - zendesk_agent + example: zendesk_ticket + success: + type: boolean + description: Whether the handoff completed. A handoff that did not complete falls back to a live agent, which is reported in a separate successful part. + example: true event_details: title: Event details of Workflow & actions type: object @@ -36682,6 +36726,7 @@ components: - "$ref": "#/components/schemas/conversation_sla_unpaused" - "$ref": "#/components/schemas/conversation_sla_removed" - "$ref": "#/components/schemas/call_summary" + - "$ref": "#/components/schemas/standalone_platform_handoff" email_setting: type: object title: Email Setting From 5a2e0dc4b34c10acbbb0643dd17196416689b925 Mon Sep 17 00:00:00 2001 From: Rahul D'Souza Date: Mon, 5 Oct 2026 14:27:52 +0100 Subject: [PATCH 2/2] Document that handoff event_details is Zendesk-only Other handoff targets return an empty event_details object, as in earlier versions. Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index c5907e45..c8cbf43b 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -38752,11 +38752,11 @@ components: standalone_platform_handoff: title: Part type - standalone_platform_handoff type: object - description: Contains the escalation target Fin handed the conversation off to, for conversation part type standalone_platform_handoff. + description: Contains the escalation target Fin handed the conversation off to, for conversation part type standalone_platform_handoff. Only present for handoffs to Zendesk; for any other handoff target event_details is an empty object. properties: handoff: type: object - description: The escalation Fin attempted. + description: The escalation Fin attempted. Omitted when the handoff target is not Zendesk. properties: type: type: string