feat: support native GIF sending without video conversion (#2540)

* feat: add gifPlayback support for video messages

Allow gifPlayback and gifAttribution options to be passed to Baileys video messages.

* feat: add gif options to media DTOs

Add gifPlayback and gifAttribution properties to media DTO definitions.

* feat: add gif fields to media message schema

Add gifPlayback and gifAttribution validation support to media message schema.

* fix: validate gifAttribution values before assignment

Prevent invalid gifAttribution values from reaching Baileys media payload.

Author: AlexisJusviack

src/api/dto/sendMessage.dto.ts

@@ -25,6 +25,8 @@ export class MediaMessage {
   fileName?: string;
   // url or base64
   media: string;
+  gifPlayback?: boolean | string;
+  gifAttribution?: number | string;
 }
 
 export class StatusMessage {
@@ -83,6 +85,8 @@ export class SendMediaDto extends Metadata {
   fileName?: string;
   // url or base64
   media: string;
+  gifPlayback?: boolean | string;
+  gifAttribution?: number | string;
 }
 
 export class SendPtvDto extends Metadata {

src/api/integrations/channel/whatsapp/whatsapp.baileys.service.ts

@@ -3157,7 +3157,14 @@ export class BaileysStartupService extends ChannelStartupService {
       prepareMedia[mediaType].fileName = mediaMessage.fileName;
 
       if (mediaMessage.mediatype === 'video') {
-        prepareMedia[mediaType].gifPlayback = false;
+        prepareMedia[mediaType].gifPlayback = mediaMessage.gifPlayback === true || mediaMessage.gifPlayback === 'true';
+
+        if (mediaMessage.gifAttribution !== undefined) {
+          const gifAttribution = Number(mediaMessage.gifAttribution);
+          if (gifAttribution === 0 || gifAttribution === 1 || gifAttribution === 2) {
+            prepareMedia[mediaType].gifAttribution = gifAttribution;
+          }
+        }
       }
 
       return generateWAMessageFromContent(

src/validate/message.schema.ts

@@ -102,6 +102,15 @@ export const mediaMessageSchema: JSONSchema7 = {
     media: { type: 'string' },
     fileName: { type: 'string' },
     caption: { type: 'string' },
+    gifPlayback: {
+      oneOf: [{ type: 'boolean' }, { type: 'string', enum: ['true', 'false'] }],
+    },
+    gifAttribution: {
+      oneOf: [
+        { type: 'integer', enum: [0, 1, 2] },
+        { type: 'string', enum: ['0', '1', '2'] },
+      ],
+    },
     delay: {
       type: 'integer',
       description: 'Enter a value in milliseconds',