@wildix/xbees-conversations-client 1.0.47 → 1.0.49

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 (55) hide show
  1. package/dist-cjs/Conversations.js +0 -2
  2. package/dist-cjs/commands/index.js +0 -1
  3. package/dist-cjs/models/models_0.js +27 -23
  4. package/dist-cjs/protocols/Aws_restJson1.js +31 -42
  5. package/dist-es/Conversations.js +0 -2
  6. package/dist-es/commands/index.js +0 -1
  7. package/dist-es/models/models_0.js +25 -22
  8. package/dist-es/protocols/Aws_restJson1.js +31 -40
  9. package/dist-types/Conversations.d.ts +0 -7
  10. package/dist-types/ConversationsClient.d.ts +2 -3
  11. package/dist-types/commands/AddChannelMemberCommand.d.ts +6 -3
  12. package/dist-types/commands/AddChannelMembersCommand.d.ts +6 -3
  13. package/dist-types/commands/CreateGroupChannelCommand.d.ts +8 -3
  14. package/dist-types/commands/DeleteChannelCommand.d.ts +6 -5
  15. package/dist-types/commands/DeleteChannelMemberCommand.d.ts +6 -3
  16. package/dist-types/commands/DeleteMessageCommand.d.ts +6 -3
  17. package/dist-types/commands/DeleteMessageReactionCommand.d.ts +6 -3
  18. package/dist-types/commands/DescribeEventCommand.d.ts +24 -1
  19. package/dist-types/commands/GetChannelCommand.d.ts +8 -3
  20. package/dist-types/commands/GetChannelMemberCommand.d.ts +6 -3
  21. package/dist-types/commands/GetDirectChannelIdCommand.d.ts +6 -3
  22. package/dist-types/commands/GetFilePresignedDownloadUrlCommand.d.ts +5 -2
  23. package/dist-types/commands/GetMessageCommand.d.ts +8 -3
  24. package/dist-types/commands/GetOrCreateDirectChannelCommand.d.ts +8 -3
  25. package/dist-types/commands/GetUploadedFileInfoCommand.d.ts +5 -2
  26. package/dist-types/commands/HideChannelCommand.d.ts +6 -3
  27. package/dist-types/commands/InviteCommand.d.ts +6 -3
  28. package/dist-types/commands/JoinChannelCommand.d.ts +8 -3
  29. package/dist-types/commands/LeaveChannelCommand.d.ts +6 -3
  30. package/dist-types/commands/ListChannelMembersCommand.d.ts +6 -3
  31. package/dist-types/commands/ListChannelsCommand.d.ts +8 -3
  32. package/dist-types/commands/ListMessageReactionsCommand.d.ts +6 -3
  33. package/dist-types/commands/ListMessagesCommand.d.ts +8 -3
  34. package/dist-types/commands/MarkReadCommand.d.ts +6 -3
  35. package/dist-types/commands/PartialUpdateChannelCommand.d.ts +8 -3
  36. package/dist-types/commands/PartialUpdateMessageCommand.d.ts +8 -3
  37. package/dist-types/commands/ScheduleExternalFlagAdjustmentJobCommand.d.ts +5 -2
  38. package/dist-types/commands/SendGiphyCommand.d.ts +8 -3
  39. package/dist-types/commands/SendMessageCommand.d.ts +8 -3
  40. package/dist-types/commands/SendMessageReactionCommand.d.ts +6 -3
  41. package/dist-types/commands/SendTypingStartCommand.d.ts +6 -3
  42. package/dist-types/commands/SendTypingStopCommand.d.ts +6 -3
  43. package/dist-types/commands/ShowChannelCommand.d.ts +6 -3
  44. package/dist-types/commands/UpdateChannelCommand.d.ts +8 -3
  45. package/dist-types/commands/UpdateMessageCommand.d.ts +8 -3
  46. package/dist-types/commands/UploadFileCommand.d.ts +5 -2
  47. package/dist-types/commands/index.d.ts +0 -1
  48. package/dist-types/index.d.ts +2 -2
  49. package/dist-types/models/ConversationsServiceException.d.ts +2 -1
  50. package/dist-types/models/models_0.d.ts +478 -170
  51. package/dist-types/protocols/Aws_restJson1.d.ts +0 -9
  52. package/package.json +9 -9
  53. package/dist-cjs/commands/AssignChannelCommand.js +0 -21
  54. package/dist-es/commands/AssignChannelCommand.js +0 -17
  55. package/dist-types/commands/AssignChannelCommand.d.ts +0 -101
@@ -22,6 +22,37 @@ export declare class ForbiddenException extends __BaseException {
22
22
  */
23
23
  constructor(opts: __ExceptionOptionType<ForbiddenException, __BaseException>);
24
24
  }
25
+ /**
26
+ * @public
27
+ */
28
+ export declare class LimitExceededException extends __BaseException {
29
+ readonly name: "LimitExceededException";
30
+ readonly $fault: "client";
31
+ /**
32
+ * Displays the applicable rate limits for the current request.
33
+ * @public
34
+ */
35
+ rateLimit?: string;
36
+ /**
37
+ * Indicates how many requests a user can still make within the current time window.
38
+ * @public
39
+ */
40
+ rateLimitRemaining?: number;
41
+ /**
42
+ * Shows the time in seconds until the rate limit resets.
43
+ * @public
44
+ */
45
+ rateLimitReset?: number;
46
+ /**
47
+ * Displays how many seconds the user agent should wait before making a follow-up request.
48
+ * @public
49
+ */
50
+ retryAfter?: number;
51
+ /**
52
+ * @internal
53
+ */
54
+ constructor(opts: __ExceptionOptionType<LimitExceededException, __BaseException>);
55
+ }
25
56
  /**
26
57
  * @public
27
58
  */
@@ -68,9 +99,13 @@ export interface UserToInvite {
68
99
  * @public
69
100
  */
70
101
  export interface AddChannelMemberInput {
102
+ /**
103
+ * The unique identifier of the channel to which the member is to be added.
104
+ * @public
105
+ */
71
106
  channelId: string;
72
107
  /**
73
- * User ID for server side calls
108
+ * The unique identifier of the user when a service token is used.
74
109
  * @public
75
110
  */
76
111
  userId?: string;
@@ -79,7 +114,15 @@ export interface AddChannelMemberInput {
79
114
  * @public
80
115
  */
81
116
  silent?: boolean;
117
+ /**
118
+ * A User ID of the member to be added to the channel.
119
+ * @public
120
+ */
82
121
  memberId?: string;
122
+ /**
123
+ * A user to invite to the channel, identified by email address or phone number if the member does not already exist.
124
+ * @public
125
+ */
83
126
  memberToInvite?: UserToInvite;
84
127
  }
85
128
  /**
@@ -107,12 +150,12 @@ export interface ChannelMember {
107
150
  */
108
151
  export interface AddChannelMemberOutput {
109
152
  /**
110
- * Member added to the channel
153
+ * Details of the member added to the channel.
111
154
  * @public
112
155
  */
113
156
  member: ChannelMember;
114
157
  /**
115
- * Users added to the channel
158
+ * Details of the user added to the channel.
116
159
  * @public
117
160
  */
118
161
  user: User;
@@ -143,166 +186,46 @@ export declare class MemberAlreadyExistException extends __BaseException {
143
186
  * @public
144
187
  */
145
188
  export interface AddChannelMembersInput {
146
- channelId: string;
147
- /**
148
- * User ID for server side calls
149
- * @public
150
- */
151
- userId?: string;
152
- /**
153
- * True to not send a system message that members added from the conversartion. Default - false.
154
- * @public
155
- */
156
- silent?: boolean;
157
- members?: (string)[];
158
- membersToInvite?: (UserToInvite)[];
159
- }
160
- /**
161
- * @public
162
- */
163
- export interface AddChannelMembersOutput {
164
189
  /**
165
- * The list of members added to the channel
190
+ * The unique identifier of the channel to which members are to be added.
166
191
  * @public
167
192
  */
168
- members: (ChannelMember)[];
169
- /**
170
- * The list of users added to the channel
171
- * @public
172
- */
173
- users: (User)[];
174
- }
175
- /**
176
- * @public
177
- */
178
- export type AssignChannelAssigneeRequest = AssignChannelAssigneeRequest.EmailMember | AssignChannelAssigneeRequest.IdMember | AssignChannelAssigneeRequest.$UnknownMember;
179
- /**
180
- * @public
181
- */
182
- export declare namespace AssignChannelAssigneeRequest {
183
- interface IdMember {
184
- id: string;
185
- email?: never;
186
- $unknown?: never;
187
- }
188
- interface EmailMember {
189
- id?: never;
190
- email: string;
191
- $unknown?: never;
192
- }
193
- /**
194
- * @public
195
- */
196
- interface $UnknownMember {
197
- id?: never;
198
- email?: never;
199
- $unknown: [string, any];
200
- }
201
- interface Visitor<T> {
202
- id: (value: string) => T;
203
- email: (value: string) => T;
204
- _: (name: string, value: any) => T;
205
- }
206
- const visit: <T>(value: AssignChannelAssigneeRequest, visitor: Visitor<T>) => T;
207
- }
208
- /**
209
- * @public
210
- */
211
- export interface AssignChannelOptions {
212
- /**
213
- * True to add all members that are in service to the conversation. Default - false.
214
- * @public
215
- */
216
- addAgentFromService?: boolean;
217
- }
218
- /**
219
- * @public
220
- */
221
- export type AssignChannelServiceRequest = AssignChannelServiceRequest.IdMember | AssignChannelServiceRequest.NameMember | AssignChannelServiceRequest.UriMember | AssignChannelServiceRequest.$UnknownMember;
222
- /**
223
- * @public
224
- */
225
- export declare namespace AssignChannelServiceRequest {
226
- interface UriMember {
227
- uri: string;
228
- id?: never;
229
- name?: never;
230
- $unknown?: never;
231
- }
232
- interface IdMember {
233
- uri?: never;
234
- id: string;
235
- name?: never;
236
- $unknown?: never;
237
- }
238
- interface NameMember {
239
- uri?: never;
240
- id?: never;
241
- name: string;
242
- $unknown?: never;
243
- }
193
+ channelId: string;
244
194
  /**
195
+ * The unique identifier of the user when a service token is used.
245
196
  * @public
246
197
  */
247
- interface $UnknownMember {
248
- uri?: never;
249
- id?: never;
250
- name?: never;
251
- $unknown: [string, any];
252
- }
253
- interface Visitor<T> {
254
- uri: (value: string) => T;
255
- id: (value: string) => T;
256
- name: (value: string) => T;
257
- _: (name: string, value: any) => T;
258
- }
259
- const visit: <T>(value: AssignChannelServiceRequest, visitor: Visitor<T>) => T;
260
- }
261
- /**
262
- * @public
263
- */
264
- export interface AssignChannelInput {
265
- channelId: string;
266
198
  userId?: string;
267
199
  /**
268
- * True to not send a system message that channel was assigned to specific service or user. Default - false.
200
+ * Set to true to suppress system messages that members were added to the conversation. Default is false.
269
201
  * @public
270
202
  */
271
203
  silent?: boolean;
272
204
  /**
273
- * Service information to assign to. If service is not empty than `addAgentFromService` option could be used.
205
+ * A list of user IDs to be added as members of the channel.
274
206
  * @public
275
207
  */
276
- service?: AssignChannelServiceRequest;
208
+ members?: (string)[];
277
209
  /**
278
- * A user that should be assigned to the channel. If service was specified than this field can be optional.
210
+ * A list of users to invite to the channel, identified by their email addresses or phone numbers.
279
211
  * @public
280
212
  */
281
- assignee?: AssignChannelAssigneeRequest;
282
- options?: AssignChannelOptions;
283
- }
284
- /**
285
- * @public
286
- */
287
- export interface AssignService {
288
- uri: string;
289
- id: string;
290
- name: string;
213
+ membersToInvite?: (UserToInvite)[];
291
214
  }
292
215
  /**
293
216
  * @public
294
217
  */
295
- export interface AssignChannelOutput {
218
+ export interface AddChannelMembersOutput {
296
219
  /**
297
- * A user that assigned to the channel if specified in the request, otherwise previously assigned user or undefined.
220
+ * The list of members added to the channel.
298
221
  * @public
299
222
  */
300
- assignee?: User;
223
+ members: (ChannelMember)[];
301
224
  /**
302
- * A service that assigned to the channel if specified in the request, otherwise previously assigned service or undefined.
225
+ * The list of users added to the channel.
303
226
  * @public
304
227
  */
305
- service?: AssignService;
228
+ users: (User)[];
306
229
  }
307
230
  /**
308
231
  * @public
@@ -368,6 +291,17 @@ export interface ChannelContext {
368
291
  target?: string;
369
292
  events?: (ChannelContextEvent)[];
370
293
  }
294
+ /**
295
+ * @public
296
+ * @enum
297
+ */
298
+ export declare const ChannelWhatsAppStatus: {
299
+ readonly CHANNEL_CLOSED: "24h_channel_closed";
300
+ };
301
+ /**
302
+ * @public
303
+ */
304
+ export type ChannelWhatsAppStatus = typeof ChannelWhatsAppStatus[keyof typeof ChannelWhatsAppStatus];
371
305
  /**
372
306
  * @public
373
307
  */
@@ -400,6 +334,8 @@ export interface Channel {
400
334
  telephony?: boolean;
401
335
  sms?: boolean;
402
336
  mms?: boolean;
337
+ whatsapp?: boolean;
338
+ whatsappStatus?: ChannelWhatsAppStatus;
403
339
  broadcast?: boolean;
404
340
  external?: boolean;
405
341
  channelId: string;
@@ -436,23 +372,55 @@ export type ConversationFileCategory = typeof ConversationFileCategory[keyof typ
436
372
  * @public
437
373
  */
438
374
  export interface CreateGroupChannelInput {
375
+ /**
376
+ * The subject of the channel.
377
+ * @public
378
+ */
439
379
  subject?: string;
380
+ /**
381
+ * The description of the channel.
382
+ * @public
383
+ */
440
384
  description?: string;
441
385
  /**
442
- * Picture URL
386
+ * The URL of the channel's picture.
443
387
  * @public
444
388
  */
445
389
  picture?: string;
446
390
  /**
447
- * Picture dominant color represented by a hex value.
391
+ * The dominant color of the channel's picture, represented by a hex value.
448
392
  * @public
449
393
  */
450
394
  pictureColor?: string;
395
+ /**
396
+ * The access level of the channel.
397
+ * @public
398
+ */
451
399
  access?: ChannelAccess;
400
+ /**
401
+ * Indicates if the channel is broadcast-only. Default is false.
402
+ * @public
403
+ */
452
404
  broadcast?: boolean;
405
+ /**
406
+ * The unique identifier of the user when a service token is used.
407
+ * @public
408
+ */
453
409
  userId?: string;
410
+ /**
411
+ * The unique identifier for the new group channel. If not provided, the system will generate one.
412
+ * @public
413
+ */
454
414
  channelId?: string;
415
+ /**
416
+ * A list of user IDs to be added as members of the group channel.
417
+ * @public
418
+ */
455
419
  members?: (string)[];
420
+ /**
421
+ * A list of users to invite to the group channel, identified by their email addresses or phone numbers.
422
+ * @public
423
+ */
456
424
  membersToInvite?: (UserToInvite)[];
457
425
  }
458
426
  /**
@@ -465,6 +433,10 @@ export interface CreateGroupChannelOutput {
465
433
  * @public
466
434
  */
467
435
  export interface DeleteChannelInput {
436
+ /**
437
+ * The unique identifier of the channel to be deleted.
438
+ * @public
439
+ */
468
440
  channelId: string;
469
441
  }
470
442
  /**
@@ -476,15 +448,23 @@ export interface DeleteChannelOutput {
476
448
  * @public
477
449
  */
478
450
  export interface DeleteChannelMemberInput {
451
+ /**
452
+ * The unique identifier of the channel from which the member is to be deleted.
453
+ * @public
454
+ */
479
455
  channelId: string;
480
456
  /**
481
- * User ID for server side calls
457
+ * The unique identifier of the user when a service token is used.
482
458
  * @public
483
459
  */
484
460
  userId?: string;
461
+ /**
462
+ * The unique identifier of the member to be deleted.
463
+ * @public
464
+ */
485
465
  memberId: string;
486
466
  /**
487
- * True to not send a system message that member was removed from the conversartion. Default - false.
467
+ * Set to true to suppress system messages that the member was removed from the conversation. Default is false.
488
468
  * @public
489
469
  */
490
470
  silent?: boolean;
@@ -509,10 +489,18 @@ export declare class MemberNotFoundException extends __BaseException {
509
489
  * @public
510
490
  */
511
491
  export interface DeleteMessageInput {
492
+ /**
493
+ * The unique identifier of the channel containing the message.
494
+ * @public
495
+ */
512
496
  channelId: string;
497
+ /**
498
+ * The unique identifier of the message to delete.
499
+ * @public
500
+ */
513
501
  messageId: string;
514
502
  /**
515
- * User ID for server side calls
503
+ * The unique identifier of the user when a service token is used.
516
504
  * @public
517
505
  */
518
506
  userId?: string;
@@ -556,19 +544,23 @@ export type ReactionType = typeof ReactionType[keyof typeof ReactionType];
556
544
  * @public
557
545
  */
558
546
  export interface DeleteMessageReactionInput {
547
+ /**
548
+ * The unique identifier of the channel containing the message.
549
+ * @public
550
+ */
559
551
  channelId: string;
560
552
  /**
561
- * ID of the message to react to.
553
+ * The unique identifier of the message to delete the reaction from.
562
554
  * @public
563
555
  */
564
556
  messageId: string;
565
557
  /**
566
- * Type of the reaction.
558
+ * The type of the reaction to delete.
567
559
  * @public
568
560
  */
569
561
  reactionType: ReactionType;
570
562
  /**
571
- * User ID for server side calls
563
+ * The unique identifier of the user when a service token is used.
572
564
  * @public
573
565
  */
574
566
  userId?: string;
@@ -752,6 +744,20 @@ export declare const MessageType: {
752
744
  * @public
753
745
  */
754
746
  export type MessageType = typeof MessageType[keyof typeof MessageType];
747
+ /**
748
+ * @public
749
+ * @enum
750
+ */
751
+ export declare const MessageWhatsAppStatus: {
752
+ readonly DELIVERED: "delivered";
753
+ readonly ERROR: "error";
754
+ readonly SENT: "sent";
755
+ readonly TRYING: "trying";
756
+ };
757
+ /**
758
+ * @public
759
+ */
760
+ export type MessageWhatsAppStatus = typeof MessageWhatsAppStatus[keyof typeof MessageWhatsAppStatus];
755
761
  /**
756
762
  * @public
757
763
  */
@@ -766,6 +772,8 @@ export interface Message {
766
772
  event?: string;
767
773
  sms?: boolean;
768
774
  smsStatus?: MessageSmsStatus;
775
+ whatsapp?: boolean;
776
+ whatsappStatus?: MessageWhatsAppStatus;
769
777
  messageId: string;
770
778
  channelId: string;
771
779
  user: User;
@@ -878,6 +886,10 @@ export interface DescribeEventOutput {
878
886
  * @public
879
887
  */
880
888
  export interface GetChannelInput {
889
+ /**
890
+ * The unique identifier of the channel.
891
+ * @public
892
+ */
881
893
  channelId: string;
882
894
  }
883
895
  /**
@@ -890,22 +902,50 @@ export interface GetChannelOutput {
890
902
  * @public
891
903
  */
892
904
  export interface GetChannelMemberInput {
905
+ /**
906
+ * The unique identifier of the channel.
907
+ * @public
908
+ */
893
909
  channelId: string;
910
+ /**
911
+ * The unique identifier of the user.
912
+ * @public
913
+ */
894
914
  memberId: string;
895
915
  }
896
916
  /**
897
917
  * @public
898
918
  */
899
919
  export interface GetChannelMemberOutput {
920
+ /**
921
+ * Details of the channel member.
922
+ * @public
923
+ */
900
924
  member: ChannelMember;
925
+ /**
926
+ * Details of the user.
927
+ * @public
928
+ */
901
929
  user: User;
902
930
  }
903
931
  /**
904
932
  * @public
905
933
  */
906
934
  export interface GetDirectChannelIdInput {
935
+ /**
936
+ * The unique identifier of the user when a service token is used.
937
+ * @public
938
+ */
907
939
  userId?: string;
940
+ /**
941
+ * A User ID of the member to connect with the direct channel.
942
+ * @public
943
+ */
908
944
  memberId?: string;
945
+ /**
946
+ * A user to invite to the direct channel, identified by email addresse or phone number.
947
+ * @public
948
+ */
909
949
  memberToInvite?: UserToInvite;
910
950
  }
911
951
  /**
@@ -930,18 +970,22 @@ export declare class FileNotFoundException extends __BaseException {
930
970
  */
931
971
  export interface GetFilePresignedDownloadUrlInput {
932
972
  /**
933
- * Channel Id.
973
+ * The unique identifier of the channel containing the message.
934
974
  * @public
935
975
  */
936
976
  channelId: string;
937
977
  /**
938
- * Message Id.
978
+ * The unique identifier of the message containing the file.
939
979
  * @public
940
980
  */
941
981
  messageId: string;
982
+ /**
983
+ * The unique identifier of the file to download.
984
+ * @public
985
+ */
942
986
  fileId: string;
943
987
  /**
944
- * File category. Channel files or conference recordings. Default: channels.
988
+ * The category of the file, either channel files or conference recordings.
945
989
  * @public
946
990
  */
947
991
  category?: ConversationFileCategory;
@@ -951,7 +995,7 @@ export interface GetFilePresignedDownloadUrlInput {
951
995
  */
952
996
  export interface GetFilePresignedDownloadUrlOutput {
953
997
  /**
954
- * Presigned URL for download file.
998
+ * The presigned URL for downloading the file.
955
999
  * @public
956
1000
  */
957
1001
  presignedDownloadUrl: string;
@@ -960,7 +1004,15 @@ export interface GetFilePresignedDownloadUrlOutput {
960
1004
  * @public
961
1005
  */
962
1006
  export interface GetMessageInput {
1007
+ /**
1008
+ * The unique identifier of the channel containing the message.
1009
+ * @public
1010
+ */
963
1011
  channelId: string;
1012
+ /**
1013
+ * The unique identifier of the message to retrieve.
1014
+ * @public
1015
+ */
964
1016
  messageId: string;
965
1017
  }
966
1018
  /**
@@ -973,8 +1025,20 @@ export interface GetMessageOutput {
973
1025
  * @public
974
1026
  */
975
1027
  export interface GetOrCreateDirectChannelInput {
1028
+ /**
1029
+ * The unique identifier of the user when a service token is used.
1030
+ * @public
1031
+ */
976
1032
  userId?: string;
1033
+ /**
1034
+ * A User ID of the member to connect with the direct channel.
1035
+ * @public
1036
+ */
977
1037
  memberId?: string;
1038
+ /**
1039
+ * A user to invite to the direct channel, identified by email addresse or phone number.
1040
+ * @public
1041
+ */
978
1042
  memberToInvite?: UserToInvite;
979
1043
  }
980
1044
  /**
@@ -988,17 +1052,17 @@ export interface GetOrCreateDirectChannelOutput {
988
1052
  */
989
1053
  export interface GetUploadedFileInfoInput {
990
1054
  /**
991
- * Channel Id.
1055
+ * The unique identifier of the channel containing the file.
992
1056
  * @public
993
1057
  */
994
1058
  channelId: string;
995
1059
  /**
996
- * File Id. Support cds file's ID.
1060
+ * The unique identifier of the file.
997
1061
  * @public
998
1062
  */
999
1063
  fileId: string;
1000
1064
  /**
1001
- * File category. Channel files or conference recordings. Default: channels.
1065
+ * The category of the file, either channel files or conference recordings. Default: channels.
1002
1066
  * @public
1003
1067
  */
1004
1068
  category?: ConversationFileCategory;
@@ -1013,7 +1077,15 @@ export interface GetUploadedFileInfoOutput {
1013
1077
  * @public
1014
1078
  */
1015
1079
  export interface HideChannelInput {
1080
+ /**
1081
+ * The unique identifier of the channel to hide.
1082
+ * @public
1083
+ */
1016
1084
  channelId: string;
1085
+ /**
1086
+ * The unique identifier of the user when a service token is used.
1087
+ * @public
1088
+ */
1017
1089
  userId?: string;
1018
1090
  }
1019
1091
  /**
@@ -1025,20 +1097,40 @@ export interface HideChannelOutput {
1025
1097
  * @public
1026
1098
  */
1027
1099
  export interface InviteInput {
1100
+ /**
1101
+ * A list of users to invite. The list must contain between 1 and 20 users.
1102
+ * @public
1103
+ */
1028
1104
  invitees: (UserToInvite)[];
1029
1105
  }
1030
1106
  /**
1031
1107
  * @public
1032
1108
  */
1033
1109
  export interface InviteOutput {
1110
+ /**
1111
+ * A list of users who were successfully invited.
1112
+ * @public
1113
+ */
1034
1114
  users: (User)[];
1035
1115
  }
1036
1116
  /**
1037
1117
  * @public
1038
1118
  */
1039
1119
  export interface JoinChannelInput {
1120
+ /**
1121
+ * The unique identifier of the channel to join.
1122
+ * @public
1123
+ */
1040
1124
  channelId: string;
1125
+ /**
1126
+ * The unique identifier of the user when a service token is used.
1127
+ * @public
1128
+ */
1041
1129
  userId?: string;
1130
+ /**
1131
+ * Set to true to suppress system messages that the user joined the channel. Default is false.
1132
+ * @public
1133
+ */
1042
1134
  silent?: boolean;
1043
1135
  }
1044
1136
  /**
@@ -1051,8 +1143,20 @@ export interface JoinChannelOutput {
1051
1143
  * @public
1052
1144
  */
1053
1145
  export interface LeaveChannelInput {
1146
+ /**
1147
+ * The unique identifier of the channel to leave.
1148
+ * @public
1149
+ */
1054
1150
  channelId: string;
1151
+ /**
1152
+ * The unique identifier of the user when a service token is used.
1153
+ * @public
1154
+ */
1055
1155
  userId?: string;
1156
+ /**
1157
+ * Set to true to suppress system messages that the user left the channel. Default is false.
1158
+ * @public
1159
+ */
1056
1160
  silent?: boolean;
1057
1161
  }
1058
1162
  /**
@@ -1064,8 +1168,20 @@ export interface LeaveChannelOutput {
1064
1168
  * @public
1065
1169
  */
1066
1170
  export interface ListChannelMembersInput {
1171
+ /**
1172
+ * The unique identifier of the channel whose members are to be listed.
1173
+ * @public
1174
+ */
1067
1175
  channelId: string;
1176
+ /**
1177
+ * The maximum number of members to return. The value must be between 1 and 100.
1178
+ * @public
1179
+ */
1068
1180
  limit?: number;
1181
+ /**
1182
+ * The offset from which to start listing members. The value must be between 0 and 1000.
1183
+ * @public
1184
+ */
1069
1185
  offset?: number;
1070
1186
  }
1071
1187
  /**
@@ -1073,7 +1189,7 @@ export interface ListChannelMembersInput {
1073
1189
  */
1074
1190
  export interface ListChannelMembersOutput {
1075
1191
  /**
1076
- * The list of members matching the query
1192
+ * The list of members matching the query.
1077
1193
  * @public
1078
1194
  */
1079
1195
  members: (ChannelMember)[];
@@ -1087,50 +1203,110 @@ export interface ListChannelMembersOutput {
1087
1203
  * @public
1088
1204
  */
1089
1205
  export interface ListChannelsInput {
1206
+ /**
1207
+ * The unique identifier of the user when a service token is used.
1208
+ * @public
1209
+ */
1090
1210
  userId?: string;
1211
+ /**
1212
+ * The maximum number of channels to return. The value must be between 1 and 50.
1213
+ * @public
1214
+ */
1091
1215
  limit?: number;
1216
+ /**
1217
+ * The offset from which to start listing channels. The value must be between 0 and 1000.
1218
+ * @public
1219
+ */
1092
1220
  offset?: number;
1093
1221
  }
1094
1222
  /**
1095
1223
  * @public
1096
1224
  */
1097
1225
  export interface ListChannelsOutput {
1226
+ /**
1227
+ * A list of channels associated with the user.
1228
+ * @public
1229
+ */
1098
1230
  channels: (Channel)[];
1099
1231
  }
1100
1232
  /**
1101
1233
  * @public
1102
1234
  */
1103
1235
  export interface ListMessageReactionsInput {
1236
+ /**
1237
+ * The unique identifier of the channel containing the message.
1238
+ * @public
1239
+ */
1104
1240
  channelId: string;
1241
+ /**
1242
+ * The unique identifier of the message whose reactions are to be listed.
1243
+ * @public
1244
+ */
1105
1245
  messageId: string;
1246
+ /**
1247
+ * The maximum number of reactions to return. The value must be between 1 and 300.
1248
+ * @public
1249
+ */
1106
1250
  limit?: number;
1251
+ /**
1252
+ * The offset from which to start listing reactions. The value must be between 0 and 1000.
1253
+ * @public
1254
+ */
1107
1255
  offset?: number;
1108
1256
  }
1109
1257
  /**
1110
1258
  * @public
1111
1259
  */
1112
1260
  export interface ListMessageReactionsOutput {
1261
+ /**
1262
+ * A list of reactions to the specified message.
1263
+ * @public
1264
+ */
1113
1265
  reactions: (Reaction)[];
1114
1266
  }
1115
1267
  /**
1116
1268
  * @public
1117
1269
  */
1118
1270
  export interface ListMessagesInput {
1271
+ /**
1272
+ * The unique identifier of the channel from which to list messages.
1273
+ * @public
1274
+ */
1119
1275
  channelId: string;
1276
+ /**
1277
+ * The maximum number of messages to return. The value must be between 1 and 100.
1278
+ * @public
1279
+ */
1120
1280
  limit?: number;
1281
+ /**
1282
+ * The offset from which to start listing messages. The value must be between 0 and 1000.
1283
+ * @public
1284
+ */
1121
1285
  offset?: number;
1122
1286
  }
1123
1287
  /**
1124
1288
  * @public
1125
1289
  */
1126
1290
  export interface ListMessagesOutput {
1291
+ /**
1292
+ * A list of messages from the specified channel.
1293
+ * @public
1294
+ */
1127
1295
  messages: (Message)[];
1128
1296
  }
1129
1297
  /**
1130
1298
  * @public
1131
1299
  */
1132
1300
  export interface MarkReadInput {
1301
+ /**
1302
+ * The unique identifier of the channel whose messages are to be marked as read.
1303
+ * @public
1304
+ */
1133
1305
  channelId: string;
1306
+ /**
1307
+ * The unique identifier of the user when a service token is used.
1308
+ * @public
1309
+ */
1134
1310
  userId?: string;
1135
1311
  }
1136
1312
  /**
@@ -1142,19 +1318,35 @@ export interface MarkReadOutput {
1142
1318
  * @public
1143
1319
  */
1144
1320
  export interface PartialUpdateChannelSetOptions {
1321
+ /**
1322
+ * The subject of the channel.
1323
+ * @public
1324
+ */
1145
1325
  subject?: string;
1326
+ /**
1327
+ * The description of the channel.
1328
+ * @public
1329
+ */
1146
1330
  description?: string;
1147
1331
  /**
1148
- * Picture URL
1332
+ * The URL of the channel's picture.
1149
1333
  * @public
1150
1334
  */
1151
1335
  picture?: string;
1152
1336
  /**
1153
- * Picture dominant color represented by a hex value.
1337
+ * The dominant color of the channel's picture, represented by a hex value.
1154
1338
  * @public
1155
1339
  */
1156
1340
  pictureColor?: string;
1341
+ /**
1342
+ * The access level of the channel.
1343
+ * @public
1344
+ */
1157
1345
  access?: ChannelAccess;
1346
+ /**
1347
+ * Indicates if the channel is broadcast-only. Default is false.
1348
+ * @public
1349
+ */
1158
1350
  broadcast?: boolean;
1159
1351
  }
1160
1352
  /**
@@ -1177,14 +1369,30 @@ export type GroupChannelUnsetOptions = typeof GroupChannelUnsetOptions[keyof typ
1177
1369
  * @public
1178
1370
  */
1179
1371
  export interface PartialUpdateChannelInput {
1372
+ /**
1373
+ * The unique identifier of the channel to be updated.
1374
+ * @public
1375
+ */
1180
1376
  channelId: string;
1377
+ /**
1378
+ * The unique identifier of the user when a service token is used.
1379
+ * @public
1380
+ */
1181
1381
  userId?: string;
1182
1382
  /**
1183
- * True to not send a system message about updates. Default - false.
1383
+ * Set to true to suppress system messages about the updates. Default is false.
1184
1384
  * @public
1185
1385
  */
1186
1386
  silent?: boolean;
1387
+ /**
1388
+ * Options to set specific fields in the channel.
1389
+ * @public
1390
+ */
1187
1391
  set?: PartialUpdateChannelSetOptions;
1392
+ /**
1393
+ * Options to unset specific fields in the channel.
1394
+ * @public
1395
+ */
1188
1396
  unset?: (GroupChannelUnsetOptions)[];
1189
1397
  }
1190
1398
  /**
@@ -1220,9 +1428,25 @@ export type MessageUnsetFields = typeof MessageUnsetFields[keyof typeof MessageU
1220
1428
  * @public
1221
1429
  */
1222
1430
  export interface PartialUpdateMessageInput {
1431
+ /**
1432
+ * The unique identifier of the channel containing the message.
1433
+ * @public
1434
+ */
1223
1435
  channelId: string;
1436
+ /**
1437
+ * The unique identifier of the message to update.
1438
+ * @public
1439
+ */
1224
1440
  messageId: string;
1441
+ /**
1442
+ * Fields to set during the partial update.
1443
+ * @public
1444
+ */
1225
1445
  set?: PartialUpdateMessageSetInput;
1446
+ /**
1447
+ * Fields to unset during the partial update.
1448
+ * @public
1449
+ */
1226
1450
  unset?: (MessageUnsetFields)[];
1227
1451
  }
1228
1452
  /**
@@ -1247,7 +1471,7 @@ export declare class ConversationsServiceException extends __BaseException {
1247
1471
  */
1248
1472
  export interface ScheduleExternalFlagAdjustmentJobInput {
1249
1473
  /**
1250
- * User ID at x-bees.
1474
+ * The unique identifier of the user.
1251
1475
  * @public
1252
1476
  */
1253
1477
  userId: string;
@@ -1261,17 +1485,25 @@ export interface ScheduleExternalFlagAdjustmentJobOutput {
1261
1485
  * @public
1262
1486
  */
1263
1487
  export interface SendGiphyInput {
1488
+ /**
1489
+ * The unique identifier of the channel to which the Giphy message is sent.
1490
+ * @public
1491
+ */
1264
1492
  channelId: string;
1265
1493
  /**
1266
- * User ID for server side calls
1494
+ * The unique identifier of the user when a service token is used.
1267
1495
  * @public
1268
1496
  */
1269
1497
  userId?: string;
1270
1498
  /**
1271
- * Message ID if empty ID will be auto-generated.
1499
+ * The unique identifier of the message. If not provided, an ID will be auto-generated.
1272
1500
  * @public
1273
1501
  */
1274
1502
  messageId?: string;
1503
+ /**
1504
+ * Details of the Giphy message to be sent.
1505
+ * @public
1506
+ */
1275
1507
  giphy: MessageGiphy;
1276
1508
  }
1277
1509
  /**
@@ -1288,17 +1520,25 @@ export interface SendMessageInput {
1288
1520
  attachments?: (MessageAttachment)[];
1289
1521
  quote?: MessageQuote;
1290
1522
  forward?: MessageForward;
1523
+ /**
1524
+ * The unique identifier of the channel to which the message is sent.
1525
+ * @public
1526
+ */
1291
1527
  channelId: string;
1292
1528
  /**
1293
- * User ID for server side calls
1529
+ * The unique identifier of the user when a service token is used.
1294
1530
  * @public
1295
1531
  */
1296
1532
  userId?: string;
1297
1533
  /**
1298
- * Message ID if empty ID will be auto-generated.
1534
+ * The unique identifier of the message. If not provided, an ID will be auto-generated.
1299
1535
  * @public
1300
1536
  */
1301
1537
  messageId?: string;
1538
+ /**
1539
+ * A list of user IDs mentioned in the message.
1540
+ * @public
1541
+ */
1302
1542
  mentions?: (string)[];
1303
1543
  }
1304
1544
  /**
@@ -1311,15 +1551,23 @@ export interface SendMessageOutput {
1311
1551
  * @public
1312
1552
  */
1313
1553
  export interface SendMessageReactionInput {
1554
+ /**
1555
+ * The unique identifier of the channel containing the message.
1556
+ * @public
1557
+ */
1314
1558
  channelId: string;
1559
+ /**
1560
+ * The unique identifier of the message to which the reaction is sent.
1561
+ * @public
1562
+ */
1315
1563
  messageId: string;
1316
1564
  /**
1317
- * Type of the reaction. User could have only 1 reaction of each type per message.
1565
+ * The type of the reaction. A user can have only one reaction of each type per message.
1318
1566
  * @public
1319
1567
  */
1320
1568
  reactionType: ReactionType;
1321
1569
  /**
1322
- * User ID for server side calls
1570
+ * The unique identifier of the user when a service token is used.
1323
1571
  * @public
1324
1572
  */
1325
1573
  userId?: string;
@@ -1333,7 +1581,15 @@ export interface SendMessageReactionOutput {
1333
1581
  * @public
1334
1582
  */
1335
1583
  export interface SendTypingStartInput {
1584
+ /**
1585
+ * The unique identifier of the channel to which the typing start event is sent.
1586
+ * @public
1587
+ */
1336
1588
  channelId: string;
1589
+ /**
1590
+ * The unique identifier of the user when a service token is used.
1591
+ * @public
1592
+ */
1337
1593
  userId?: string;
1338
1594
  }
1339
1595
  /**
@@ -1345,7 +1601,15 @@ export interface SendTypingStartOutput {
1345
1601
  * @public
1346
1602
  */
1347
1603
  export interface SendTypingStopInput {
1604
+ /**
1605
+ * The unique identifier of the channel to which the typing stop event is sent.
1606
+ * @public
1607
+ */
1348
1608
  channelId: string;
1609
+ /**
1610
+ * The unique identifier of the user when a service token is used.
1611
+ * @public
1612
+ */
1349
1613
  userId?: string;
1350
1614
  }
1351
1615
  /**
@@ -1357,7 +1621,15 @@ export interface SendTypingStopOutput {
1357
1621
  * @public
1358
1622
  */
1359
1623
  export interface ShowChannelInput {
1624
+ /**
1625
+ * The unique identifier of the channel to show.
1626
+ * @public
1627
+ */
1360
1628
  channelId: string;
1629
+ /**
1630
+ * The unique identifier of the user when a service token is used.
1631
+ * @public
1632
+ */
1361
1633
  userId?: string;
1362
1634
  }
1363
1635
  /**
@@ -1369,24 +1641,48 @@ export interface ShowChannelOutput {
1369
1641
  * @public
1370
1642
  */
1371
1643
  export interface UpdateChannelInput {
1644
+ /**
1645
+ * The subject of the channel.
1646
+ * @public
1647
+ */
1372
1648
  subject?: string;
1649
+ /**
1650
+ * The description of the channel.
1651
+ * @public
1652
+ */
1373
1653
  description?: string;
1374
1654
  /**
1375
- * Picture URL
1655
+ * The URL of the channel's picture.
1376
1656
  * @public
1377
1657
  */
1378
1658
  picture?: string;
1379
1659
  /**
1380
- * Picture dominant color represented by a hex value.
1660
+ * The dominant color of the channel's picture, represented by a hex value.
1381
1661
  * @public
1382
1662
  */
1383
1663
  pictureColor?: string;
1664
+ /**
1665
+ * The access level of the channel.
1666
+ * @public
1667
+ */
1384
1668
  access?: ChannelAccess;
1669
+ /**
1670
+ * Indicates if the channel is broadcast-only. Default is false.
1671
+ * @public
1672
+ */
1385
1673
  broadcast?: boolean;
1674
+ /**
1675
+ * The unique identifier of the channel to be updated.
1676
+ * @public
1677
+ */
1386
1678
  channelId: string;
1679
+ /**
1680
+ * The unique identifier of the user when a service token is used.
1681
+ * @public
1682
+ */
1387
1683
  userId?: string;
1388
1684
  /**
1389
- * True to not send a system message about updates. Default - false.
1685
+ * Set to true to suppress system messages about the updates. Default is false.
1390
1686
  * @public
1391
1687
  */
1392
1688
  silent?: boolean;
@@ -1405,8 +1701,20 @@ export interface UpdateMessageInput {
1405
1701
  attachments?: (MessageAttachment)[];
1406
1702
  quote?: MessageQuote;
1407
1703
  forward?: MessageForward;
1704
+ /**
1705
+ * The unique identifier of the channel containing the message.
1706
+ * @public
1707
+ */
1408
1708
  channelId: string;
1709
+ /**
1710
+ * The unique identifier of the message to update.
1711
+ * @public
1712
+ */
1409
1713
  messageId: string;
1714
+ /**
1715
+ * A list of user IDs mentioned in the message.
1716
+ * @public
1717
+ */
1410
1718
  mentions?: (string)[];
1411
1719
  }
1412
1720
  /**
@@ -1440,17 +1748,17 @@ export interface UploadFileOptions {
1440
1748
  */
1441
1749
  export interface UploadFileInput {
1442
1750
  /**
1443
- * Channel Id.
1751
+ * The unique identifier of the channel.
1444
1752
  * @public
1445
1753
  */
1446
1754
  channelId: string;
1447
1755
  /**
1448
- * File name, unreadable characters will be replaced with underscores.
1756
+ * The name of the file. Unreadable characters will be replaced with underscores.
1449
1757
  * @public
1450
1758
  */
1451
1759
  name: string;
1452
1760
  /**
1453
- * Additional options.
1761
+ * Additional options for the file upload.
1454
1762
  * @public
1455
1763
  */
1456
1764
  options?: UploadFileOptions;
@@ -1460,12 +1768,12 @@ export interface UploadFileInput {
1460
1768
  */
1461
1769
  export interface UploadFileOutput {
1462
1770
  /**
1463
- * File Id. Format ownerId_uuid.
1771
+ * The unique identifier of the file.
1464
1772
  * @public
1465
1773
  */
1466
1774
  fileId: string;
1467
1775
  /**
1468
- * Presigned URL for upload file.
1776
+ * The presigned URL for uploading the file.
1469
1777
  * @public
1470
1778
  */
1471
1779
  presignedUploadUrl: string;