View Source aws_chime_sdk_messaging (aws v1.0.4)
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: https://docs.aws.amazon.com/chime/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html.Summary
Functions
Associates a channel flow with a channel.
Calls back Amazon Chime SDK messaging with a processing response message.
Creates a channel to which you can add users and send messages.
Permanently bans a member from a channel.
Creates a channel flow, a container for processors.
Adds a member to a channel.
Creates a new ChannelModerator
.
Immediately makes a channel and its memberships inaccessible and marks them for deletion.
Removes a member from a channel's ban list.
Deletes a channel flow, an irreversible process.
Removes a member from a channel.
Deletes a channel message.
Deletes a channel moderator.
Deletes the streaming configurations for an AppInstance
.
Returns the full details of a channel in an Amazon Chime AppInstance
.
Returns the full details of a channel ban.
Returns the full details of a channel flow in an Amazon Chime AppInstance
.
Returns the full details of a user's channel membership.
Returns the details of a channel based on the membership of the specified AppInstanceUser
or AppInstanceBot
.
Returns the full details of a channel moderated by the specified AppInstanceUser
or AppInstanceBot
.
Returns the full details of a single ChannelModerator.
Disassociates a channel flow from all its channels.
Gets the membership preferences of an AppInstanceUser
or AppInstanceBot
for the specified channel.
Gets the full details of a channel message.
Gets message status for a specified messageId
.
Retrieves the data streaming configuration for an AppInstance
.
Lists all the users and bots banned from a particular channel.
Returns a paginated lists of all the channel flows created under a single Chime.
Lists all channel memberships in a channel.
Lists all channels that an AppInstanceUser
or AppInstanceBot
is a part of.
List all the messages in a channel.
Lists all the moderators for a channel.
Lists all Channels created under a single Chime App as a paginated list.
Lists all channels associated with a specified channel flow.
A list of the channels moderated by an AppInstanceUser
.
Lists all the SubChannels in an elastic channel when given a channel ID.
Sets the number of days before the channel is automatically deleted.
Sets the membership preferences of an AppInstanceUser
or AppInstanceBot
for the specified channel.
Sets the data streaming configuration for an AppInstance
.
Redacts message content, but not metadata.
Allows the ChimeBearer
to search channels by channel members.
Sends a message to a particular channel that the member is a part of.
Update a channel's attributes.
Updates channel flow attributes.
Updates the content of a message.
The details of the time when a user last read messages in a channel.
Functions
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 ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
batch_create_channel_membership(Client, ChannelArn, Input0, Options0)
View SourceCalls back Amazon 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
Creates a channel to which you can add users and send messages.
Restriction: You can't change a channel's privacy.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
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.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
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
Adds a member 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 ARN of the AppInstanceUserArn
or AppInstanceBot
that makes the API call as the value in the header.
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 ARN of the AppInstanceUser
or AppInstanceBot
of the user that makes the API call as the value in the header.
Immediately makes a channel and its memberships inaccessible and marks them for deletion.
This is an irreversible process.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUserArn
or AppInstanceBot
that makes the API call as the value in the header.
Removes a member from a channel's ban list.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
delete_channel_ban(Client, ChannelArn, MemberArn, Input0, Options0)
View SourceDeletes a channel flow, an irreversible process.
This is a developer API.
This API works only when the channel flow is not associated with any channel. To get a list of all channels that a channel flow is associated with, use theListChannelsAssociatedWithChannelFlow
API. Use the DisassociateChannelFlow
API to disassociate a channel flow from all channels.
Removes a member from a channel.
Thex-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
delete_channel_membership(Client, ChannelArn, MemberArn, Input0, Options0)
View SourceDeletes 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 ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
delete_channel_message(Client, ChannelArn, MessageId, Input0, Options0)
View Sourcedelete_channel_moderator(Client, ChannelArn, ChannelModeratorArn, Input)
View SourceDeletes a channel moderator.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
delete_channel_moderator(Client, ChannelArn, ChannelModeratorArn, Input0, Options0)
View Sourcedelete_messaging_streaming_configurations(Client, AppInstanceArn, Input)
View SourceDeletes the streaming configurations for an AppInstance
.
delete_messaging_streaming_configurations(Client, AppInstanceArn, Input0, Options0)
View SourceReturns the full details of a channel in an Amazon Chime AppInstance
.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
describe_channel(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceReturns the full details of a channel ban.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
describe_channel_ban(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel_ban(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceReturns the full details of a channel flow in an Amazon Chime AppInstance
.
describe_channel_flow(Client, ChannelFlowArn, QueryMap, HeadersMap)
View Sourcedescribe_channel_flow(Client, ChannelFlowArn, QueryMap, HeadersMap, Options0)
View Sourcedescribe_channel_membership(Client, ChannelArn, MemberArn, ChimeBearer)
View SourceReturns the full details of a user's channel membership.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
describe_channel_membership(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel_membership(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcedescribe_channel_membership_for_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer)
View SourceReturns the details of a channel based on the membership of the specified AppInstanceUser
or AppInstanceBot
.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
describe_channel_membership_for_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel_membership_for_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcedescribe_channel_moderated_by_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer)
View SourceReturns the full details of a channel moderated by the specified AppInstanceUser
or AppInstanceBot
.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
describe_channel_moderated_by_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel_moderated_by_app_instance_user(Client, ChannelArn, AppInstanceUserArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcedescribe_channel_moderator(Client, ChannelArn, ChannelModeratorArn, ChimeBearer)
View SourceReturns the full details of a single ChannelModerator.
Thex-amz-chime-bearer
request header is mandatory. Use the AppInstanceUserArn
of the user that makes the API call as the value in the header.
describe_channel_moderator(Client, ChannelArn, ChannelModeratorArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcedescribe_channel_moderator(Client, ChannelArn, ChannelModeratorArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcedisassociate_channel_flow(Client, ChannelArn, ChannelFlowArn, Input)
View SourceDisassociates a channel flow from all its channels.
Once disassociated, all messages to that channel stop going through the channel flow processor.
Only administrators or channel moderators can disassociate a channel flow.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
disassociate_channel_flow(Client, ChannelArn, ChannelFlowArn, Input0, Options0)
View Sourceget_channel_membership_preferences(Client, ChannelArn, MemberArn, ChimeBearer)
View SourceGets the membership preferences of an AppInstanceUser
or AppInstanceBot
for the specified channel.
A user or a bot must be a member of the channel and own the membership in order to retrieve membership preferences. Users or bots in the AppInstanceAdmin
and channel moderator roles can't retrieve preferences for other users or bots. Banned users or bots can't retrieve membership preferences for the channel from which they are banned.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
get_channel_membership_preferences(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap)
View Sourceget_channel_membership_preferences(Client, ChannelArn, MemberArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceGets the full details of a channel message.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
get_channel_message(Client, ChannelArn, MessageId, ChimeBearer, QueryMap, HeadersMap)
View Sourceget_channel_message(Client, ChannelArn, MessageId, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourceget_channel_message_status(Client, ChannelArn, MessageId, ChimeBearer)
View SourceGets 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
Message 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.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
get_channel_message_status(Client, ChannelArn, MessageId, ChimeBearer, QueryMap, HeadersMap)
View Sourceget_channel_message_status(Client, ChannelArn, MessageId, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourceget_messaging_session_endpoint(Client, QueryMap, HeadersMap, Options0)
View SourceRetrieves the data streaming configuration for an AppInstance
.
get_messaging_streaming_configurations(Client, AppInstanceArn, QueryMap, HeadersMap)
View Sourceget_messaging_streaming_configurations(Client, AppInstanceArn, QueryMap, HeadersMap, Options0)
View SourceLists all the users and bots banned from a particular channel.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channel_bans(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channel_bans(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceReturns a paginated lists of all the channel flows created under a single Chime.
This is a developer API.list_channel_flows(Client, AppInstanceArn, QueryMap, HeadersMap, Options0)
View SourceLists all channel memberships in a channel.
The x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channel_memberships(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channel_memberships(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcelist_channel_memberships_for_app_instance_user(Client, ChimeBearer)
View SourceLists all channels that an AppInstanceUser
or AppInstanceBot
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 ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channel_memberships_for_app_instance_user(Client, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channel_memberships_for_app_instance_user(Client, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceList all the messages in a channel.
Returns a paginated list of ChannelMessages
. By default, sorted by creation timestamp in descending order.
Redacted messages appear in the results as empty, since they are only redacted, not deleted. Deleted messages do not appear in the results. This action always returns the latest version of an edited message.
Also, thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channel_messages(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channel_messages(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceLists all the moderators for a channel.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channel_moderators(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channel_moderators(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceLists all Channels created under a single Chime App as a paginated list.
You can specify filters to narrow results.
Functionality & restrictions
Use privacy =
PUBLIC
to retrieve all public channels in the account.Only an
AppInstanceAdmin
can set privacy =PRIVATE
to list the private channels in an account.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channels(Client, AppInstanceArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channels(Client, AppInstanceArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcelist_channels_associated_with_channel_flow(Client, ChannelFlowArn)
View SourceLists 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.list_channels_associated_with_channel_flow(Client, ChannelFlowArn, QueryMap, HeadersMap)
View Sourcelist_channels_associated_with_channel_flow(Client, ChannelFlowArn, QueryMap, HeadersMap, Options0)
View SourceA list of the channels moderated by an AppInstanceUser
.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
list_channels_moderated_by_app_instance_user(Client, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_channels_moderated_by_app_instance_user(Client, ChimeBearer, QueryMap, HeadersMap, Options0)
View SourceLists all the SubChannels in an elastic channel when given a channel ID.
Available only to the app instance admins and channel moderators of elastic channels.list_sub_channels(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap)
View Sourcelist_sub_channels(Client, ChannelArn, ChimeBearer, QueryMap, HeadersMap, Options0)
View Sourcelist_tags_for_resource(Client, ResourceARN, QueryMap, HeadersMap, Options0)
View SourceSets the number of days before the channel is automatically deleted.
A background process deletes expired channels within 6 hours of expiration. Actual deletion times may vary.
Expired channels that have not yet been deleted appear as active, and you can update their expiration settings. The system honors the new settings.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
put_channel_expiration_settings(Client, ChannelArn, Input0, Options0)
View Sourceput_channel_membership_preferences(Client, ChannelArn, MemberArn, Input)
View SourceSets the membership preferences of an AppInstanceUser
or AppInstanceBot
for the specified channel.
The user or bot must be a member of the channel. Only the user or bot who owns the membership can set preferences. Users or bots in the AppInstanceAdmin
and channel moderator roles can't set preferences for other users. Banned users or bots can't set membership preferences for the channel from which they are banned.
AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
put_channel_membership_preferences(Client, ChannelArn, MemberArn, Input0, Options0)
View Sourceput_messaging_streaming_configurations(Client, AppInstanceArn, Input)
View SourceSets the data streaming configuration for an AppInstance
.
put_messaging_streaming_configurations(Client, AppInstanceArn, Input0, Options0)
View SourceRedacts message content, but not metadata.
The message exists in the back end, but the action returns null content, and the state shows as redacted.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
redact_channel_message(Client, ChannelArn, MessageId, Input0, Options0)
View SourceAllows the ChimeBearer
to search channels by channel members.
Users or bots can search across the channels that they belong to. Users in the AppInstanceAdmin
role can search across all channels.
x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
Sends a message to a particular channel that the member is a part of.
The x-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
Also, STANDARD
messages can be up to 4KB in size and contain metadata. Metadata is arbitrary, and you can use it in a variety of ways, such as containing a link to an attachment.
CONTROL
messages are limited to 30 bytes and do not contain metadata.
Update a channel's attributes.
Restriction: You can't change a channel's privacy.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
Updates channel flow attributes.
This is a developer API.Updates the content of a message.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.
update_channel_message(Client, ChannelArn, MessageId, Input0, Options0)
View SourceThe details of the time when a user last read messages in a channel.
Thex-amz-chime-bearer
request header is mandatory. Use the ARN of the AppInstanceUser
or AppInstanceBot
that makes the API call as the value in the header.