Class: AWS.ChimeSDKMessaging
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.ChimeSDKMessaging
- Identifier:
- chimesdkmessaging
- API Version:
- 2021-05-15
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
The Amazon Chime SDK Messaging APIs in this section allow software developers to send and receive messages in custom messaging applications. These APIs depend on the frameworks provided by the Amazon Chime SDK Identity APIs. For more information about the messaging APIs, see Amazon Chime SDK messaging
Sending a Request Using ChimeSDKMessaging
var chimesdkmessaging = new AWS.ChimeSDKMessaging();
chimesdkmessaging.associateChannelFlow(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the ChimeSDKMessaging object uses this specific API, you can
construct the object by passing the apiVersion option to the constructor:
var chimesdkmessaging = new AWS.ChimeSDKMessaging({apiVersion: '2021-05-15'});
You can also set the API version globally in AWS.config.apiVersions using
the chimesdkmessaging service identifier:
AWS.config.apiVersions = {
chimesdkmessaging: '2021-05-15',
// other service API versions
};
var chimesdkmessaging = new AWS.ChimeSDKMessaging();
Constructor Summary collapse
-
new AWS.ChimeSDKMessaging(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
associateChannelFlow(params = {}, callback) ⇒ AWS.Request
Associates a channel flow with a channel.
-
batchCreateChannelMembership(params = {}, callback) ⇒ AWS.Request
Adds a specified number of users to a channel.
-
channelFlowCallback(params = {}, callback) ⇒ AWS.Request
Calls back Chime SDK Messaging with a processing response message.
-
createChannel(params = {}, callback) ⇒ AWS.Request
Creates a channel to which you can add users and send messages.
Restriction: You can't change a channel's privacy.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
createChannelBan(params = {}, callback) ⇒ AWS.Request
Permanently bans a member from a channel.
-
createChannelFlow(params = {}, callback) ⇒ AWS.Request
Creates a channel flow, a container for processors.
-
createChannelMembership(params = {}, callback) ⇒ AWS.Request
Adds a user to a channel.
-
createChannelModerator(params = {}, callback) ⇒ AWS.Request
Creates a new
ChannelModerator. -
deleteChannel(params = {}, callback) ⇒ AWS.Request
Immediately makes a channel and its memberships inaccessible and marks them for deletion.
-
deleteChannelBan(params = {}, callback) ⇒ AWS.Request
Removes a user from a channel's ban list.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
deleteChannelFlow(params = {}, callback) ⇒ AWS.Request
Deletes a channel flow, an irreversible process.
-
deleteChannelMembership(params = {}, callback) ⇒ AWS.Request
Removes a member from a channel.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
deleteChannelMessage(params = {}, callback) ⇒ AWS.Request
Deletes a channel message.
-
deleteChannelModerator(params = {}, callback) ⇒ AWS.Request
Deletes a channel moderator.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannel(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel in an Amazon Chime
AppInstance.Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannelBan(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel ban.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannelFlow(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel flow in an Amazon Chime
AppInstance. -
describeChannelMembership(params = {}, callback) ⇒ AWS.Request
Returns the full details of a user's channel membership.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannelMembershipForAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Returns the details of a channel based on the membership of the specified
AppInstanceUser.Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannelModeratedByAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel moderated by the specified
AppInstanceUser.Note: Thex-amz-chime-bearerrequest header is mandatory. -
describeChannelModerator(params = {}, callback) ⇒ AWS.Request
Returns the full details of a single ChannelModerator.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
disassociateChannelFlow(params = {}, callback) ⇒ AWS.Request
Disassociates a channel flow from all its channels.
-
getChannelMembershipPreferences(params = {}, callback) ⇒ AWS.Request
Gets the membership preferences of an
AppInstanceUserfor the specified channel. -
getChannelMessage(params = {}, callback) ⇒ AWS.Request
Gets the full details of a channel message.
Note: The x-amz-chime-bearer request header is mandatory. -
getChannelMessageStatus(params = {}, callback) ⇒ AWS.Request
Gets message status for a specified
messageId. -
getMessagingSessionEndpoint(params = {}, callback) ⇒ AWS.Request
The details of the endpoint for the messaging session.
.
-
listChannelBans(params = {}, callback) ⇒ AWS.Request
Lists all the users banned from a particular channel.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
listChannelFlows(params = {}, callback) ⇒ AWS.Request
Returns a paginated lists of all the channel flows created under a single Chime.
-
listChannelMemberships(params = {}, callback) ⇒ AWS.Request
Lists all channel memberships in a channel.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
listChannelMembershipsForAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Lists all channels that a particular
AppInstanceUseris a part of. -
listChannelMessages(params = {}, callback) ⇒ AWS.Request
List all the messages in a channel.
-
listChannelModerators(params = {}, callback) ⇒ AWS.Request
Lists all the moderators for a channel.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
listChannels(params = {}, callback) ⇒ AWS.Request
Lists all Channels created under a single Chime App as a paginated list.
-
listChannelsAssociatedWithChannelFlow(params = {}, callback) ⇒ AWS.Request
Lists all channels associated with a specified channel flow.
-
listChannelsModeratedByAppInstanceUser(params = {}, callback) ⇒ AWS.Request
A list of the channels moderated by an
AppInstanceUser.Note: Thex-amz-chime-bearerrequest header is mandatory. -
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Lists the tags applied to an Amazon Chime SDK messaging resource.
.
-
putChannelMembershipPreferences(params = {}, callback) ⇒ AWS.Request
Sets the membership preferences of an
AppInstanceUserfor the specified channel. -
redactChannelMessage(params = {}, callback) ⇒ AWS.Request
Redacts message content, but not metadata.
-
sendChannelMessage(params = {}, callback) ⇒ AWS.Request
Sends a message to a particular channel that the member is a part of.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
tagResource(params = {}, callback) ⇒ AWS.Request
Applies the specified tags to the specified Amazon Chime SDK messaging resource.
.
-
untagResource(params = {}, callback) ⇒ AWS.Request
Removes the specified tags from the specified Amazon Chime SDK messaging resource.
.
-
updateChannel(params = {}, callback) ⇒ AWS.Request
Update a channel's attributes.
Restriction: You can't change a channel's privacy.
-
updateChannelFlow(params = {}, callback) ⇒ AWS.Request
Updates channel flow attributes.
-
updateChannelMessage(params = {}, callback) ⇒ AWS.Request
Updates the content of a message.
Note: Thex-amz-chime-bearerrequest header is mandatory. -
updateChannelReadMarker(params = {}, callback) ⇒ AWS.Request
The details of the time when a user last read messages in a channel.
Note: Thex-amz-chime-bearerrequest header is mandatory.
Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService
Constructor Details
new AWS.ChimeSDKMessaging(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Property Details
Method Details
associateChannelFlow(params = {}, callback) ⇒ AWS.Request
Associates a channel flow with a channel. Once associated, all messages to that channel go through channel flow processors. To stop processing, use the DisassociateChannelFlow API.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. batchCreateChannelMembership(params = {}, callback) ⇒ AWS.Request
Adds a specified number of users to a channel.
channelFlowCallback(params = {}, callback) ⇒ AWS.Request
Calls back Chime SDK Messaging with a processing response message. This should be invoked from the processor Lambda. This is a developer API.
You can return one of the following processing responses:
-
Update message content or metadata
-
Deny a message
-
Make no changes to the message
createChannel(params = {}, callback) ⇒ AWS.Request
Creates a channel to which you can add users and send messages.
Restriction: You can't change a channel's privacy.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. createChannelBan(params = {}, callback) ⇒ AWS.Request
Permanently bans a member from a channel. Moderators can't add banned members to a channel. To undo a ban, you first have to DeleteChannelBan, and then CreateChannelMembership. Bans are cleaned up when you delete users or channels.
If you ban a user who is already part of a channel, that user is automatically kicked from the channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. createChannelFlow(params = {}, callback) ⇒ AWS.Request
Creates a channel flow, a container for processors. Processors are AWS Lambda functions that perform actions on chat messages, such as stripping out profanity. You can associate channel flows with channels, and the processors in the channel flow then take action on all messages sent to that channel. This is a developer API.
Channel flows process the following items:
-
New and updated messages
-
Persistent and non-persistent messages
-
The Standard message type
createChannelMembership(params = {}, callback) ⇒ AWS.Request
Adds a user to a channel. The InvitedBy field in ChannelMembership is derived from the request header. A channel member can:
-
List messages
-
Send messages
-
Receive messages
-
Edit their own messages
-
Leave the channel
Privacy settings impact this action as follows:
-
Public Channels: You do not need to be a member to list messages, but you must be a member to send messages.
-
Private Channels: You must be a member to list or send messages.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. createChannelModerator(params = {}, callback) ⇒ AWS.Request
Creates a new ChannelModerator. A channel moderator can:
-
Add and remove other members of the channel.
-
Add and remove other moderators of the channel.
-
Add and remove user bans for the channel.
-
Redact messages in the channel.
-
List messages in the channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. deleteChannel(params = {}, callback) ⇒ AWS.Request
Immediately makes a channel and its memberships inaccessible and marks them for deletion. This is an irreversible process.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. deleteChannelBan(params = {}, callback) ⇒ AWS.Request
Removes a user from a channel's ban list.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. deleteChannelFlow(params = {}, callback) ⇒ AWS.Request
Deletes a channel flow, an irreversible process. This is a developer API.
ListChannelsAssociatedWithChannelFlow API. Use the DisassociateChannelFlow API to disassociate a channel flow from all channels. deleteChannelMembership(params = {}, callback) ⇒ AWS.Request
Removes a member from a channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. deleteChannelMessage(params = {}, callback) ⇒ AWS.Request
Deletes a channel message. Only admins can perform this action. Deletion makes messages inaccessible immediately. A background process deletes any revisions created by UpdateChannelMessage.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. deleteChannelModerator(params = {}, callback) ⇒ AWS.Request
Deletes a channel moderator.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannel(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel in an Amazon Chime AppInstance.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannelBan(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel ban.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannelFlow(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel flow in an Amazon Chime AppInstance. This is a developer API.
describeChannelMembership(params = {}, callback) ⇒ AWS.Request
Returns the full details of a user's channel membership.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannelMembershipForAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Returns the details of a channel based on the membership of the specified AppInstanceUser.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannelModeratedByAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Returns the full details of a channel moderated by the specified AppInstanceUser.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. describeChannelModerator(params = {}, callback) ⇒ AWS.Request
Returns the full details of a single ChannelModerator.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. disassociateChannelFlow(params = {}, callback) ⇒ AWS.Request
Disassociates a channel flow from all its channels. Once disassociated, all messages to that channel stop going through the channel flow processor.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. getChannelMembershipPreferences(params = {}, callback) ⇒ AWS.Request
Gets the membership preferences of an AppInstanceUser for the specified channel. The AppInstanceUser must be a member of the channel. Only the AppInstanceUser who owns the membership can retrieve preferences. Users in the AppInstanceAdmin and channel moderator roles can't retrieve preferences for other users. Banned users can't retrieve membership preferences for the channel from which they are banned.
getChannelMessage(params = {}, callback) ⇒ AWS.Request
Gets the full details of a channel message.
AppInstanceUserArn of the user that makes the API call as the value in the header. getChannelMessageStatus(params = {}, callback) ⇒ AWS.Request
Gets message status for a specified messageId. Use this API to determine the intermediate status of messages going through channel flow processing. The API provides an alternative to retrieving message status if the event was not received because a client wasn't connected to a websocket.
Messages can have any one of these statuses.
- SENT
-
Message processed successfully
- PENDING
-
Ongoing processing
- FAILED
-
Processing failed
- DENIED
-
Messasge denied by the processor
- This API does not return statuses for denied messages, because we don't store them once the processor denies them.
- Only the message sender can invoke this API.
- The
x-amz-chime-bearerrequest header is mandatory. Use theAppInstanceUserArnof the user that makes the API call as the value in the header
getMessagingSessionEndpoint(params = {}, callback) ⇒ AWS.Request
The details of the endpoint for the messaging session.
listChannelBans(params = {}, callback) ⇒ AWS.Request
Lists all the users banned from a particular channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. listChannelFlows(params = {}, callback) ⇒ AWS.Request
Returns a paginated lists of all the channel flows created under a single Chime. This is a developer API.
listChannelMemberships(params = {}, callback) ⇒ AWS.Request
Lists all channel memberships in a channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. If you want to list the channels to which a specific app instance user belongs, see the ListChannelMembershipsForAppInstanceUser API.
listChannelMembershipsForAppInstanceUser(params = {}, callback) ⇒ AWS.Request
Lists all channels that a particular AppInstanceUser is a part of. Only an AppInstanceAdmin can call the API with a user ARN that is not their own.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. listChannelMessages(params = {}, callback) ⇒ AWS.Request
List all the messages in a channel. Returns a paginated list of ChannelMessages. By default, sorted by creation timestamp in descending order.
AppInstanceUserArn of the user that makes the API call as the value in the header. listChannelModerators(params = {}, callback) ⇒ AWS.Request
Lists all the moderators for a channel.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. listChannels(params = {}, callback) ⇒ AWS.Request
Lists all Channels created under a single Chime App as a paginated list. You can specify filters to narrow results.
Functionality & restrictions
-
Use privacy =
PUBLICto retrieve all public channels in the account. -
Only an
AppInstanceAdmincan set privacy =PRIVATEto list the private channels in an account.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. listChannelsAssociatedWithChannelFlow(params = {}, callback) ⇒ AWS.Request
Lists all channels associated with a specified channel flow. You can associate a channel flow with multiple channels, but you can only associate a channel with one channel flow. This is a developer API.
listChannelsModeratedByAppInstanceUser(params = {}, callback) ⇒ AWS.Request
A list of the channels moderated by an AppInstanceUser.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. listTagsForResource(params = {}, callback) ⇒ AWS.Request
Lists the tags applied to an Amazon Chime SDK messaging resource.
putChannelMembershipPreferences(params = {}, callback) ⇒ AWS.Request
Sets the membership preferences of an AppInstanceUser for the specified channel. The AppInstanceUser must be a member of the channel. Only the AppInstanceUser who owns the membership can set preferences. Users in the AppInstanceAdmin and channel moderator roles can't set preferences for other users. Banned users can't set membership preferences for the channel from which they are banned.
redactChannelMessage(params = {}, callback) ⇒ AWS.Request
Redacts message content, but not metadata. The message exists in the back end, but the action returns null content, and the state shows as redacted.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. sendChannelMessage(params = {}, callback) ⇒ AWS.Request
Sends a message to a particular channel that the member is a part of.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. Also, STANDARD messages can contain 4KB of data and the 1KB of metadata. CONTROL messages can contain 30 bytes of data and no metadata. tagResource(params = {}, callback) ⇒ AWS.Request
Applies the specified tags to the specified Amazon Chime SDK messaging resource.
untagResource(params = {}, callback) ⇒ AWS.Request
Removes the specified tags from the specified Amazon Chime SDK messaging resource.
updateChannel(params = {}, callback) ⇒ AWS.Request
Update a channel's attributes.
Restriction: You can't change a channel's privacy.
x-amz-chime-bearer request header is mandatory. Use the AppInstanceUserArn of the user that makes the API call as the value in the header. updateChannelFlow(params = {}, callback) ⇒ AWS.Request
Updates channel flow attributes. This is a developer API.