@tickernelz/paperclip-pro-shared 2026.1004.9 → 2026.1004.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/.paperclip-build-complete +1 -1
  2. package/dist/openwa-operations.d.ts +1 -1
  3. package/dist/openwa-operations.d.ts.map +1 -1
  4. package/dist/openwa-operations.js +740 -680
  5. package/dist/openwa-operations.js.map +1 -1
  6. package/dist/openwa-operations.test.js +1 -1
  7. package/package.json +1 -1
package/dist/openwa-operations.js CHANGED
@@ -1,5 +1,5 @@
1
- // GENERATED by scripts/generate-openwa-operations.mjs from scripts/openwa/openapi-0.23.7.json; DO NOT EDIT.
2
- export const OPENWA_GATEWAY_VERSION = "0.23.7";
1
+ // GENERATED by scripts/generate-openwa-operations.mjs from scripts/openwa/openapi-0.24.0.json; DO NOT EDIT.
2
+ export const OPENWA_GATEWAY_VERSION = "0.24.0";
3
3
  export const OPENWA_OPERATIONS = [
4
4
  {
5
5
  "id": "AuditController_findAll",
@@ -121,12 +121,12 @@ export const OPENWA_OPERATIONS = [
121
121
  "pathParams": [],
122
122
  "queryParams": [],
123
123
  "bodyParams": [
124
- "allowedChats",
124
+ "name",
125
+ "role",
125
126
  "allowedIps",
126
127
  "allowedSessions",
127
- "expiresAt",
128
- "name",
129
- "role"
128
+ "allowedChats",
129
+ "expiresAt"
130
130
  ],
131
131
  "fileParams": [],
132
132
  "bodyMode": "json",
@@ -134,12 +134,21 @@ export const OPENWA_OPERATIONS = [
134
134
  "args": {
135
135
  "type": "object",
136
136
  "properties": {
137
- "allowedChats": {
138
- "type": "array",
139
- "description": "Chat ids this key may read and send to — a curated allowlist independent of `allowedSessions`.",
140
- "items": {
141
- "type": "string"
142
- }
137
+ "name": {
138
+ "type": "string",
139
+ "description": "Friendly name for the API key",
140
+ "minLength": 3,
141
+ "maxLength": 100
142
+ },
143
+ "role": {
144
+ "type": "string",
145
+ "description": "Role/permission level",
146
+ "enum": [
147
+ "admin",
148
+ "operator",
149
+ "viewer"
150
+ ],
151
+ "default": "operator"
143
152
  },
144
153
  "allowedIps": {
145
154
  "type": "array",
@@ -155,23 +164,16 @@ export const OPENWA_OPERATIONS = [
155
164
  "type": "string"
156
165
  }
157
166
  },
167
+ "allowedChats": {
168
+ "type": "array",
169
+ "description": "Chat ids this key may read and send to — a curated allowlist independent of `allowedSessions`.",
170
+ "items": {
171
+ "type": "string"
172
+ }
173
+ },
158
174
  "expiresAt": {
159
175
  "type": "string",
160
176
  "description": "Expiration date (ISO 8601)"
161
- },
162
- "name": {
163
- "type": "string",
164
- "description": "Friendly name for the API key"
165
- },
166
- "role": {
167
- "type": "string",
168
- "description": "Role/permission level",
169
- "enum": [
170
- "admin",
171
- "operator",
172
- "viewer"
173
- ],
174
- "default": "operator"
175
177
  }
176
178
  },
177
179
  "additionalProperties": false,
@@ -350,12 +352,12 @@ export const OPENWA_OPERATIONS = [
350
352
  ],
351
353
  "queryParams": [],
352
354
  "bodyParams": [
353
- "allowedChats",
355
+ "name",
356
+ "role",
354
357
  "allowedIps",
355
358
  "allowedSessions",
356
- "expiresAt",
357
- "name",
358
- "role"
359
+ "allowedChats",
360
+ "expiresAt"
359
361
  ],
360
362
  "fileParams": [],
361
363
  "bodyMode": "json",
@@ -366,37 +368,43 @@ export const OPENWA_OPERATIONS = [
366
368
  "id": {
367
369
  "type": "string"
368
370
  },
369
- "allowedChats": {
371
+ "name": {
372
+ "type": "string",
373
+ "minLength": 3,
374
+ "maxLength": 100
375
+ },
376
+ "role": {
377
+ "type": "string",
378
+ "enum": [
379
+ "admin",
380
+ "operator",
381
+ "viewer"
382
+ ]
383
+ },
384
+ "allowedIps": {
370
385
  "type": "array",
371
386
  "items": {
372
387
  "type": "string"
373
388
  }
374
389
  },
375
- "allowedIps": {
390
+ "allowedSessions": {
376
391
  "type": "array",
377
392
  "items": {
378
393
  "type": "string"
379
394
  }
380
395
  },
381
- "allowedSessions": {
396
+ "allowedChats": {
382
397
  "type": "array",
383
398
  "items": {
384
399
  "type": "string"
385
400
  }
386
401
  },
387
402
  "expiresAt": {
388
- "type": "string"
389
- },
390
- "name": {
391
- "type": "string"
392
- },
393
- "role": {
394
- "type": "string",
395
- "enum": [
396
- "admin",
397
- "operator",
398
- "viewer"
399
- ]
403
+ "type": [
404
+ "string",
405
+ "null"
406
+ ],
407
+ "description": "Expiration date (ISO 8601); null clears it (an empty string is rejected)"
400
408
  }
401
409
  },
402
410
  "additionalProperties": false,
@@ -456,11 +464,11 @@ export const OPENWA_OPERATIONS = [
456
464
  "pathParams": [],
457
465
  "queryParams": [],
458
466
  "bodyParams": [
467
+ "name",
468
+ "replyText",
459
469
  "conditions",
460
470
  "cooldownSeconds",
461
- "enabled",
462
- "name",
463
- "replyText"
471
+ "enabled"
464
472
  ],
465
473
  "fileParams": [],
466
474
  "bodyMode": "json",
@@ -468,6 +476,16 @@ export const OPENWA_OPERATIONS = [
468
476
  "args": {
469
477
  "type": "object",
470
478
  "properties": {
479
+ "name": {
480
+ "type": "string",
481
+ "description": "Display name for the rule",
482
+ "maxLength": 100
483
+ },
484
+ "replyText": {
485
+ "type": "string",
486
+ "description": "Text sent back into the chat when the rule matches",
487
+ "maxLength": 4096
488
+ },
471
489
  "conditions": {
472
490
  "type": "object",
473
491
  "description": "Match conditions in the webhook filter format (message family: sender, recipient, chatId, body, type, isGroup, kind, fromMe, hasMedia, mentions)."
@@ -483,16 +501,6 @@ export const OPENWA_OPERATIONS = [
483
501
  "type": "boolean",
484
502
  "description": "Whether the rule is active",
485
503
  "default": true
486
- },
487
- "name": {
488
- "type": "string",
489
- "description": "Display name for the rule",
490
- "maxLength": 100
491
- },
492
- "replyText": {
493
- "type": "string",
494
- "description": "Text sent back into the chat when the rule matches",
495
- "maxLength": 4096
496
504
  }
497
505
  },
498
506
  "additionalProperties": false,
@@ -635,11 +643,11 @@ export const OPENWA_OPERATIONS = [
635
643
  ],
636
644
  "queryParams": [],
637
645
  "bodyParams": [
646
+ "name",
647
+ "replyText",
638
648
  "conditions",
639
649
  "cooldownSeconds",
640
- "enabled",
641
- "name",
642
- "replyText"
650
+ "enabled"
643
651
  ],
644
652
  "fileParams": [],
645
653
  "bodyMode": "json",
@@ -651,6 +659,16 @@ export const OPENWA_OPERATIONS = [
651
659
  "type": "string",
652
660
  "description": "Rule ID"
653
661
  },
662
+ "name": {
663
+ "type": "string",
664
+ "description": "Display name for the rule",
665
+ "maxLength": 100
666
+ },
667
+ "replyText": {
668
+ "type": "string",
669
+ "description": "Text sent back into the chat when the rule matches",
670
+ "maxLength": 4096
671
+ },
654
672
  "conditions": {
655
673
  "type": "object",
656
674
  "description": "Match conditions in the webhook filter format (message family: sender, recipient, chatId, body, type, isGroup, kind, fromMe, hasMedia, mentions)."
@@ -664,16 +682,6 @@ export const OPENWA_OPERATIONS = [
664
682
  "enabled": {
665
683
  "type": "boolean",
666
684
  "description": "Whether the rule is active"
667
- },
668
- "name": {
669
- "type": "string",
670
- "description": "Display name for the rule",
671
- "maxLength": 100
672
- },
673
- "replyText": {
674
- "type": "string",
675
- "description": "Text sent back into the chat when the rule matches",
676
- "maxLength": 4096
677
685
  }
678
686
  },
679
687
  "additionalProperties": false,
@@ -703,8 +711,8 @@ export const OPENWA_OPERATIONS = [
703
711
  "pathParams": [],
704
712
  "queryParams": [],
705
713
  "bodyParams": [
706
- "startTime",
707
- "type"
714
+ "type",
715
+ "startTime"
708
716
  ],
709
717
  "fileParams": [],
710
718
  "bodyMode": "json",
@@ -712,10 +720,6 @@ export const OPENWA_OPERATIONS = [
712
720
  "args": {
713
721
  "type": "object",
714
722
  "properties": {
715
- "startTime": {
716
- "type": "number",
717
- "description": "Absolute epoch-MILLISECONDS timestamp the call is scheduled to start at."
718
- },
719
723
  "type": {
720
724
  "type": "string",
721
725
  "description": "Which kind of call the link opens.",
@@ -723,6 +727,12 @@ export const OPENWA_OPERATIONS = [
723
727
  "audio",
724
728
  "video"
725
729
  ]
730
+ },
731
+ "startTime": {
732
+ "type": "integer",
733
+ "description": "Absolute epoch-MILLISECONDS timestamp the call is scheduled to start at.",
734
+ "minimum": 1,
735
+ "maximum": 8640000000000000
726
736
  }
727
737
  },
728
738
  "additionalProperties": false,
@@ -868,12 +878,12 @@ export const OPENWA_OPERATIONS = [
868
878
  "type": "object",
869
879
  "properties": {
870
880
  "page": {
871
- "type": "number",
881
+ "type": "integer",
872
882
  "minimum": 1,
873
883
  "description": "Result page (1-based)."
874
884
  },
875
885
  "limit": {
876
- "type": "number",
886
+ "type": "integer",
877
887
  "minimum": 1,
878
888
  "description": "Page size."
879
889
  }
@@ -901,9 +911,9 @@ export const OPENWA_OPERATIONS = [
901
911
  "pathParams": [],
902
912
  "queryParams": [],
903
913
  "bodyParams": [
904
- "body",
905
914
  "chatId",
906
- "productId"
915
+ "productId",
916
+ "body"
907
917
  ],
908
918
  "fileParams": [],
909
919
  "bodyMode": "json",
@@ -911,17 +921,19 @@ export const OPENWA_OPERATIONS = [
911
921
  "args": {
912
922
  "type": "object",
913
923
  "properties": {
914
- "body": {
915
- "type": "string",
916
- "description": "Optional body text accompanying the product card."
917
- },
918
924
  "chatId": {
919
925
  "type": "string",
920
926
  "description": "Chat to send the product card to (@c.us or @g.us)."
921
927
  },
922
928
  "productId": {
923
929
  "type": "string",
924
- "description": "Catalog product id to send."
930
+ "description": "Catalog product id to send.",
931
+ "maxLength": 255
932
+ },
933
+ "body": {
934
+ "type": "string",
935
+ "description": "Optional body text accompanying the product card.",
936
+ "maxLength": 4096
925
937
  }
926
938
  },
927
939
  "additionalProperties": false,
@@ -952,8 +964,8 @@ export const OPENWA_OPERATIONS = [
952
964
  "pathParams": [],
953
965
  "queryParams": [],
954
966
  "bodyParams": [
955
- "description",
956
- "name"
967
+ "name",
968
+ "description"
957
969
  ],
958
970
  "fileParams": [],
959
971
  "bodyMode": "json",
@@ -961,14 +973,15 @@ export const OPENWA_OPERATIONS = [
961
973
  "args": {
962
974
  "type": "object",
963
975
  "properties": {
964
- "description": {
965
- "type": "string",
966
- "description": "Channel description"
967
- },
968
976
  "name": {
969
977
  "type": "string",
970
978
  "description": "Channel name",
971
979
  "maxLength": 100
980
+ },
981
+ "description": {
982
+ "type": "string",
983
+ "description": "Channel description",
984
+ "maxLength": 2048
972
985
  }
973
986
  },
974
987
  "additionalProperties": false,
@@ -1780,6 +1793,7 @@ export const OPENWA_OPERATIONS = [
1780
1793
  "firstName": {
1781
1794
  "type": "string",
1782
1795
  "description": "The contact's first name.",
1796
+ "minLength": 1,
1783
1797
  "maxLength": 100
1784
1798
  },
1785
1799
  "lastName": {
@@ -2621,9 +2635,9 @@ export const OPENWA_OPERATIONS = [
2621
2635
  ],
2622
2636
  "queryParams": [],
2623
2637
  "bodyParams": [
2638
+ "url",
2624
2639
  "base64",
2625
- "mimetype",
2626
- "url"
2640
+ "mimetype"
2627
2641
  ],
2628
2642
  "fileParams": [],
2629
2643
  "bodyMode": "json",
@@ -2635,6 +2649,10 @@ export const OPENWA_OPERATIONS = [
2635
2649
  "type": "string",
2636
2650
  "description": "Group ID"
2637
2651
  },
2652
+ "url": {
2653
+ "type": "string",
2654
+ "description": "Image URL (http/https)"
2655
+ },
2638
2656
  "base64": {
2639
2657
  "type": "string",
2640
2658
  "description": "Base64 encoded image data"
@@ -2642,10 +2660,6 @@ export const OPENWA_OPERATIONS = [
2642
2660
  "mimetype": {
2643
2661
  "type": "string",
2644
2662
  "description": "Image MIME type (required when using base64)"
2645
- },
2646
- "url": {
2647
- "type": "string",
2648
- "description": "Image URL (http/https)"
2649
2663
  }
2650
2664
  },
2651
2665
  "additionalProperties": false,
@@ -2726,8 +2740,8 @@ export const OPENWA_OPERATIONS = [
2726
2740
  "queryParams": [],
2727
2741
  "bodyParams": [
2728
2742
  "announce",
2729
- "ephemeralSeconds",
2730
2743
  "locked",
2744
+ "ephemeralSeconds",
2731
2745
  "memberAddMode"
2732
2746
  ],
2733
2747
  "fileParams": [],
@@ -2744,15 +2758,15 @@ export const OPENWA_OPERATIONS = [
2744
2758
  "type": "boolean",
2745
2759
  "description": "Only admins can send messages (announce group)"
2746
2760
  },
2761
+ "locked": {
2762
+ "type": "boolean",
2763
+ "description": "Only admins can edit group info (locked group)"
2764
+ },
2747
2765
  "ephemeralSeconds": {
2748
2766
  "type": "number",
2749
2767
  "description": "Disappearing-messages timer in seconds; 0 disables.",
2750
2768
  "minimum": 0
2751
2769
  },
2752
- "locked": {
2753
- "type": "boolean",
2754
- "description": "Only admins can edit group info (locked group)"
2755
- },
2756
2770
  "memberAddMode": {
2757
2771
  "type": "string",
2758
2772
  "description": "Who may add participants: 'all' (any member) or 'admins' (admins only)",
@@ -2956,10 +2970,10 @@ export const OPENWA_OPERATIONS = [
2956
2970
  "queryParams": [],
2957
2971
  "bodyParams": [
2958
2972
  "database",
2959
- "engine",
2960
- "queue",
2961
2973
  "redis",
2962
- "storage"
2974
+ "queue",
2975
+ "storage",
2976
+ "engine"
2963
2977
  ],
2964
2978
  "fileParams": [],
2965
2979
  "bodyMode": "json",
@@ -2970,61 +2984,64 @@ export const OPENWA_OPERATIONS = [
2970
2984
  "database": {
2971
2985
  "type": "object",
2972
2986
  "properties": {
2987
+ "type": {
2988
+ "type": "string",
2989
+ "enum": [
2990
+ "sqlite",
2991
+ "postgres"
2992
+ ]
2993
+ },
2973
2994
  "builtIn": {
2974
2995
  "type": "boolean"
2975
2996
  },
2976
- "database": {
2997
+ "host": {
2977
2998
  "type": "string"
2978
2999
  },
2979
- "host": {
3000
+ "port": {
2980
3001
  "type": "string"
2981
3002
  },
2982
- "password": {
3003
+ "username": {
2983
3004
  "type": "string"
2984
3005
  },
2985
- "poolSize": {
2986
- "type": "number"
3006
+ "password": {
3007
+ "type": "string"
2987
3008
  },
2988
- "port": {
3009
+ "database": {
2989
3010
  "type": "string"
2990
3011
  },
2991
3012
  "schema": {
2992
3013
  "type": "string"
2993
3014
  },
3015
+ "poolSize": {
3016
+ "type": "number"
3017
+ },
2994
3018
  "sslEnabled": {
2995
3019
  "type": "boolean"
2996
3020
  },
2997
3021
  "sslRejectUnauthorized": {
2998
3022
  "type": "boolean"
2999
- },
3000
- "type": {
3001
- "type": "string",
3002
- "enum": [
3003
- "sqlite",
3004
- "postgres"
3005
- ]
3006
- },
3007
- "username": {
3008
- "type": "string"
3009
3023
  }
3010
3024
  },
3011
3025
  "required": [
3012
3026
  "type"
3013
3027
  ]
3014
3028
  },
3015
- "engine": {
3029
+ "redis": {
3016
3030
  "type": "object",
3017
3031
  "properties": {
3018
- "browserArgs": {
3019
- "type": "string"
3032
+ "enabled": {
3033
+ "type": "boolean"
3020
3034
  },
3021
- "headless": {
3035
+ "builtIn": {
3022
3036
  "type": "boolean"
3023
3037
  },
3024
- "sessionDataPath": {
3038
+ "host": {
3025
3039
  "type": "string"
3026
3040
  },
3027
- "type": {
3041
+ "port": {
3042
+ "type": "string"
3043
+ },
3044
+ "password": {
3028
3045
  "type": "string"
3029
3046
  }
3030
3047
  }
@@ -3037,61 +3054,58 @@ export const OPENWA_OPERATIONS = [
3037
3054
  }
3038
3055
  }
3039
3056
  },
3040
- "redis": {
3057
+ "storage": {
3041
3058
  "type": "object",
3042
3059
  "properties": {
3043
- "builtIn": {
3044
- "type": "boolean"
3060
+ "type": {
3061
+ "type": "string",
3062
+ "enum": [
3063
+ "local",
3064
+ "s3"
3065
+ ]
3045
3066
  },
3046
- "enabled": {
3067
+ "builtIn": {
3047
3068
  "type": "boolean"
3048
3069
  },
3049
- "host": {
3070
+ "localPath": {
3050
3071
  "type": "string"
3051
3072
  },
3052
- "password": {
3073
+ "s3Bucket": {
3053
3074
  "type": "string"
3054
3075
  },
3055
- "port": {
3076
+ "s3Region": {
3056
3077
  "type": "string"
3057
- }
3058
- }
3059
- },
3060
- "storage": {
3061
- "type": "object",
3062
- "properties": {
3063
- "builtIn": {
3064
- "type": "boolean"
3065
3078
  },
3066
- "localPath": {
3079
+ "s3AccessKey": {
3067
3080
  "type": "string"
3068
3081
  },
3069
- "s3AccessKey": {
3070
- "type": "string"
3071
- },
3072
- "s3Bucket": {
3082
+ "s3SecretKey": {
3073
3083
  "type": "string"
3074
3084
  },
3075
3085
  "s3Endpoint": {
3076
3086
  "type": "string"
3077
- },
3078
- "s3Region": {
3079
- "type": "string"
3080
- },
3081
- "s3SecretKey": {
3082
- "type": "string"
3083
- },
3084
- "type": {
3085
- "type": "string",
3086
- "enum": [
3087
- "local",
3088
- "s3"
3089
- ]
3090
3087
  }
3091
3088
  },
3092
3089
  "required": [
3093
3090
  "type"
3094
3091
  ]
3092
+ },
3093
+ "engine": {
3094
+ "type": "object",
3095
+ "properties": {
3096
+ "type": {
3097
+ "type": "string"
3098
+ },
3099
+ "headless": {
3100
+ "type": "boolean"
3101
+ },
3102
+ "sessionDataPath": {
3103
+ "type": "string"
3104
+ },
3105
+ "browserArgs": {
3106
+ "type": "string"
3107
+ }
3108
+ }
3095
3109
  }
3096
3110
  },
3097
3111
  "additionalProperties": false
@@ -3148,14 +3162,14 @@ export const OPENWA_OPERATIONS = [
3148
3162
  "pathParams": [],
3149
3163
  "queryParams": [],
3150
3164
  "bodyParams": [
3151
- "counts",
3152
- "dataDbType",
3153
- "exportedAt",
3165
+ "tables",
3154
3166
  "force",
3155
- "omittedInlineMedia",
3156
- "skippedTables",
3157
3167
  "stopOrphans",
3158
- "tables"
3168
+ "exportedAt",
3169
+ "dataDbType",
3170
+ "counts",
3171
+ "skippedTables",
3172
+ "omittedInlineMedia"
3159
3173
  ],
3160
3174
  "fileParams": [],
3161
3175
  "bodyMode": "json",
@@ -3163,96 +3177,96 @@ export const OPENWA_OPERATIONS = [
3163
3177
  "args": {
3164
3178
  "type": "object",
3165
3179
  "properties": {
3166
- "counts": {
3167
- "type": "object",
3168
- "description": "Ignored.",
3169
- "additionalProperties": {
3170
- "type": "number"
3171
- }
3172
- },
3173
- "dataDbType": {
3174
- "type": "string",
3175
- "description": "Ignored."
3176
- },
3177
- "exportedAt": {
3178
- "type": "string",
3179
- "description": "Ignored."
3180
- },
3181
- "force": {
3182
- "type": "boolean",
3183
- "description": "Allow the replace to proceed even while engines are running for sessions the backup does not contain (they keep running until restart; see restartRequired)."
3184
- },
3185
- "omittedInlineMedia": {
3186
- "type": "object",
3187
- "description": "Ignored.",
3188
- "additionalProperties": {
3189
- "type": "number"
3190
- }
3191
- },
3192
- "skippedTables": {
3193
- "type": "array",
3194
- "description": "Ignored.",
3195
- "items": {
3196
- "type": "string"
3197
- }
3198
- },
3199
- "stopOrphans": {
3200
- "type": "boolean",
3201
- "description": "Stop the running engines for sessions the backup does not contain, inside this request and before the replace runs."
3202
- },
3203
3180
  "tables": {
3204
3181
  "type": "object",
3205
3182
  "description": "Every one of the 16 migration tables is emptied before the restore runs, so a key omitted here is restored EMPTY rather than left untouched.",
3206
3183
  "properties": {
3207
- "automationRules": {
3184
+ "sessions": {
3208
3185
  "type": "array"
3209
3186
  },
3210
- "baileysStoredMessages": {
3187
+ "webhooks": {
3211
3188
  "type": "array"
3212
3189
  },
3213
- "chatStates": {
3190
+ "messages": {
3214
3191
  "type": "array"
3215
3192
  },
3216
- "conversationMappings": {
3193
+ "messageBatches": {
3217
3194
  "type": "array"
3218
3195
  },
3219
- "ingressEvents": {
3196
+ "templates": {
3220
3197
  "type": "array"
3221
3198
  },
3222
- "integrationDeliveryFailures": {
3199
+ "baileysStoredMessages": {
3223
3200
  "type": "array"
3224
3201
  },
3225
3202
  "lidMappings": {
3226
3203
  "type": "array"
3227
3204
  },
3228
- "messageBatches": {
3205
+ "chatStates": {
3229
3206
  "type": "array"
3230
3207
  },
3231
- "messages": {
3208
+ "pluginInstances": {
3232
3209
  "type": "array"
3233
3210
  },
3234
- "pluginInstances": {
3211
+ "conversationMappings": {
3235
3212
  "type": "array"
3236
3213
  },
3237
- "sessions": {
3214
+ "ingressEvents": {
3238
3215
  "type": "array"
3239
3216
  },
3240
- "statusUpdates": {
3217
+ "webhookDeliveryFailures": {
3241
3218
  "type": "array"
3242
3219
  },
3243
- "templates": {
3220
+ "webhookOutboxEvents": {
3244
3221
  "type": "array"
3245
3222
  },
3246
- "webhookDeliveryFailures": {
3223
+ "integrationDeliveryFailures": {
3247
3224
  "type": "array"
3248
3225
  },
3249
- "webhookOutboxEvents": {
3226
+ "statusUpdates": {
3250
3227
  "type": "array"
3251
3228
  },
3252
- "webhooks": {
3229
+ "automationRules": {
3253
3230
  "type": "array"
3254
3231
  }
3255
3232
  }
3233
+ },
3234
+ "force": {
3235
+ "type": "boolean",
3236
+ "description": "Allow the replace to proceed even while engines are running for sessions the backup does not contain (they keep running until restart; see restartRequired)."
3237
+ },
3238
+ "stopOrphans": {
3239
+ "type": "boolean",
3240
+ "description": "Stop the running engines for sessions the backup does not contain, inside this request and before the replace runs."
3241
+ },
3242
+ "exportedAt": {
3243
+ "type": "string",
3244
+ "description": "Ignored."
3245
+ },
3246
+ "dataDbType": {
3247
+ "type": "string",
3248
+ "description": "Ignored."
3249
+ },
3250
+ "counts": {
3251
+ "type": "object",
3252
+ "description": "Ignored.",
3253
+ "additionalProperties": {
3254
+ "type": "number"
3255
+ }
3256
+ },
3257
+ "skippedTables": {
3258
+ "type": "array",
3259
+ "description": "Ignored.",
3260
+ "items": {
3261
+ "type": "string"
3262
+ }
3263
+ },
3264
+ "omittedInlineMedia": {
3265
+ "type": "object",
3266
+ "description": "Ignored.",
3267
+ "additionalProperties": {
3268
+ "type": "number"
3269
+ }
3256
3270
  }
3257
3271
  },
3258
3272
  "additionalProperties": false,
@@ -3884,11 +3898,11 @@ export const OPENWA_OPERATIONS = [
3884
3898
  ],
3885
3899
  "queryParams": [],
3886
3900
  "bodyParams": [
3887
- "config",
3888
3901
  "instanceId",
3889
- "secret",
3890
3902
  "sessionScope",
3891
- "verifyToken"
3903
+ "verifyToken",
3904
+ "secret",
3905
+ "config"
3892
3906
  ],
3893
3907
  "fileParams": [],
3894
3908
  "bodyMode": "json",
@@ -3899,25 +3913,31 @@ export const OPENWA_OPERATIONS = [
3899
3913
  "pluginId": {
3900
3914
  "type": "string"
3901
3915
  },
3902
- "config": {
3903
- "type": "object",
3904
- "description": "Per-instance config slice passed to the adapter (shape defined by the plugin)."
3905
- },
3906
3916
  "instanceId": {
3907
3917
  "type": "string",
3908
- "description": "Operator-chosen instance id (unique within the plugin)."
3909
- },
3910
- "secret": {
3911
- "type": "string",
3912
- "description": "Ingress HMAC secret shared with the provider."
3918
+ "description": "Operator-chosen instance id (unique within the plugin).",
3919
+ "pattern": "^[a-zA-Z0-9_-]{1,64}$"
3913
3920
  },
3914
3921
  "sessionScope": {
3915
3922
  "type": "string",
3916
- "description": "Session id the instance is scoped to."
3923
+ "description": "Session id the instance is scoped to.",
3924
+ "minLength": 1,
3925
+ "maxLength": 256
3917
3926
  },
3918
3927
  "verifyToken": {
3919
3928
  "type": "string",
3920
- "description": "Token echoed back for the provider webhook verification handshake."
3929
+ "description": "Token echoed back for the provider webhook verification handshake.",
3930
+ "maxLength": 512
3931
+ },
3932
+ "secret": {
3933
+ "type": "string",
3934
+ "description": "Ingress HMAC secret shared with the provider.",
3935
+ "minLength": 16,
3936
+ "maxLength": 512
3937
+ },
3938
+ "config": {
3939
+ "type": "object",
3940
+ "description": "Per-instance config slice passed to the adapter (shape defined by the plugin)."
3921
3941
  }
3922
3942
  },
3923
3943
  "additionalProperties": false,
@@ -4034,9 +4054,9 @@ export const OPENWA_OPERATIONS = [
4034
4054
  ],
4035
4055
  "queryParams": [],
4036
4056
  "bodyParams": [
4037
- "config",
4038
4057
  "enabled",
4039
- "sessionScope"
4058
+ "sessionScope",
4059
+ "config"
4040
4060
  ],
4041
4061
  "fileParams": [],
4042
4062
  "bodyMode": "json",
@@ -4050,10 +4070,6 @@ export const OPENWA_OPERATIONS = [
4050
4070
  "instanceId": {
4051
4071
  "type": "string"
4052
4072
  },
4053
- "config": {
4054
- "type": "object",
4055
- "description": "Per-instance config slice passed to the adapter."
4056
- },
4057
4073
  "enabled": {
4058
4074
  "type": "boolean",
4059
4075
  "description": "Whether the instance is enabled (ingress accepted, dispatch active)."
@@ -4063,7 +4079,13 @@ export const OPENWA_OPERATIONS = [
4063
4079
  "string",
4064
4080
  "null"
4065
4081
  ],
4066
- "description": "Session id to bind the instance to, or null for all sessions."
4082
+ "description": "Session id to bind the instance to, or null for all sessions.",
4083
+ "minLength": 1,
4084
+ "maxLength": 256
4085
+ },
4086
+ "config": {
4087
+ "type": "object",
4088
+ "description": "Per-instance config slice passed to the adapter."
4067
4089
  }
4068
4090
  },
4069
4091
  "additionalProperties": false,
@@ -4461,8 +4483,8 @@ export const OPENWA_OPERATIONS = [
4461
4483
  ],
4462
4484
  "queryParams": [],
4463
4485
  "bodyParams": [
4464
- "color",
4465
- "name"
4486
+ "name",
4487
+ "color"
4466
4488
  ],
4467
4489
  "fileParams": [],
4468
4490
  "bodyMode": "json",
@@ -4474,17 +4496,17 @@ export const OPENWA_OPERATIONS = [
4474
4496
  "type": "string",
4475
4497
  "description": "Label ID — caller-chosen"
4476
4498
  },
4477
- "color": {
4478
- "type": "number",
4479
- "description": "WhatsApp's colour INDEX (0-19), not a hex value — the read path's `hexColor` cannot be translated back, because neither engine exposes the mapping.",
4480
- "minimum": 0,
4481
- "maximum": 19
4482
- },
4483
4499
  "name": {
4484
4500
  "type": "string",
4485
4501
  "description": "Label name.",
4486
4502
  "minLength": 1,
4487
4503
  "maxLength": 100
4504
+ },
4505
+ "color": {
4506
+ "type": "number",
4507
+ "description": "WhatsApp's colour INDEX (0-19), not a hex value — the read path's `hexColor` cannot be translated back, because neither engine exposes the mapping.",
4508
+ "minimum": 0,
4509
+ "maximum": 19
4488
4510
  }
4489
4511
  },
4490
4512
  "additionalProperties": false,
@@ -4544,8 +4566,8 @@ export const OPENWA_OPERATIONS = [
4544
4566
  "pathParams": [],
4545
4567
  "queryParams": [],
4546
4568
  "bodyParams": [
4547
- "base64",
4548
- "url"
4569
+ "url",
4570
+ "base64"
4549
4571
  ],
4550
4572
  "fileParams": [],
4551
4573
  "bodyMode": "json",
@@ -4553,13 +4575,13 @@ export const OPENWA_OPERATIONS = [
4553
4575
  "args": {
4554
4576
  "type": "object",
4555
4577
  "properties": {
4556
- "base64": {
4557
- "type": "string",
4558
- "description": "Base64-encoded media to convert."
4559
- },
4560
4578
  "url": {
4561
4579
  "type": "string",
4562
4580
  "description": "Public http(s) URL of the media to convert (server-fetched, SSRF-guarded)."
4581
+ },
4582
+ "base64": {
4583
+ "type": "string",
4584
+ "description": "Base64-encoded media to convert."
4563
4585
  }
4564
4586
  },
4565
4587
  "additionalProperties": false
@@ -4586,8 +4608,8 @@ export const OPENWA_OPERATIONS = [
4586
4608
  "pathParams": [],
4587
4609
  "queryParams": [],
4588
4610
  "bodyParams": [
4589
- "base64",
4590
- "url"
4611
+ "url",
4612
+ "base64"
4591
4613
  ],
4592
4614
  "fileParams": [],
4593
4615
  "bodyMode": "json",
@@ -4595,13 +4617,13 @@ export const OPENWA_OPERATIONS = [
4595
4617
  "args": {
4596
4618
  "type": "object",
4597
4619
  "properties": {
4598
- "base64": {
4599
- "type": "string",
4600
- "description": "Base64-encoded media to convert."
4601
- },
4602
4620
  "url": {
4603
4621
  "type": "string",
4604
4622
  "description": "Public http(s) URL of the media to convert (server-fetched, SSRF-guarded)."
4623
+ },
4624
+ "base64": {
4625
+ "type": "string",
4626
+ "description": "Base64-encoded media to convert."
4605
4627
  }
4606
4628
  },
4607
4629
  "additionalProperties": false
@@ -4667,9 +4689,9 @@ export const OPENWA_OPERATIONS = [
4667
4689
  "pathParams": [],
4668
4690
  "queryParams": [],
4669
4691
  "bodyParams": [
4670
- "buttonId",
4671
4692
  "chatId",
4672
4693
  "messageId",
4694
+ "buttonId",
4673
4695
  "text"
4674
4696
  ],
4675
4697
  "fileParams": [],
@@ -4678,11 +4700,6 @@ export const OPENWA_OPERATIONS = [
4678
4700
  "args": {
4679
4701
  "type": "object",
4680
4702
  "properties": {
4681
- "buttonId": {
4682
- "type": "string",
4683
- "description": "Stable id of the choice to tap (inbound `buttons[].id`).",
4684
- "maxLength": 256
4685
- },
4686
4703
  "chatId": {
4687
4704
  "type": "string"
4688
4705
  },
@@ -4690,6 +4707,11 @@ export const OPENWA_OPERATIONS = [
4690
4707
  "type": "string",
4691
4708
  "description": "WhatsApp id of the business prompt message that offered the buttons."
4692
4709
  },
4710
+ "buttonId": {
4711
+ "type": "string",
4712
+ "description": "Stable id of the choice to tap (inbound `buttons[].id`).",
4713
+ "maxLength": 256
4714
+ },
4693
4715
  "text": {
4694
4716
  "type": "string",
4695
4717
  "description": "Visible label of the choice.",
@@ -4726,8 +4748,8 @@ export const OPENWA_OPERATIONS = [
4726
4748
  "queryParams": [],
4727
4749
  "bodyParams": [
4728
4750
  "chatId",
4729
- "forEveryone",
4730
- "messageId"
4751
+ "messageId",
4752
+ "forEveryone"
4731
4753
  ],
4732
4754
  "fileParams": [],
4733
4755
  "bodyMode": "json",
@@ -4738,12 +4760,12 @@ export const OPENWA_OPERATIONS = [
4738
4760
  "chatId": {
4739
4761
  "type": "string"
4740
4762
  },
4763
+ "messageId": {
4764
+ "type": "string"
4765
+ },
4741
4766
  "forEveryone": {
4742
4767
  "type": "boolean",
4743
4768
  "description": "Delete for everyone (default true)"
4744
- },
4745
- "messageId": {
4746
- "type": "string"
4747
4769
  }
4748
4770
  },
4749
4771
  "additionalProperties": false,
@@ -4774,10 +4796,10 @@ export const OPENWA_OPERATIONS = [
4774
4796
  "pathParams": [],
4775
4797
  "queryParams": [],
4776
4798
  "bodyParams": [
4777
- "body",
4778
4799
  "chatId",
4779
- "mentions",
4780
- "messageId"
4800
+ "messageId",
4801
+ "body",
4802
+ "mentions"
4781
4803
  ],
4782
4804
  "fileParams": [],
4783
4805
  "bodyMode": "json",
@@ -4785,23 +4807,25 @@ export const OPENWA_OPERATIONS = [
4785
4807
  "args": {
4786
4808
  "type": "object",
4787
4809
  "properties": {
4810
+ "chatId": {
4811
+ "type": "string"
4812
+ },
4813
+ "messageId": {
4814
+ "type": "string"
4815
+ },
4788
4816
  "body": {
4789
4817
  "type": "string",
4790
4818
  "description": "New text body for the message",
4791
4819
  "maxLength": 4096
4792
4820
  },
4793
- "chatId": {
4794
- "type": "string"
4795
- },
4796
4821
  "mentions": {
4797
4822
  "type": "array",
4798
4823
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
4824
+ "maxItems": 1024,
4799
4825
  "items": {
4800
- "type": "string"
4826
+ "type": "string",
4827
+ "maxLength": 64
4801
4828
  }
4802
- },
4803
- "messageId": {
4804
- "type": "string"
4805
4829
  }
4806
4830
  },
4807
4831
  "additionalProperties": false,
@@ -4834,8 +4858,8 @@ export const OPENWA_OPERATIONS = [
4834
4858
  "queryParams": [],
4835
4859
  "bodyParams": [
4836
4860
  "fromChatId",
4837
- "messageId",
4838
- "toChatId"
4861
+ "toChatId",
4862
+ "messageId"
4839
4863
  ],
4840
4864
  "fileParams": [],
4841
4865
  "bodyMode": "json",
@@ -4846,10 +4870,10 @@ export const OPENWA_OPERATIONS = [
4846
4870
  "fromChatId": {
4847
4871
  "type": "string"
4848
4872
  },
4849
- "messageId": {
4873
+ "toChatId": {
4850
4874
  "type": "string"
4851
4875
  },
4852
- "toChatId": {
4876
+ "messageId": {
4853
4877
  "type": "string"
4854
4878
  }
4855
4879
  },
@@ -5038,7 +5062,7 @@ export const OPENWA_OPERATIONS = [
5038
5062
  "properties": {
5039
5063
  "chatId": {
5040
5064
  "type": "string",
5041
- "description": "Filter by chat ID"
5065
+ "description": "Filter by chat ID."
5042
5066
  },
5043
5067
  "from": {
5044
5068
  "type": "string",
@@ -5131,8 +5155,8 @@ export const OPENWA_OPERATIONS = [
5131
5155
  "queryParams": [],
5132
5156
  "bodyParams": [
5133
5157
  "chatId",
5134
- "durationSeconds",
5135
- "messageId"
5158
+ "messageId",
5159
+ "durationSeconds"
5136
5160
  ],
5137
5161
  "fileParams": [],
5138
5162
  "bodyMode": "json",
@@ -5143,6 +5167,9 @@ export const OPENWA_OPERATIONS = [
5143
5167
  "chatId": {
5144
5168
  "type": "string"
5145
5169
  },
5170
+ "messageId": {
5171
+ "type": "string"
5172
+ },
5146
5173
  "durationSeconds": {
5147
5174
  "type": "number",
5148
5175
  "description": "Pin duration in seconds: 86400 (24h), 604800 (7d) or 2592000 (30d).",
@@ -5152,9 +5179,6 @@ export const OPENWA_OPERATIONS = [
5152
5179
  2592000
5153
5180
  ],
5154
5181
  "default": 86400
5155
- },
5156
- "messageId": {
5157
- "type": "string"
5158
5182
  }
5159
5183
  },
5160
5184
  "additionalProperties": false,
@@ -5186,8 +5210,8 @@ export const OPENWA_OPERATIONS = [
5186
5210
  "queryParams": [],
5187
5211
  "bodyParams": [
5188
5212
  "chatId",
5189
- "emoji",
5190
- "messageId"
5213
+ "messageId",
5214
+ "emoji"
5191
5215
  ],
5192
5216
  "fileParams": [],
5193
5217
  "bodyMode": "json",
@@ -5198,13 +5222,13 @@ export const OPENWA_OPERATIONS = [
5198
5222
  "chatId": {
5199
5223
  "type": "string"
5200
5224
  },
5225
+ "messageId": {
5226
+ "type": "string"
5227
+ },
5201
5228
  "emoji": {
5202
5229
  "type": "string",
5203
5230
  "description": "Emoji to react with.",
5204
5231
  "maxLength": 32
5205
- },
5206
- "messageId": {
5207
- "type": "string"
5208
5232
  }
5209
5233
  },
5210
5234
  "additionalProperties": false,
@@ -5237,9 +5261,9 @@ export const OPENWA_OPERATIONS = [
5237
5261
  "queryParams": [],
5238
5262
  "bodyParams": [
5239
5263
  "chatId",
5240
- "mentions",
5241
5264
  "quotedMessageId",
5242
- "text"
5265
+ "text",
5266
+ "mentions"
5243
5267
  ],
5244
5268
  "fileParams": [],
5245
5269
  "bodyMode": "json",
@@ -5250,19 +5274,21 @@ export const OPENWA_OPERATIONS = [
5250
5274
  "chatId": {
5251
5275
  "type": "string"
5252
5276
  },
5253
- "mentions": {
5254
- "type": "array",
5255
- "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5256
- "items": {
5257
- "type": "string"
5258
- }
5259
- },
5260
5277
  "quotedMessageId": {
5261
5278
  "type": "string"
5262
5279
  },
5263
5280
  "text": {
5264
5281
  "type": "string",
5265
5282
  "maxLength": 4096
5283
+ },
5284
+ "mentions": {
5285
+ "type": "array",
5286
+ "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5287
+ "maxItems": 1024,
5288
+ "items": {
5289
+ "type": "string",
5290
+ "maxLength": 64
5291
+ }
5266
5292
  }
5267
5293
  },
5268
5294
  "additionalProperties": false,
@@ -5294,15 +5320,15 @@ export const OPENWA_OPERATIONS = [
5294
5320
  "pathParams": [],
5295
5321
  "queryParams": [],
5296
5322
  "bodyParams": [
5297
- "base64",
5298
- "caption",
5299
5323
  "chatId",
5324
+ "url",
5325
+ "base64",
5326
+ "mimetype",
5300
5327
  "filename",
5328
+ "caption",
5301
5329
  "mentions",
5302
- "mimetype",
5303
- "ptt",
5304
5330
  "quotedMessageId",
5305
- "url"
5331
+ "ptt"
5306
5332
  ],
5307
5333
  "fileParams": [],
5308
5334
  "bodyMode": "json",
@@ -5310,45 +5336,48 @@ export const OPENWA_OPERATIONS = [
5310
5336
  "args": {
5311
5337
  "type": "object",
5312
5338
  "properties": {
5339
+ "chatId": {
5340
+ "type": "string",
5341
+ "description": "WhatsApp chat ID"
5342
+ },
5343
+ "url": {
5344
+ "type": "string",
5345
+ "description": "Media URL (http/https)"
5346
+ },
5313
5347
  "base64": {
5314
5348
  "type": "string",
5315
5349
  "description": "Base64 encoded media data"
5316
5350
  },
5317
- "caption": {
5351
+ "mimetype": {
5318
5352
  "type": "string",
5319
- "description": "Caption for the media",
5320
- "maxLength": 1024
5353
+ "description": "Media MIME type (required when using base64)"
5321
5354
  },
5322
- "chatId": {
5355
+ "filename": {
5323
5356
  "type": "string",
5324
- "description": "WhatsApp chat ID"
5357
+ "description": "Filename for the media.",
5358
+ "maxLength": 255
5325
5359
  },
5326
- "filename": {
5360
+ "caption": {
5327
5361
  "type": "string",
5328
- "description": "Filename for the media."
5362
+ "description": "Caption for the media",
5363
+ "maxLength": 1024
5329
5364
  },
5330
5365
  "mentions": {
5331
5366
  "type": "array",
5332
5367
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5368
+ "maxItems": 1024,
5333
5369
  "items": {
5334
- "type": "string"
5370
+ "type": "string",
5371
+ "maxLength": 64
5335
5372
  }
5336
5373
  },
5337
- "mimetype": {
5374
+ "quotedMessageId": {
5338
5375
  "type": "string",
5339
- "description": "Media MIME type (required when using base64)"
5376
+ "description": "Quote an earlier message, turning this send into a reply."
5340
5377
  },
5341
5378
  "ptt": {
5342
5379
  "type": "boolean",
5343
5380
  "description": "Send as a WhatsApp voice note (PTT — mic bubble + waveform)."
5344
- },
5345
- "quotedMessageId": {
5346
- "type": "string",
5347
- "description": "Quote an earlier message, turning this send into a reply."
5348
- },
5349
- "url": {
5350
- "type": "string",
5351
- "description": "Media URL (http/https)"
5352
5381
  }
5353
5382
  },
5354
5383
  "additionalProperties": false,
@@ -5395,6 +5424,7 @@ export const OPENWA_OPERATIONS = [
5395
5424
  "messages": {
5396
5425
  "type": "array",
5397
5426
  "description": "Array of messages (max 100 per request; exact duplicate entries are collapsed — first occurrence wins)",
5427
+ "maxItems": 100,
5398
5428
  "items": {
5399
5429
  "type": "object",
5400
5430
  "properties": {
@@ -5402,144 +5432,146 @@ export const OPENWA_OPERATIONS = [
5402
5432
  "type": "string",
5403
5433
  "description": "Recipient chat ID"
5404
5434
  },
5435
+ "type": {
5436
+ "type": "string",
5437
+ "description": "Message type",
5438
+ "enum": [
5439
+ "text",
5440
+ "image",
5441
+ "video",
5442
+ "audio",
5443
+ "document"
5444
+ ]
5445
+ },
5405
5446
  "content": {
5406
5447
  "type": "object",
5407
5448
  "properties": {
5408
- "audio": {
5449
+ "text": {
5450
+ "type": "string",
5451
+ "description": "Text content for text messages",
5452
+ "maxLength": 4096
5453
+ },
5454
+ "image": {
5409
5455
  "type": "object",
5410
5456
  "properties": {
5411
- "base64": {
5457
+ "url": {
5412
5458
  "type": "string",
5413
- "description": "Base64-encoded media data"
5459
+ "description": "Media URL (http/https)"
5414
5460
  },
5415
- "filename": {
5461
+ "base64": {
5416
5462
  "type": "string",
5417
- "description": "Filename (documents only)"
5463
+ "description": "Base64-encoded media data"
5418
5464
  },
5419
5465
  "mimetype": {
5420
5466
  "type": "string",
5421
5467
  "description": "Media MIME type"
5422
5468
  },
5469
+ "filename": {
5470
+ "type": "string",
5471
+ "description": "Filename (documents only)"
5472
+ },
5423
5473
  "ptt": {
5424
5474
  "type": "boolean",
5425
5475
  "description": "Audio only: send as a WhatsApp voice note (PTT)"
5426
- },
5427
- "url": {
5428
- "type": "string",
5429
- "description": "Media URL (http/https)"
5430
5476
  }
5431
5477
  },
5432
- "description": "Audio URL or base64"
5433
- },
5434
- "caption": {
5435
- "type": "string",
5436
- "description": "Caption for media messages",
5437
- "maxLength": 1024
5478
+ "description": "Image URL or base64"
5438
5479
  },
5439
- "document": {
5480
+ "video": {
5440
5481
  "type": "object",
5441
5482
  "properties": {
5442
- "base64": {
5483
+ "url": {
5443
5484
  "type": "string",
5444
- "description": "Base64-encoded media data"
5485
+ "description": "Media URL (http/https)"
5445
5486
  },
5446
- "filename": {
5487
+ "base64": {
5447
5488
  "type": "string",
5448
- "description": "Filename (documents only)"
5489
+ "description": "Base64-encoded media data"
5449
5490
  },
5450
5491
  "mimetype": {
5451
5492
  "type": "string",
5452
5493
  "description": "Media MIME type"
5453
5494
  },
5495
+ "filename": {
5496
+ "type": "string",
5497
+ "description": "Filename (documents only)"
5498
+ },
5454
5499
  "ptt": {
5455
5500
  "type": "boolean",
5456
5501
  "description": "Audio only: send as a WhatsApp voice note (PTT)"
5457
- },
5458
- "url": {
5459
- "type": "string",
5460
- "description": "Media URL (http/https)"
5461
5502
  }
5462
5503
  },
5463
- "description": "Document URL or base64"
5504
+ "description": "Video URL or base64"
5464
5505
  },
5465
- "image": {
5506
+ "audio": {
5466
5507
  "type": "object",
5467
5508
  "properties": {
5468
- "base64": {
5509
+ "url": {
5469
5510
  "type": "string",
5470
- "description": "Base64-encoded media data"
5511
+ "description": "Media URL (http/https)"
5471
5512
  },
5472
- "filename": {
5513
+ "base64": {
5473
5514
  "type": "string",
5474
- "description": "Filename (documents only)"
5515
+ "description": "Base64-encoded media data"
5475
5516
  },
5476
5517
  "mimetype": {
5477
5518
  "type": "string",
5478
5519
  "description": "Media MIME type"
5479
5520
  },
5521
+ "filename": {
5522
+ "type": "string",
5523
+ "description": "Filename (documents only)"
5524
+ },
5480
5525
  "ptt": {
5481
5526
  "type": "boolean",
5482
5527
  "description": "Audio only: send as a WhatsApp voice note (PTT)"
5483
- },
5484
- "url": {
5485
- "type": "string",
5486
- "description": "Media URL (http/https)"
5487
5528
  }
5488
5529
  },
5489
- "description": "Image URL or base64"
5490
- },
5491
- "mentions": {
5492
- "type": "array",
5493
- "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5494
- "items": {
5495
- "type": "string"
5496
- }
5497
- },
5498
- "text": {
5499
- "type": "string",
5500
- "description": "Text content for text messages",
5501
- "maxLength": 4096
5530
+ "description": "Audio URL or base64"
5502
5531
  },
5503
- "video": {
5532
+ "document": {
5504
5533
  "type": "object",
5505
5534
  "properties": {
5506
- "base64": {
5535
+ "url": {
5507
5536
  "type": "string",
5508
- "description": "Base64-encoded media data"
5537
+ "description": "Media URL (http/https)"
5509
5538
  },
5510
- "filename": {
5539
+ "base64": {
5511
5540
  "type": "string",
5512
- "description": "Filename (documents only)"
5541
+ "description": "Base64-encoded media data"
5513
5542
  },
5514
5543
  "mimetype": {
5515
5544
  "type": "string",
5516
5545
  "description": "Media MIME type"
5517
5546
  },
5547
+ "filename": {
5548
+ "type": "string",
5549
+ "description": "Filename (documents only)"
5550
+ },
5518
5551
  "ptt": {
5519
5552
  "type": "boolean",
5520
5553
  "description": "Audio only: send as a WhatsApp voice note (PTT)"
5521
- },
5522
- "url": {
5523
- "type": "string",
5524
- "description": "Media URL (http/https)"
5525
5554
  }
5526
5555
  },
5527
- "description": "Video URL or base64"
5556
+ "description": "Document URL or base64"
5557
+ },
5558
+ "caption": {
5559
+ "type": "string",
5560
+ "description": "Caption for media messages",
5561
+ "maxLength": 1024
5562
+ },
5563
+ "mentions": {
5564
+ "type": "array",
5565
+ "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5566
+ "maxItems": 1024,
5567
+ "items": {
5568
+ "type": "string",
5569
+ "maxLength": 64
5570
+ }
5528
5571
  }
5529
5572
  },
5530
5573
  "description": "Message content based on type"
5531
5574
  },
5532
- "type": {
5533
- "type": "string",
5534
- "description": "Message type",
5535
- "enum": [
5536
- "text",
5537
- "image",
5538
- "video",
5539
- "audio",
5540
- "document"
5541
- ]
5542
- },
5543
5575
  "variables": {
5544
5576
  "type": "object",
5545
5577
  "description": "Variables for template substitution"
@@ -5659,14 +5691,14 @@ export const OPENWA_OPERATIONS = [
5659
5691
  "pathParams": [],
5660
5692
  "queryParams": [],
5661
5693
  "bodyParams": [
5662
- "base64",
5663
- "caption",
5664
5694
  "chatId",
5695
+ "url",
5696
+ "base64",
5697
+ "mimetype",
5665
5698
  "filename",
5699
+ "caption",
5666
5700
  "mentions",
5667
- "mimetype",
5668
- "quotedMessageId",
5669
- "url"
5701
+ "quotedMessageId"
5670
5702
  ],
5671
5703
  "fileParams": [],
5672
5704
  "bodyMode": "json",
@@ -5674,41 +5706,44 @@ export const OPENWA_OPERATIONS = [
5674
5706
  "args": {
5675
5707
  "type": "object",
5676
5708
  "properties": {
5709
+ "chatId": {
5710
+ "type": "string",
5711
+ "description": "WhatsApp chat ID"
5712
+ },
5713
+ "url": {
5714
+ "type": "string",
5715
+ "description": "Media URL (http/https)"
5716
+ },
5677
5717
  "base64": {
5678
5718
  "type": "string",
5679
5719
  "description": "Base64 encoded media data"
5680
5720
  },
5681
- "caption": {
5721
+ "mimetype": {
5682
5722
  "type": "string",
5683
- "description": "Caption for the media",
5684
- "maxLength": 1024
5723
+ "description": "Media MIME type (required when using base64)"
5685
5724
  },
5686
- "chatId": {
5725
+ "filename": {
5687
5726
  "type": "string",
5688
- "description": "WhatsApp chat ID"
5727
+ "description": "Filename for the media.",
5728
+ "maxLength": 255
5689
5729
  },
5690
- "filename": {
5730
+ "caption": {
5691
5731
  "type": "string",
5692
- "description": "Filename for the media."
5732
+ "description": "Caption for the media",
5733
+ "maxLength": 1024
5693
5734
  },
5694
5735
  "mentions": {
5695
5736
  "type": "array",
5696
5737
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5738
+ "maxItems": 1024,
5697
5739
  "items": {
5698
- "type": "string"
5740
+ "type": "string",
5741
+ "maxLength": 64
5699
5742
  }
5700
5743
  },
5701
- "mimetype": {
5702
- "type": "string",
5703
- "description": "Media MIME type (required when using base64)"
5704
- },
5705
5744
  "quotedMessageId": {
5706
5745
  "type": "string",
5707
5746
  "description": "Quote an earlier message, turning this send into a reply."
5708
- },
5709
- "url": {
5710
- "type": "string",
5711
- "description": "Media URL (http/https)"
5712
5747
  }
5713
5748
  },
5714
5749
  "additionalProperties": false,
@@ -5738,14 +5773,14 @@ export const OPENWA_OPERATIONS = [
5738
5773
  "pathParams": [],
5739
5774
  "queryParams": [],
5740
5775
  "bodyParams": [
5741
- "base64",
5742
- "caption",
5743
5776
  "chatId",
5777
+ "url",
5778
+ "base64",
5779
+ "mimetype",
5744
5780
  "filename",
5781
+ "caption",
5745
5782
  "mentions",
5746
- "mimetype",
5747
- "quotedMessageId",
5748
- "url"
5783
+ "quotedMessageId"
5749
5784
  ],
5750
5785
  "fileParams": [],
5751
5786
  "bodyMode": "json",
@@ -5753,41 +5788,44 @@ export const OPENWA_OPERATIONS = [
5753
5788
  "args": {
5754
5789
  "type": "object",
5755
5790
  "properties": {
5791
+ "chatId": {
5792
+ "type": "string",
5793
+ "description": "WhatsApp chat ID"
5794
+ },
5795
+ "url": {
5796
+ "type": "string",
5797
+ "description": "Media URL (http/https)"
5798
+ },
5756
5799
  "base64": {
5757
5800
  "type": "string",
5758
5801
  "description": "Base64 encoded media data"
5759
5802
  },
5760
- "caption": {
5803
+ "mimetype": {
5761
5804
  "type": "string",
5762
- "description": "Caption for the media",
5763
- "maxLength": 1024
5805
+ "description": "Media MIME type (required when using base64)"
5764
5806
  },
5765
- "chatId": {
5807
+ "filename": {
5766
5808
  "type": "string",
5767
- "description": "WhatsApp chat ID"
5809
+ "description": "Filename for the media.",
5810
+ "maxLength": 255
5768
5811
  },
5769
- "filename": {
5812
+ "caption": {
5770
5813
  "type": "string",
5771
- "description": "Filename for the media."
5814
+ "description": "Caption for the media",
5815
+ "maxLength": 1024
5772
5816
  },
5773
5817
  "mentions": {
5774
5818
  "type": "array",
5775
5819
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
5820
+ "maxItems": 1024,
5776
5821
  "items": {
5777
- "type": "string"
5822
+ "type": "string",
5823
+ "maxLength": 64
5778
5824
  }
5779
5825
  },
5780
- "mimetype": {
5781
- "type": "string",
5782
- "description": "Media MIME type (required when using base64)"
5783
- },
5784
5826
  "quotedMessageId": {
5785
5827
  "type": "string",
5786
5828
  "description": "Quote an earlier message, turning this send into a reply."
5787
- },
5788
- "url": {
5789
- "type": "string",
5790
- "description": "Media URL (http/https)"
5791
5829
  }
5792
5830
  },
5793
5831
  "additionalProperties": false,
@@ -5817,11 +5855,11 @@ export const OPENWA_OPERATIONS = [
5817
5855
  "pathParams": [],
5818
5856
  "queryParams": [],
5819
5857
  "bodyParams": [
5820
- "address",
5821
5858
  "chatId",
5822
- "description",
5823
5859
  "latitude",
5824
5860
  "longitude",
5861
+ "description",
5862
+ "address",
5825
5863
  "quotedMessageId"
5826
5864
  ],
5827
5865
  "fileParams": [],
@@ -5830,24 +5868,24 @@ export const OPENWA_OPERATIONS = [
5830
5868
  "args": {
5831
5869
  "type": "object",
5832
5870
  "properties": {
5833
- "address": {
5834
- "type": "string",
5835
- "maxLength": 1024
5836
- },
5837
5871
  "chatId": {
5838
5872
  "type": "string",
5839
5873
  "description": "Chat ID (e.g. 628123456789@c.us)"
5840
5874
  },
5841
- "description": {
5842
- "type": "string",
5843
- "maxLength": 1024
5844
- },
5845
5875
  "latitude": {
5846
5876
  "type": "number"
5847
5877
  },
5848
5878
  "longitude": {
5849
5879
  "type": "number"
5850
5880
  },
5881
+ "description": {
5882
+ "type": "string",
5883
+ "maxLength": 1024
5884
+ },
5885
+ "address": {
5886
+ "type": "string",
5887
+ "maxLength": 1024
5888
+ },
5851
5889
  "quotedMessageId": {
5852
5890
  "type": "string",
5853
5891
  "description": "Quote an earlier message, turning this send into a reply."
@@ -5882,10 +5920,10 @@ export const OPENWA_OPERATIONS = [
5882
5920
  "pathParams": [],
5883
5921
  "queryParams": [],
5884
5922
  "bodyParams": [
5885
- "allowMultipleAnswers",
5886
5923
  "chatId",
5887
5924
  "name",
5888
5925
  "options",
5926
+ "allowMultipleAnswers",
5889
5927
  "quotedMessageId"
5890
5928
  ],
5891
5929
  "fileParams": [],
@@ -5894,10 +5932,6 @@ export const OPENWA_OPERATIONS = [
5894
5932
  "args": {
5895
5933
  "type": "object",
5896
5934
  "properties": {
5897
- "allowMultipleAnswers": {
5898
- "type": "boolean",
5899
- "description": "Allow voters to pick several options (default single choice)"
5900
- },
5901
5935
  "chatId": {
5902
5936
  "type": "string",
5903
5937
  "description": "Chat ID (e.g. 628123456789@c.us or 1203630000@g.us)"
@@ -5910,10 +5944,17 @@ export const OPENWA_OPERATIONS = [
5910
5944
  "options": {
5911
5945
  "type": "array",
5912
5946
  "description": "Options to vote on (WhatsApp allows between 2 and 12)",
5947
+ "minItems": 2,
5948
+ "maxItems": 12,
5913
5949
  "items": {
5914
- "type": "string"
5950
+ "type": "string",
5951
+ "maxLength": 100
5915
5952
  }
5916
5953
  },
5954
+ "allowMultipleAnswers": {
5955
+ "type": "boolean",
5956
+ "description": "Allow voters to pick several options (default single choice)"
5957
+ },
5917
5958
  "quotedMessageId": {
5918
5959
  "type": "string",
5919
5960
  "description": "Quote an earlier message, turning this send into a reply."
@@ -5948,14 +5989,14 @@ export const OPENWA_OPERATIONS = [
5948
5989
  "pathParams": [],
5949
5990
  "queryParams": [],
5950
5991
  "bodyParams": [
5951
- "base64",
5952
- "caption",
5953
5992
  "chatId",
5993
+ "url",
5994
+ "base64",
5995
+ "mimetype",
5954
5996
  "filename",
5997
+ "caption",
5955
5998
  "mentions",
5956
- "mimetype",
5957
- "quotedMessageId",
5958
- "url"
5999
+ "quotedMessageId"
5959
6000
  ],
5960
6001
  "fileParams": [],
5961
6002
  "bodyMode": "json",
@@ -5963,41 +6004,44 @@ export const OPENWA_OPERATIONS = [
5963
6004
  "args": {
5964
6005
  "type": "object",
5965
6006
  "properties": {
6007
+ "chatId": {
6008
+ "type": "string",
6009
+ "description": "WhatsApp chat ID"
6010
+ },
6011
+ "url": {
6012
+ "type": "string",
6013
+ "description": "Media URL (http/https)"
6014
+ },
5966
6015
  "base64": {
5967
6016
  "type": "string",
5968
6017
  "description": "Base64 encoded media data"
5969
6018
  },
5970
- "caption": {
6019
+ "mimetype": {
5971
6020
  "type": "string",
5972
- "description": "Caption for the media",
5973
- "maxLength": 1024
6021
+ "description": "Media MIME type (required when using base64)"
5974
6022
  },
5975
- "chatId": {
6023
+ "filename": {
5976
6024
  "type": "string",
5977
- "description": "WhatsApp chat ID"
6025
+ "description": "Filename for the media.",
6026
+ "maxLength": 255
5978
6027
  },
5979
- "filename": {
6028
+ "caption": {
5980
6029
  "type": "string",
5981
- "description": "Filename for the media."
6030
+ "description": "Caption for the media",
6031
+ "maxLength": 1024
5982
6032
  },
5983
6033
  "mentions": {
5984
6034
  "type": "array",
5985
6035
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6036
+ "maxItems": 1024,
5986
6037
  "items": {
5987
- "type": "string"
6038
+ "type": "string",
6039
+ "maxLength": 64
5988
6040
  }
5989
6041
  },
5990
- "mimetype": {
5991
- "type": "string",
5992
- "description": "Media MIME type (required when using base64)"
5993
- },
5994
6042
  "quotedMessageId": {
5995
6043
  "type": "string",
5996
6044
  "description": "Quote an earlier message, turning this send into a reply."
5997
- },
5998
- "url": {
5999
- "type": "string",
6000
- "description": "Media URL (http/https)"
6001
6045
  }
6002
6046
  },
6003
6047
  "additionalProperties": false,
@@ -6028,11 +6072,11 @@ export const OPENWA_OPERATIONS = [
6028
6072
  "queryParams": [],
6029
6073
  "bodyParams": [
6030
6074
  "chatId",
6031
- "linkPreview",
6032
- "mentions",
6033
6075
  "templateId",
6034
6076
  "templateName",
6035
- "vars"
6077
+ "vars",
6078
+ "mentions",
6079
+ "linkPreview"
6036
6080
  ],
6037
6081
  "fileParams": [],
6038
6082
  "bodyMode": "json",
@@ -6044,17 +6088,6 @@ export const OPENWA_OPERATIONS = [
6044
6088
  "type": "string",
6045
6089
  "description": "WhatsApp chat ID (phone@c.us for individual, groupId@g.us for groups)"
6046
6090
  },
6047
- "linkPreview": {
6048
- "type": "boolean",
6049
- "description": "Controls the URL preview on the rendered body, with the same engine split as send-text: whatsapp-web.js builds one by default and `false` suppresses it, while…"
6050
- },
6051
- "mentions": {
6052
- "type": "array",
6053
- "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6054
- "items": {
6055
- "type": "string"
6056
- }
6057
- },
6058
6091
  "templateId": {
6059
6092
  "type": "string",
6060
6093
  "description": "Template ID to render."
@@ -6066,6 +6099,19 @@ export const OPENWA_OPERATIONS = [
6066
6099
  "vars": {
6067
6100
  "type": "object",
6068
6101
  "description": "Variables substituted into {{placeholder}} tokens in the template"
6102
+ },
6103
+ "mentions": {
6104
+ "type": "array",
6105
+ "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6106
+ "maxItems": 1024,
6107
+ "items": {
6108
+ "type": "string",
6109
+ "maxLength": 64
6110
+ }
6111
+ },
6112
+ "linkPreview": {
6113
+ "type": "boolean",
6114
+ "description": "Controls the URL preview on the rendered body, with the same engine split as send-text: whatsapp-web.js builds one by default and `false` suppresses it, while…"
6069
6115
  }
6070
6116
  },
6071
6117
  "additionalProperties": false,
@@ -6096,11 +6142,11 @@ export const OPENWA_OPERATIONS = [
6096
6142
  "queryParams": [],
6097
6143
  "bodyParams": [
6098
6144
  "chatId",
6099
- "customLinkPreview",
6100
- "linkPreview",
6145
+ "text",
6101
6146
  "mentions",
6102
- "quotedMessageId",
6103
- "text"
6147
+ "linkPreview",
6148
+ "customLinkPreview",
6149
+ "quotedMessageId"
6104
6150
  ],
6105
6151
  "fileParams": [],
6106
6152
  "bodyMode": "json",
@@ -6112,22 +6158,41 @@ export const OPENWA_OPERATIONS = [
6112
6158
  "type": "string",
6113
6159
  "description": "WhatsApp chat ID (phone@c.us for individual, groupId@g.us for groups)"
6114
6160
  },
6161
+ "text": {
6162
+ "type": "string",
6163
+ "description": "Text message content",
6164
+ "maxLength": 4096
6165
+ },
6166
+ "mentions": {
6167
+ "type": "array",
6168
+ "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6169
+ "maxItems": 1024,
6170
+ "items": {
6171
+ "type": "string",
6172
+ "maxLength": 64
6173
+ }
6174
+ },
6175
+ "linkPreview": {
6176
+ "type": "boolean",
6177
+ "description": "Controls the URL preview, and the engines differ."
6178
+ },
6115
6179
  "customLinkPreview": {
6116
6180
  "type": "object",
6117
6181
  "properties": {
6118
- "description": {
6182
+ "url": {
6119
6183
  "type": "string",
6120
- "description": "Preview description",
6121
- "maxLength": 1024
6184
+ "description": "The URL as it appears in the message text — WhatsApp anchors the preview to it.",
6185
+ "maxLength": 2048
6122
6186
  },
6123
6187
  "title": {
6124
6188
  "type": "string",
6125
6189
  "description": "Required: WhatsApp will not render a preview without a title.",
6126
6190
  "maxLength": 256
6127
6191
  },
6128
- "url": {
6192
+ "description": {
6129
6193
  "type": "string",
6130
- "description": "The URL as it appears in the message text — WhatsApp anchors the preview to it."
6194
+ "description": "Preview description",
6195
+ "maxLength": 1024
6131
6196
  }
6132
6197
  },
6133
6198
  "required": [
@@ -6136,25 +6201,9 @@ export const OPENWA_OPERATIONS = [
6136
6201
  ],
6137
6202
  "description": "Attach a preview you supply yourself, instead of one fetched from the URL."
6138
6203
  },
6139
- "linkPreview": {
6140
- "type": "boolean",
6141
- "description": "Controls the URL preview, and the engines differ."
6142
- },
6143
- "mentions": {
6144
- "type": "array",
6145
- "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6146
- "items": {
6147
- "type": "string"
6148
- }
6149
- },
6150
6204
  "quotedMessageId": {
6151
6205
  "type": "string",
6152
6206
  "description": "Quote an earlier message, turning this send into a reply."
6153
- },
6154
- "text": {
6155
- "type": "string",
6156
- "description": "Text message content",
6157
- "maxLength": 4096
6158
6207
  }
6159
6208
  },
6160
6209
  "additionalProperties": false,
@@ -6185,14 +6234,14 @@ export const OPENWA_OPERATIONS = [
6185
6234
  "pathParams": [],
6186
6235
  "queryParams": [],
6187
6236
  "bodyParams": [
6188
- "base64",
6189
- "caption",
6190
6237
  "chatId",
6238
+ "url",
6239
+ "base64",
6240
+ "mimetype",
6191
6241
  "filename",
6242
+ "caption",
6192
6243
  "mentions",
6193
- "mimetype",
6194
- "quotedMessageId",
6195
- "url"
6244
+ "quotedMessageId"
6196
6245
  ],
6197
6246
  "fileParams": [],
6198
6247
  "bodyMode": "json",
@@ -6200,41 +6249,44 @@ export const OPENWA_OPERATIONS = [
6200
6249
  "args": {
6201
6250
  "type": "object",
6202
6251
  "properties": {
6252
+ "chatId": {
6253
+ "type": "string",
6254
+ "description": "WhatsApp chat ID"
6255
+ },
6256
+ "url": {
6257
+ "type": "string",
6258
+ "description": "Media URL (http/https)"
6259
+ },
6203
6260
  "base64": {
6204
6261
  "type": "string",
6205
6262
  "description": "Base64 encoded media data"
6206
6263
  },
6207
- "caption": {
6264
+ "mimetype": {
6208
6265
  "type": "string",
6209
- "description": "Caption for the media",
6210
- "maxLength": 1024
6266
+ "description": "Media MIME type (required when using base64)"
6211
6267
  },
6212
- "chatId": {
6268
+ "filename": {
6213
6269
  "type": "string",
6214
- "description": "WhatsApp chat ID"
6270
+ "description": "Filename for the media.",
6271
+ "maxLength": 255
6215
6272
  },
6216
- "filename": {
6273
+ "caption": {
6217
6274
  "type": "string",
6218
- "description": "Filename for the media."
6275
+ "description": "Caption for the media",
6276
+ "maxLength": 1024
6219
6277
  },
6220
6278
  "mentions": {
6221
6279
  "type": "array",
6222
6280
  "description": "WIDs to @mention (e.g. [\"62811@c.us\"]).",
6281
+ "maxItems": 1024,
6223
6282
  "items": {
6224
- "type": "string"
6283
+ "type": "string",
6284
+ "maxLength": 64
6225
6285
  }
6226
6286
  },
6227
- "mimetype": {
6228
- "type": "string",
6229
- "description": "Media MIME type (required when using base64)"
6230
- },
6231
6287
  "quotedMessageId": {
6232
6288
  "type": "string",
6233
6289
  "description": "Quote an earlier message, turning this send into a reply."
6234
- },
6235
- "url": {
6236
- "type": "string",
6237
- "description": "Media URL (http/https)"
6238
6290
  }
6239
6291
  },
6240
6292
  "additionalProperties": false,
@@ -6358,8 +6410,8 @@ export const OPENWA_OPERATIONS = [
6358
6410
  "queryParams": [],
6359
6411
  "bodyParams": [
6360
6412
  "chatId",
6361
- "options",
6362
- "pollMessageId"
6413
+ "pollMessageId",
6414
+ "options"
6363
6415
  ],
6364
6416
  "fileParams": [],
6365
6417
  "bodyMode": "json",
@@ -6370,6 +6422,10 @@ export const OPENWA_OPERATIONS = [
6370
6422
  "chatId": {
6371
6423
  "type": "string"
6372
6424
  },
6425
+ "pollMessageId": {
6426
+ "type": "string",
6427
+ "description": "The poll creation message to vote on."
6428
+ },
6373
6429
  "options": {
6374
6430
  "type": "array",
6375
6431
  "description": "The option TEXTS to select, exactly as they appear on the poll.",
@@ -6377,10 +6433,6 @@ export const OPENWA_OPERATIONS = [
6377
6433
  "items": {
6378
6434
  "type": "string"
6379
6435
  }
6380
- },
6381
- "pollMessageId": {
6382
- "type": "string",
6383
- "description": "The poll creation message to vote on."
6384
6436
  }
6385
6437
  },
6386
6438
  "additionalProperties": false,
@@ -7076,9 +7128,9 @@ export const OPENWA_OPERATIONS = [
7076
7128
  "pathParams": [],
7077
7129
  "queryParams": [],
7078
7130
  "bodyParams": [
7131
+ "url",
7079
7132
  "base64",
7080
- "mimetype",
7081
- "url"
7133
+ "mimetype"
7082
7134
  ],
7083
7135
  "fileParams": [],
7084
7136
  "bodyMode": "json",
@@ -7086,6 +7138,10 @@ export const OPENWA_OPERATIONS = [
7086
7138
  "args": {
7087
7139
  "type": "object",
7088
7140
  "properties": {
7141
+ "url": {
7142
+ "type": "string",
7143
+ "description": "Image URL (http/https)"
7144
+ },
7089
7145
  "base64": {
7090
7146
  "type": "string",
7091
7147
  "description": "Base64 encoded image data"
@@ -7093,10 +7149,6 @@ export const OPENWA_OPERATIONS = [
7093
7149
  "mimetype": {
7094
7150
  "type": "string",
7095
7151
  "description": "Image MIME type (required when using base64)"
7096
- },
7097
- "url": {
7098
- "type": "string",
7099
- "description": "Image URL (http/https)"
7100
7152
  }
7101
7153
  },
7102
7154
  "additionalProperties": false
@@ -7257,11 +7309,14 @@ export const OPENWA_OPERATIONS = [
7257
7309
  "description": "Epoch-ms upper bound (inclusive)"
7258
7310
  },
7259
7311
  "limit": {
7260
- "type": "number",
7312
+ "type": "integer",
7313
+ "minimum": 1,
7261
7314
  "description": "Max hits to return"
7262
7315
  },
7263
7316
  "offset": {
7264
- "type": "number",
7317
+ "type": "integer",
7318
+ "minimum": 0,
7319
+ "maximum": 100000,
7265
7320
  "description": "Pagination offset, at most 100000"
7266
7321
  }
7267
7322
  },
@@ -7292,8 +7347,8 @@ export const OPENWA_OPERATIONS = [
7292
7347
  "pathParams": [],
7293
7348
  "queryParams": [],
7294
7349
  "bodyParams": [
7295
- "archive",
7296
- "chatId"
7350
+ "chatId",
7351
+ "archive"
7297
7352
  ],
7298
7353
  "fileParams": [],
7299
7354
  "bodyMode": "json",
@@ -7301,13 +7356,13 @@ export const OPENWA_OPERATIONS = [
7301
7356
  "args": {
7302
7357
  "type": "object",
7303
7358
  "properties": {
7304
- "archive": {
7305
- "type": "boolean",
7306
- "description": "true to archive, false to unarchive."
7307
- },
7308
7359
  "chatId": {
7309
7360
  "type": "string",
7310
7361
  "description": "Chat ID in the active engine's native format (e.g. 1234567890-123@g.us on whatsapp-web.js)"
7362
+ },
7363
+ "archive": {
7364
+ "type": "boolean",
7365
+ "description": "true to archive, false to unarchive."
7311
7366
  }
7312
7367
  },
7313
7368
  "additionalProperties": false,
@@ -7378,10 +7433,10 @@ export const OPENWA_OPERATIONS = [
7378
7433
  "pathParams": [],
7379
7434
  "queryParams": [],
7380
7435
  "bodyParams": [
7381
- "config",
7382
7436
  "name",
7383
- "proxyType",
7384
- "proxyUrl"
7437
+ "config",
7438
+ "proxyUrl",
7439
+ "proxyType"
7385
7440
  ],
7386
7441
  "fileParams": [],
7387
7442
  "bodyMode": "json",
@@ -7389,29 +7444,30 @@ export const OPENWA_OPERATIONS = [
7389
7444
  "args": {
7390
7445
  "type": "object",
7391
7446
  "properties": {
7392
- "config": {
7393
- "type": "object",
7394
- "description": "Session configuration."
7395
- },
7396
7447
  "name": {
7397
7448
  "type": "string",
7398
7449
  "description": "Unique name for the session (alphanumeric and hyphens only)",
7399
7450
  "minLength": 3,
7400
7451
  "maxLength": 50
7401
7452
  },
7453
+ "config": {
7454
+ "type": "object",
7455
+ "description": "Session configuration."
7456
+ },
7457
+ "proxyUrl": {
7458
+ "type": "string",
7459
+ "description": "Optional per-session egress proxy URL (http/https/socks4/socks5; credentialed form \"http://user:pass@host\" allowed).",
7460
+ "maxLength": 255
7461
+ },
7402
7462
  "proxyType": {
7403
7463
  "type": "string",
7404
- "description": "Proxy type",
7464
+ "description": "Deprecated and ignored: the proxyUrl scheme selects the proxy protocol.",
7405
7465
  "enum": [
7406
7466
  "http",
7407
7467
  "https",
7408
7468
  "socks4",
7409
7469
  "socks5"
7410
7470
  ]
7411
- },
7412
- "proxyUrl": {
7413
- "type": "string",
7414
- "description": "Optional per-session egress proxy URL (http/https/socks4/socks5; credentialed form \"http://user:pass@host\" allowed)."
7415
7471
  }
7416
7472
  },
7417
7473
  "additionalProperties": false,
@@ -7997,10 +8053,11 @@ export const OPENWA_OPERATIONS = [
7997
8053
  },
7998
8054
  "muteUntil": {
7999
8055
  "type": [
8000
- "number",
8056
+ "integer",
8001
8057
  "null"
8002
8058
  ],
8003
- "description": "Absolute epoch-MILLISECONDS timestamp at which the mute expires, or `null` to unmute now."
8059
+ "description": "Absolute epoch-MILLISECONDS timestamp at which the mute expires, or `null` to unmute now.",
8060
+ "minimum": 1
8004
8061
  }
8005
8062
  },
8006
8063
  "additionalProperties": false,
@@ -8087,7 +8144,8 @@ export const OPENWA_OPERATIONS = [
8087
8144
  "properties": {
8088
8145
  "phoneNumber": {
8089
8146
  "type": "string",
8090
- "description": "Phone number to link, digits only in international format (country code + number)."
8147
+ "description": "Phone number to link, digits only in international format (country code + number).",
8148
+ "pattern": "^[0-9]{6,15}$"
8091
8149
  }
8092
8150
  },
8093
8151
  "additionalProperties": false,
@@ -8380,7 +8438,8 @@ export const OPENWA_OPERATIONS = [
8380
8438
  "string",
8381
8439
  "null"
8382
8440
  ],
8383
- "description": "Per-session egress proxy URL (http/https/socks4/socks5; credentialed form allowed)."
8441
+ "description": "Per-session egress proxy URL (http/https/socks4/socks5; credentialed form allowed).",
8442
+ "maxLength": 255
8384
8443
  }
8385
8444
  },
8386
8445
  "additionalProperties": false
@@ -8689,8 +8748,8 @@ export const OPENWA_OPERATIONS = [
8689
8748
  "pathParams": [],
8690
8749
  "queryParams": [],
8691
8750
  "bodyParams": [
8692
- "caption",
8693
8751
  "image",
8752
+ "caption",
8694
8753
  "recipients"
8695
8754
  ],
8696
8755
  "fileParams": [],
@@ -8699,14 +8758,13 @@ export const OPENWA_OPERATIONS = [
8699
8758
  "args": {
8700
8759
  "type": "object",
8701
8760
  "properties": {
8702
- "caption": {
8703
- "type": "string",
8704
- "description": "Optional caption.",
8705
- "maxLength": 1024
8706
- },
8707
8761
  "image": {
8708
8762
  "type": "object",
8709
8763
  "properties": {
8764
+ "url": {
8765
+ "type": "string",
8766
+ "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8767
+ },
8710
8768
  "base64": {
8711
8769
  "type": "string",
8712
8770
  "description": "Base64-encoded media."
@@ -8714,14 +8772,15 @@ export const OPENWA_OPERATIONS = [
8714
8772
  "mimetype": {
8715
8773
  "type": "string",
8716
8774
  "description": "MIME type."
8717
- },
8718
- "url": {
8719
- "type": "string",
8720
- "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8721
8775
  }
8722
8776
  },
8723
8777
  "description": "Image source (URL or base64)."
8724
8778
  },
8779
+ "caption": {
8780
+ "type": "string",
8781
+ "description": "Optional caption.",
8782
+ "maxLength": 1024
8783
+ },
8725
8784
  "recipients": {
8726
8785
  "type": "array",
8727
8786
  "description": "Recipient JIDs (0–256), @c.us or @lid.",
@@ -8758,10 +8817,10 @@ export const OPENWA_OPERATIONS = [
8758
8817
  "pathParams": [],
8759
8818
  "queryParams": [],
8760
8819
  "bodyParams": [
8820
+ "text",
8761
8821
  "backgroundColor",
8762
8822
  "font",
8763
- "recipients",
8764
- "text"
8823
+ "recipients"
8765
8824
  ],
8766
8825
  "fileParams": [],
8767
8826
  "bodyMode": "json",
@@ -8769,6 +8828,12 @@ export const OPENWA_OPERATIONS = [
8769
8828
  "args": {
8770
8829
  "type": "object",
8771
8830
  "properties": {
8831
+ "text": {
8832
+ "type": "string",
8833
+ "description": "Status text body.",
8834
+ "minLength": 1,
8835
+ "maxLength": 4096
8836
+ },
8772
8837
  "backgroundColor": {
8773
8838
  "type": "string",
8774
8839
  "description": "Background color (hex)."
@@ -8794,11 +8859,6 @@ export const OPENWA_OPERATIONS = [
8794
8859
  "items": {
8795
8860
  "type": "string"
8796
8861
  }
8797
- },
8798
- "text": {
8799
- "type": "string",
8800
- "description": "Status text body.",
8801
- "maxLength": 4096
8802
8862
  }
8803
8863
  },
8804
8864
  "additionalProperties": false,
@@ -8828,9 +8888,9 @@ export const OPENWA_OPERATIONS = [
8828
8888
  "pathParams": [],
8829
8889
  "queryParams": [],
8830
8890
  "bodyParams": [
8891
+ "video",
8831
8892
  "caption",
8832
- "recipients",
8833
- "video"
8893
+ "recipients"
8834
8894
  ],
8835
8895
  "fileParams": [],
8836
8896
  "bodyMode": "json",
@@ -8838,22 +8898,13 @@ export const OPENWA_OPERATIONS = [
8838
8898
  "args": {
8839
8899
  "type": "object",
8840
8900
  "properties": {
8841
- "caption": {
8842
- "type": "string",
8843
- "description": "Optional caption.",
8844
- "maxLength": 1024
8845
- },
8846
- "recipients": {
8847
- "type": "array",
8848
- "description": "Recipient JIDs (0–256), @c.us or @lid.",
8849
- "maxItems": 256,
8850
- "items": {
8851
- "type": "string"
8852
- }
8853
- },
8854
8901
  "video": {
8855
8902
  "type": "object",
8856
8903
  "properties": {
8904
+ "url": {
8905
+ "type": "string",
8906
+ "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8907
+ },
8857
8908
  "base64": {
8858
8909
  "type": "string",
8859
8910
  "description": "Base64-encoded media."
@@ -8861,13 +8912,22 @@ export const OPENWA_OPERATIONS = [
8861
8912
  "mimetype": {
8862
8913
  "type": "string",
8863
8914
  "description": "MIME type."
8864
- },
8865
- "url": {
8866
- "type": "string",
8867
- "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8868
8915
  }
8869
8916
  },
8870
8917
  "description": "Video source (URL or base64)."
8918
+ },
8919
+ "caption": {
8920
+ "type": "string",
8921
+ "description": "Optional caption.",
8922
+ "maxLength": 1024
8923
+ },
8924
+ "recipients": {
8925
+ "type": "array",
8926
+ "description": "Recipient JIDs (0–256), @c.us or @lid.",
8927
+ "maxItems": 256,
8928
+ "items": {
8929
+ "type": "string"
8930
+ }
8871
8931
  }
8872
8932
  },
8873
8933
  "additionalProperties": false,
@@ -8910,6 +8970,10 @@ export const OPENWA_OPERATIONS = [
8910
8970
  "audio": {
8911
8971
  "type": "object",
8912
8972
  "properties": {
8973
+ "url": {
8974
+ "type": "string",
8975
+ "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8976
+ },
8913
8977
  "base64": {
8914
8978
  "type": "string",
8915
8979
  "description": "Base64-encoded media."
@@ -8917,10 +8981,6 @@ export const OPENWA_OPERATIONS = [
8917
8981
  "mimetype": {
8918
8982
  "type": "string",
8919
8983
  "description": "MIME type."
8920
- },
8921
- "url": {
8922
- "type": "string",
8923
- "description": "Public http(s) URL of the media (server-fetched, SSRF-guarded)."
8924
8984
  }
8925
8985
  },
8926
8986
  "description": "Audio source (URL or base64)."
@@ -8965,10 +9025,10 @@ export const OPENWA_OPERATIONS = [
8965
9025
  "pathParams": [],
8966
9026
  "queryParams": [],
8967
9027
  "bodyParams": [
9028
+ "name",
8968
9029
  "body",
8969
- "footer",
8970
9030
  "header",
8971
- "name"
9031
+ "footer"
8972
9032
  ],
8973
9033
  "fileParams": [],
8974
9034
  "bodyMode": "json",
@@ -8976,25 +9036,25 @@ export const OPENWA_OPERATIONS = [
8976
9036
  "args": {
8977
9037
  "type": "object",
8978
9038
  "properties": {
9039
+ "name": {
9040
+ "type": "string",
9041
+ "description": "Unique template name within the session",
9042
+ "maxLength": 100
9043
+ },
8979
9044
  "body": {
8980
9045
  "type": "string",
8981
9046
  "description": "Template body with {{variable}} placeholders",
8982
9047
  "maxLength": 4096
8983
9048
  },
8984
- "footer": {
8985
- "type": "string",
8986
- "description": "Optional footer text, appended to the rendered body",
8987
- "maxLength": 1024
8988
- },
8989
9049
  "header": {
8990
9050
  "type": "string",
8991
9051
  "description": "Optional header text, prepended to the rendered body",
8992
9052
  "maxLength": 1024
8993
9053
  },
8994
- "name": {
9054
+ "footer": {
8995
9055
  "type": "string",
8996
- "description": "Unique template name within the session",
8997
- "maxLength": 100
9056
+ "description": "Optional footer text, appended to the rendered body",
9057
+ "maxLength": 1024
8998
9058
  }
8999
9059
  },
9000
9060
  "additionalProperties": false,
@@ -9137,10 +9197,10 @@ export const OPENWA_OPERATIONS = [
9137
9197
  ],
9138
9198
  "queryParams": [],
9139
9199
  "bodyParams": [
9200
+ "name",
9140
9201
  "body",
9141
- "footer",
9142
9202
  "header",
9143
- "name"
9203
+ "footer"
9144
9204
  ],
9145
9205
  "fileParams": [],
9146
9206
  "bodyMode": "json",
@@ -9152,25 +9212,25 @@ export const OPENWA_OPERATIONS = [
9152
9212
  "type": "string",
9153
9213
  "description": "Template ID"
9154
9214
  },
9215
+ "name": {
9216
+ "type": "string",
9217
+ "description": "Template name",
9218
+ "maxLength": 100
9219
+ },
9155
9220
  "body": {
9156
9221
  "type": "string",
9157
9222
  "description": "Template body with {{variable}} placeholders",
9158
9223
  "maxLength": 4096
9159
9224
  },
9160
- "footer": {
9161
- "type": "string",
9162
- "description": "Optional footer text",
9163
- "maxLength": 1024
9164
- },
9165
9225
  "header": {
9166
9226
  "type": "string",
9167
9227
  "description": "Optional header text",
9168
9228
  "maxLength": 1024
9169
9229
  },
9170
- "name": {
9230
+ "footer": {
9171
9231
  "type": "string",
9172
- "description": "Template name",
9173
- "maxLength": 100
9232
+ "description": "Optional footer text",
9233
+ "maxLength": 1024
9174
9234
  }
9175
9235
  },
9176
9236
  "additionalProperties": false,
@@ -9200,12 +9260,12 @@ export const OPENWA_OPERATIONS = [
9200
9260
  "pathParams": [],
9201
9261
  "queryParams": [],
9202
9262
  "bodyParams": [
9263
+ "url",
9203
9264
  "events",
9204
- "filters",
9205
- "headers",
9206
- "retryCount",
9207
9265
  "secret",
9208
- "url"
9266
+ "headers",
9267
+ "filters",
9268
+ "retryCount"
9209
9269
  ],
9210
9270
  "fileParams": [],
9211
9271
  "bodyMode": "json",
@@ -9213,6 +9273,11 @@ export const OPENWA_OPERATIONS = [
9213
9273
  "args": {
9214
9274
  "type": "object",
9215
9275
  "properties": {
9276
+ "url": {
9277
+ "type": "string",
9278
+ "description": "Webhook URL to receive events",
9279
+ "maxLength": 2048
9280
+ },
9216
9281
  "events": {
9217
9282
  "type": "array",
9218
9283
  "description": "Event types to subscribe to. '*' subscribes to all events.",
@@ -9247,6 +9312,16 @@ export const OPENWA_OPERATIONS = [
9247
9312
  ]
9248
9313
  }
9249
9314
  },
9315
+ "secret": {
9316
+ "type": "string",
9317
+ "description": "Secret key for HMAC signature verification.",
9318
+ "minLength": 16,
9319
+ "maxLength": 255
9320
+ },
9321
+ "headers": {
9322
+ "type": "object",
9323
+ "description": "Custom headers to include in webhook requests."
9324
+ },
9250
9325
  "filters": {
9251
9326
  "allOf": [
9252
9327
  {
@@ -9255,15 +9330,10 @@ export const OPENWA_OPERATIONS = [
9255
9330
  "conditions": {
9256
9331
  "type": "array",
9257
9332
  "description": "Every condition must match (AND) for the webhook to fire.",
9258
- "minItems": 1,
9259
9333
  "maxItems": 20,
9260
9334
  "items": {
9261
9335
  "type": "object",
9262
9336
  "properties": {
9263
- "caseSensitive": {
9264
- "type": "boolean",
9265
- "description": "Only meaningful for text fields."
9266
- },
9267
9337
  "field": {
9268
9338
  "type": "string",
9269
9339
  "description": "Filterable field for the fired event family."
@@ -9292,6 +9362,10 @@ export const OPENWA_OPERATIONS = [
9292
9362
  "type": "boolean"
9293
9363
  }
9294
9364
  ]
9365
+ },
9366
+ "caseSensitive": {
9367
+ "type": "boolean",
9368
+ "description": "Only meaningful for text fields."
9295
9369
  }
9296
9370
  },
9297
9371
  "required": [
@@ -9313,25 +9387,11 @@ export const OPENWA_OPERATIONS = [
9313
9387
  ],
9314
9388
  "description": "Optional smart pre-filter."
9315
9389
  },
9316
- "headers": {
9317
- "type": "object",
9318
- "description": "Custom headers to include in webhook requests."
9319
- },
9320
9390
  "retryCount": {
9321
9391
  "type": "number",
9322
9392
  "description": "Total delivery attempts per event, including the first (0 and 1 both mean a single attempt with no retry).",
9323
9393
  "minimum": 0,
9324
9394
  "maximum": 5
9325
- },
9326
- "secret": {
9327
- "type": "string",
9328
- "description": "Secret key for HMAC signature verification.",
9329
- "minLength": 16,
9330
- "maxLength": 255
9331
- },
9332
- "url": {
9333
- "type": "string",
9334
- "description": "Webhook URL to receive events"
9335
9395
  }
9336
9396
  },
9337
9397
  "additionalProperties": false,
@@ -9513,13 +9573,13 @@ export const OPENWA_OPERATIONS = [
9513
9573
  ],
9514
9574
  "queryParams": [],
9515
9575
  "bodyParams": [
9516
- "active",
9576
+ "url",
9517
9577
  "events",
9518
- "filters",
9519
- "headers",
9520
- "retryCount",
9521
9578
  "secret",
9522
- "url"
9579
+ "headers",
9580
+ "filters",
9581
+ "active",
9582
+ "retryCount"
9523
9583
  ],
9524
9584
  "fileParams": [],
9525
9585
  "bodyMode": "json",
@@ -9531,9 +9591,10 @@ export const OPENWA_OPERATIONS = [
9531
9591
  "type": "string",
9532
9592
  "description": "Webhook ID"
9533
9593
  },
9534
- "active": {
9535
- "type": "boolean",
9536
- "description": "Enable/disable webhook"
9594
+ "url": {
9595
+ "type": "string",
9596
+ "description": "Webhook URL",
9597
+ "maxLength": 2048
9537
9598
  },
9538
9599
  "events": {
9539
9600
  "type": "array",
@@ -9569,6 +9630,15 @@ export const OPENWA_OPERATIONS = [
9569
9630
  ]
9570
9631
  }
9571
9632
  },
9633
+ "secret": {
9634
+ "type": "string",
9635
+ "description": "Secret key for HMAC signature.",
9636
+ "maxLength": 255
9637
+ },
9638
+ "headers": {
9639
+ "type": "object",
9640
+ "description": "Custom headers."
9641
+ },
9572
9642
  "filters": {
9573
9643
  "allOf": [
9574
9644
  {
@@ -9577,15 +9647,10 @@ export const OPENWA_OPERATIONS = [
9577
9647
  "conditions": {
9578
9648
  "type": "array",
9579
9649
  "description": "Every condition must match (AND) for the webhook to fire.",
9580
- "minItems": 1,
9581
9650
  "maxItems": 20,
9582
9651
  "items": {
9583
9652
  "type": "object",
9584
9653
  "properties": {
9585
- "caseSensitive": {
9586
- "type": "boolean",
9587
- "description": "Only meaningful for text fields."
9588
- },
9589
9654
  "field": {
9590
9655
  "type": "string",
9591
9656
  "description": "Filterable field for the fired event family."
@@ -9614,6 +9679,10 @@ export const OPENWA_OPERATIONS = [
9614
9679
  "type": "boolean"
9615
9680
  }
9616
9681
  ]
9682
+ },
9683
+ "caseSensitive": {
9684
+ "type": "boolean",
9685
+ "description": "Only meaningful for text fields."
9617
9686
  }
9618
9687
  },
9619
9688
  "required": [
@@ -9635,24 +9704,15 @@ export const OPENWA_OPERATIONS = [
9635
9704
  ],
9636
9705
  "description": "Optional smart pre-filter."
9637
9706
  },
9638
- "headers": {
9639
- "type": "object",
9640
- "description": "Custom headers."
9707
+ "active": {
9708
+ "type": "boolean",
9709
+ "description": "Enable/disable webhook"
9641
9710
  },
9642
9711
  "retryCount": {
9643
9712
  "type": "number",
9644
9713
  "description": "Total delivery attempts per event, including the first (0 and 1 both mean a single attempt).",
9645
9714
  "minimum": 0,
9646
9715
  "maximum": 5
9647
- },
9648
- "secret": {
9649
- "type": "string",
9650
- "description": "Secret key for HMAC signature.",
9651
- "maxLength": 255
9652
- },
9653
- "url": {
9654
- "type": "string",
9655
- "description": "Webhook URL"
9656
9716
  }
9657
9717
  },
9658
9718
  "additionalProperties": false,
@@ -9666,7 +9726,7 @@ export const OPENWA_OPERATIONS = [
9666
9726
  "method": "GET",
9667
9727
  "path": "/api/webhooks/delivery-failures",
9668
9728
  "tag": "webhooks",
9669
- "summary": "List recently-failed webhook deliveries (all retries exhausted)",
9729
+ "summary": "List failed or unsent webhook deliveries, most recent first",
9670
9730
  "category": "gateway_admin",
9671
9731
  "requiredRole": "admin",
9672
9732
  "requiresUnscopedKey": false,