From 9b2d1f894ba92aeb349a6407a8d0c34a14b48617 Mon Sep 17 00:00:00 2001 From: Rahul D'Souza Date: Fri, 25 Sep 2026 13:28:48 +0100 Subject: [PATCH 1/2] Add intercom_conversation_id to Fin Agent API responses (v2.14-2.16) /fin/start and /fin/reply already return this field; document it in the response schema and examples for versions 2.14, 2.15, and 2.16. Co-Authored-By: Claude Sonnet 5 --- descriptions/2.14/api.intercom.io.yaml | 12 ++++++++++++ descriptions/2.15/api.intercom.io.yaml | 12 ++++++++++++ descriptions/2.16/api.intercom.io.yaml | 12 ++++++++++++ 3 files changed, 36 insertions(+) diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 3248e52f..f9de1521 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -1840,6 +1840,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1847,6 +1848,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1865,6 +1867,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -2030,6 +2036,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2037,6 +2044,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2052,6 +2060,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 910ecf4b..af1e2b40 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -1846,6 +1846,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1853,6 +1854,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1871,6 +1873,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -2036,6 +2042,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2043,6 +2050,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2058,6 +2066,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 75d8fc86..339239b7 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -3985,6 +3985,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -3992,6 +3993,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -4010,6 +4012,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -4176,6 +4182,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -4183,6 +4190,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -4198,6 +4206,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. From 54aaef9540f781c2c1aab7da462a3d3169678e68 Mon Sep 17 00:00:00 2001 From: Rahul D'Souza Date: Fri, 25 Sep 2026 13:56:58 +0100 Subject: [PATCH 2/2] Add intercom_conversation_id to Fin Agent API responses in Preview Co-Authored-By: Claude Opus 5 --- descriptions/0/api.intercom.io.yaml | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index a5e8540b..d5ed4c3d 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -26618,6 +26618,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -26625,6 +26626,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -26640,6 +26642,10 @@ paths: type: string description: The external ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -26791,6 +26797,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -26798,6 +26805,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -26813,6 +26821,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -26970,6 +26982,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 procedure_id: '12345' status: thinking @@ -26978,6 +26991,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 procedure_id: '12345' status: thinking @@ -26994,6 +27008,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user. @@ -27485,6 +27503,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -27492,6 +27511,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '192837465' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -27510,6 +27530,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The internal Intercom conversation ID, useful for matching this Agent API session to the conversation in Intercom. + example: '192837465' user_id: type: string description: The ID of the user.