STRATCONN-6008 - [Twilio Messaging] - RCS (#3129)

* WIP adding RCS - do not deploy

* saving progress

* saving progress

* Adding unit tests

* Another test

Author: joe-ayoub-segment

packages/destination-actions/src/destinations/twilio-messaging/sendMessage/__tests__/index.test.ts

@@ -256,6 +256,27 @@ describe('TwilioMessaging.sendMessage', () => {
     })
   })
 
+  it('should send RCS with messaging service and scheduled send', async () => {
+    nock('https://api.twilio.com').post(`/2010-04-01/Accounts/${defaultSettings.accountSID}/Messages.json`, "To=%2B1234567890&SendAt=2025-12-31T23%3A59%3A59Z&MessagingServiceSid=MG5555555555bbbbbb5555555555bbbbbb&Body=Scheduled+message+with+media&MediaUrl=https%3A%2F%2Fexample.com%2Fscheduled-image.png").reply(200, {
+      sid: 'SM1234567890abcdef1234567890abcdef',
+      status: 'scheduled'
+    })
+
+    await testDestination.testAction('sendMessage', {
+      settings: defaultSettings,
+      mapping: {
+        channel: CHANNELS.RCS,
+        senderType: SENDER_TYPE.MESSAGING_SERVICE,
+        toPhoneNumber: '+1234567890',
+        messagingServiceSid: 'Scheduled Service [MG5555555555bbbbbb5555555555bbbbbb]',
+        contentTemplateType: 'Inline',
+        inlineBody: 'Scheduled message with media',
+        inlineMediaUrls: ['https://example.com/scheduled-image.png'],
+        sendAt: '2025-12-31T23:59:59Z'
+      }
+    })
+  })
+
   it('should throw error for invalid phone number format', async () => {
     await expect(
       testDestination.testAction('sendMessage', {
@@ -320,4 +341,52 @@ describe('TwilioMessaging.sendMessage', () => {
       })
     ).rejects.toThrow(PayloadValidationError)
   })
+
+  it('should throw error if RCS send attempted with a phone number (i.e without a Messaging Service)', async () => {
+    await expect(
+      testDestination.testAction('sendMessage', {
+        settings: defaultSettings,
+        mapping: {
+          channel: CHANNELS.RCS,
+          senderType: SENDER_TYPE.PHONE_NUMBER,
+          toPhoneNumber: '+1234567890',
+          fromPhoneNumber: '+19876543210',
+          contentTemplateType: 'Inline',
+          inlineBody: 'Hello World!'
+        }
+      })
+    ).rejects.toThrow("The root value is missing the required field 'messagingServiceSid'. The root value must match \"then\" schema.")
+  })
+
+  it('should send RCS messsage with tags', async () => {
+    const body = "To=%2B1234567890&SendAt=2025-12-31T23%3A59%3A59Z&MessagingServiceSid=MG5555555555bbbbbb5555555555bbbbbb&Body=Scheduled+message+with+media&MediaUrl=https%3A%2F%2Fexample.com%2Fscheduled-image.png&Tags=%7B%22campaign_name%22%3A%22Spring+Sale+2022%22%2C%22message_type%22%3A%22cart_abandoned%22%2C%22number_tag%22%3A%2212345%22%2C%22boolean_tag%22%3A%22true%22%7D"
+    nock('https://api.twilio.com')
+      .post(`/2010-04-01/Accounts/${defaultSettings.accountSID}/Messages.json`, body)
+      .reply(200, {
+        sid: 'SM1234567890abcdef1234567890abcdef',
+        status: 'sent'
+      })
+
+    await testDestination.testAction('sendMessage', {
+      settings: defaultSettings,
+      mapping: {
+        channel: CHANNELS.RCS,
+        senderType: SENDER_TYPE.MESSAGING_SERVICE,
+        toPhoneNumber: '+1234567890',
+        messagingServiceSid: 'Scheduled Service [MG5555555555bbbbbb5555555555bbbbbb]',
+        contentTemplateType: 'Inline',
+        inlineBody: 'Scheduled message with media',
+        inlineMediaUrls: ['https://example.com/scheduled-image.png'],
+        sendAt: '2025-12-31T23:59:59Z',
+        tags: {
+          campaign_name: 'Spring Sale 2022',
+          message_type: 'cart_abandoned',
+          number_tag: 12345,
+          boolean_tag: true,
+          null_tag: null,
+          empty_string_tag: ''
+        }
+      }
+    })
+  })
 })

packages/destination-actions/src/destinations/twilio-messaging/sendMessage/dynamic-fields.ts

@@ -66,6 +66,12 @@ export async function dynamicSenderType(payload: Payload): Promise<DynamicFieldR
     return createErrorResponse("Select from 'Channel' field first.")
   }
 
+  if (channel === CHANNELS.RCS) {
+    return {
+      choices: [{ label: SENDER_TYPE.MESSAGING_SERVICE, value: SENDER_TYPE.MESSAGING_SERVICE }]
+    }
+  }
+
   return {
     choices: [
       { label: SENDER_TYPE.PHONE_NUMBER, value: SENDER_TYPE.PHONE_NUMBER },

packages/destination-actions/src/destinations/twilio-messaging/sendMessage/fields.ts

@@ -10,8 +10,8 @@ export const fields: Record<string, InputField> = {
     choices: [
       { label: 'SMS', value: CHANNELS.SMS },
       { label: 'MMS', value: CHANNELS.MMS },
-      { label: 'WhatsApp', value: CHANNELS.WHATSAPP }
-      //{ label: 'RCS', value: CHANNELS.RCS } Will be hidden for private beta
+      { label: 'WhatsApp', value: CHANNELS.WHATSAPP },
+      { label: 'RCS', value: CHANNELS.RCS } 
     ]
   },
   senderType: {
@@ -106,7 +106,15 @@ export const fields: Record<string, InputField> = {
     description: 'The SID of the messaging service to use. If not in the dropdown, enter it directly.',
     type: 'string',
     dynamic: true,
-    required: false,
+    required: {
+      conditions: [
+        { 
+          fieldKey: 'channel',
+          operator: 'is',
+          value: CHANNELS.RCS
+        }
+      ]
+    },
     default: undefined,
     allowNull: false,
     disabledInputMethods: ['literal', 'variable', 'function', 'freeform', 'enrichment'],

packages/destination-actions/src/destinations/twilio-messaging/sendMessage/utils.ts

@@ -32,9 +32,9 @@ export async function send(request: RequestClient, payload: Payload, settings: S
 
   const getTo = (): string => {
     switch (channel) {
-      case 'SMS':
-      case 'MMS':
-      case 'RCS': {
+      case CHANNELS.SMS:
+      case CHANNELS.MMS:
+      case CHANNELS.RCS: {
         toPhoneNumber = toPhoneNumber?.trim() ?? ''
         if (!(E164_REGEX.test(toPhoneNumber) || TWILIO_SHORT_CODE_REGEX.test(toPhoneNumber))) {
           throw new PayloadValidationError(
@@ -43,7 +43,7 @@ export async function send(request: RequestClient, payload: Payload, settings: S
         }
         return toPhoneNumber
       }
-      case 'Whatsapp': {
+      case CHANNELS.WHATSAPP: {
         toPhoneNumber = toPhoneNumber?.trim() ?? ''
         if (!E164_REGEX.test(toPhoneNumber)) {
           throw new PayloadValidationError("'To' field should be a valid phone number in E.164 format")