fix(intercom): snooze via the manage-conversation endpoint, coerce snoozed_until, guard path ids, add user/lead recipient types

Author: waleedlatif1

apps/sim/blocks/blocks/intercom.ts

@@ -854,7 +854,11 @@ Return ONLY the subject line - no explanations.`,
       id: 'to_type',
       title: 'To Type',
       type: 'dropdown',
-      options: [{ label: 'Contact', id: 'contact' }],
+      options: [
+        { label: 'Contact', id: 'contact' },
+        { label: 'User', id: 'user' },
+        { label: 'Lead', id: 'lead' },
+      ],
       required: true,
       condition: {
         field: 'operation',
@@ -1354,6 +1358,7 @@ Return ONLY the numeric timestamp.`,
           ticket_open,
           ticket_is_shared,
           ticket_snoozed_until,
+          snoozed_until,
           ticket_assignee_id,
           tag_name,
           tag_id_update,
@@ -1406,6 +1411,10 @@ Return ONLY the numeric timestamp.`,
           cleanParams.include_translations = include_translations === 'true'
         }
 
+        if (operation === 'snooze_conversation' && snoozed_until) {
+          cleanParams.snoozed_until = Number(snoozed_until)
+        }
+
         if (operation === 'close_conversation' && close_body) {
           cleanParams.body = close_body
         }
@@ -1638,6 +1647,7 @@ export const IntercomV2Block: BlockConfig = {
           ticket_open,
           ticket_is_shared,
           ticket_snoozed_until,
+          snoozed_until,
           ticket_assignee_id,
           tag_name,
           tag_id_update,
@@ -1690,6 +1700,10 @@ export const IntercomV2Block: BlockConfig = {
           cleanParams.include_translations = include_translations === 'true'
         }
 
+        if (operation === 'snooze_conversation' && snoozed_until) {
+          cleanParams.snoozed_until = Number(snoozed_until)
+        }
+
         if (operation === 'close_conversation' && close_body) {
           cleanParams.body = close_body
         }

apps/sim/tools/intercom/assign_conversation.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomAssignConversationParams {
   accessToken: string
@@ -57,7 +58,9 @@ const assignConversationBase = {
 
   request: {
     url: (params: IntercomAssignConversationParams) =>
-      buildIntercomUrl(`/conversations/${params.conversationId}/parts`),
+      buildIntercomUrl(
+        `/conversations/${safeUrlPathSegment(params.conversationId, 'conversationId')}/parts`
+      ),
     method: 'POST',
     headers: (params: IntercomAssignConversationParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/attach_contact_to_company.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomAttachContactToCompanyParams {
   accessToken: string
@@ -41,7 +42,7 @@ const attachContactToCompanyBase = {
 
   request: {
     url: (params: IntercomAttachContactToCompanyParams) =>
-      buildIntercomUrl(`/contacts/${params.contactId}/companies`),
+      buildIntercomUrl(`/contacts/${safeUrlPathSegment(params.contactId, 'contactId')}/companies`),
     method: 'POST',
     headers: (params: IntercomAttachContactToCompanyParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/close_conversation.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomCloseConversationParams {
   accessToken: string
@@ -48,7 +49,9 @@ const closeConversationBase = {
 
   request: {
     url: (params: IntercomCloseConversationParams) =>
-      buildIntercomUrl(`/conversations/${params.conversationId}/parts`),
+      buildIntercomUrl(
+        `/conversations/${safeUrlPathSegment(params.conversationId, 'conversationId')}/parts`
+      ),
     method: 'POST',
     headers: (params: IntercomCloseConversationParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/create_message.ts

@@ -85,7 +85,7 @@ const createMessageBase = {
       type: 'string',
       required: true,
       visibility: 'user-or-llm',
-      description: 'Recipient type: "contact"',
+      description: 'Recipient role: "user" or "lead"',
     },
     to_id: {
       type: 'string',

apps/sim/tools/intercom/create_note.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomCreateNoteParams {
   accessToken: string
@@ -51,7 +52,7 @@ const createNoteBase = {
 
   request: {
     url: (params: IntercomCreateNoteParams) =>
-      buildIntercomUrl(`/contacts/${params.contactId}/notes`),
+      buildIntercomUrl(`/contacts/${safeUrlPathSegment(params.contactId, 'contactId')}/notes`),
     method: 'POST',
     headers: (params: IntercomCreateNoteParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/delete_contact.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomDeleteContactParams {
   accessToken: string
@@ -36,7 +37,8 @@ const intercomDeleteContactBase = {
   },
 
   request: {
-    url: (params: IntercomDeleteContactParams) => buildIntercomUrl(`/contacts/${params.contactId}`),
+    url: (params: IntercomDeleteContactParams) =>
+      buildIntercomUrl(`/contacts/${safeUrlPathSegment(params.contactId, 'contactId')}`),
     method: 'DELETE',
     headers: (params: IntercomDeleteContactParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/detach_contact_from_company.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomDetachContactFromCompanyParams {
   accessToken: string
@@ -41,7 +42,9 @@ const detachContactFromCompanyBase = {
 
   request: {
     url: (params: IntercomDetachContactFromCompanyParams) =>
-      buildIntercomUrl(`/contacts/${params.contactId}/companies/${params.companyId}`),
+      buildIntercomUrl(
+        `/contacts/${safeUrlPathSegment(params.contactId, 'contactId')}/companies/${safeUrlPathSegment(params.companyId, 'companyId')}`
+      ),
     method: 'DELETE',
     headers: (params: IntercomDetachContactFromCompanyParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/get_company.ts

@@ -1,6 +1,7 @@
 import { buildIntercomUrl, handleIntercomError } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomGetCompanyParams {
   accessToken: string
@@ -35,7 +36,8 @@ const getCompanyBase = {
   },
 
   request: {
-    url: (params: IntercomGetCompanyParams) => buildIntercomUrl(`/companies/${params.companyId}`),
+    url: (params: IntercomGetCompanyParams) =>
+      buildIntercomUrl(`/companies/${safeUrlPathSegment(params.companyId, 'companyId')}`),
     method: 'GET',
     headers: (params: IntercomGetCompanyParams) => ({
       Authorization: `Bearer ${params.accessToken}`,

apps/sim/tools/intercom/get_contact.ts

@@ -5,6 +5,7 @@ import {
 } from '@/tools/intercom/types'
 import { INTERCOM_CREDENTIAL_OAUTH } from '@/tools/shared/saved-credentials'
 import type { ToolConfig } from '@/tools/types'
+import { safeUrlPathSegment } from '@/tools/url-path'
 
 export interface IntercomGetContactParams {
   accessToken: string
@@ -39,7 +40,8 @@ const intercomGetContactBase = {
   },
 
   request: {
-    url: (params: IntercomGetContactParams) => buildIntercomUrl(`/contacts/${params.contactId}`),
+    url: (params: IntercomGetContactParams) =>
+      buildIntercomUrl(`/contacts/${safeUrlPathSegment(params.contactId, 'contactId')}`),
     method: 'GET',
     headers: (params: IntercomGetContactParams) => ({
       Authorization: `Bearer ${params.accessToken}`,