View Source AWS.ChimeSDKMessaging (aws-elixir v1.0.0)

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.

Summary

Functions

Associates a channel flow with a channel.

Adds a specified number of users and bots to 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.

Immediately makes a channel and its memberships inaccessible and marks them for deletion.

Deletes a channel flow, an irreversible process.

Returns the full details of a channel in an Amazon Chime AppInstance.

Returns the full details of a channel flow in an Amazon Chime AppInstance.

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.

Gets the membership preferences of an AppInstanceUser or AppInstanceBot for the specified channel.

The details of the endpoint for the messaging session.

Retrieves the data streaming configuration for an AppInstance.

Returns a paginated lists of all the channel flows created under a single Chime.

Lists all the SubChannels in an elastic channel when given a channel ID.

Lists the tags applied to an Amazon Chime SDK messaging resource.

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.

Allows the ChimeBearer to search channels by channel members.

Sends a message to a particular channel that the member is a part of.

Applies the specified tags to the specified Amazon Chime SDK messaging resource.

Removes the specified tags from the specified Amazon Chime SDK messaging resource.

The details of the time when a user last read messages in a channel.

Functions

Link to this function

associate_channel_flow(client, channel_arn, input, options \\ [])

View Source

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.

Only administrators or channel moderators can associate a channel flow. 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.

Link to this function

batch_create_channel_membership(client, channel_arn, input, options \\ [])

View Source

Adds a specified number of users and bots to a channel.

Link to this function

channel_flow_callback(client, channel_arn, input, options \\ [])

View Source

Calls 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

Link to this function

create_channel(client, input, options \\ [])

View Source

Creates a channel to which you can add users and send messages.

Restriction: You can't change a channel's privacy.

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.

Link to this function

create_channel_ban(client, channel_arn, input, options \\ [])

View Source

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.

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.

Link to this function

create_channel_flow(client, input, options \\ [])

View Source

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:

1. New and updated messages

2. Persistent and non-persistent messages

3. The Standard message type

Channel flows don't process Control or System messages. For more information about the message types provided by Chime SDK messaging, refer to Message types in the Amazon Chime developer guide.

Link to this function

create_channel_membership(client, channel_arn, input, options \\ [])

View Source

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.

The 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.

Link to this function

create_channel_moderator(client, channel_arn, input, options \\ [])

View Source

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.

The x-amz-chime-bearer request header is mandatory. Use the ARN of the AppInstanceUser or AppInstanceBotof the user that makes the API call as the value in the header.

Link to this function

delete_channel(client, channel_arn, input, options \\ [])

View Source

Immediately makes a channel and its memberships inaccessible and marks them for deletion.

This is an irreversible process.

The 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.

Link to this function

delete_channel_ban(client, channel_arn, member_arn, input, options \\ [])

View Source

Removes a member from a channel's ban list.

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.

Link to this function

delete_channel_flow(client, channel_flow_arn, input, options \\ [])

View Source

Deletes 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 the ListChannelsAssociatedWithChannelFlow API. Use the DisassociateChannelFlow API to disassociate a channel flow from all channels.

Link to this function

delete_channel_membership(client, channel_arn, member_arn, input, options \\ [])

View Source

Removes a member from a channel.

The 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.

Link to this function

delete_channel_message(client, channel_arn, message_id, input, options \\ [])

View Source

Deletes a channel message.

Only admins can perform this action. Deletion makes messages inaccessible immediately. A background process deletes any revisions created by UpdateChannelMessage.

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.

Link to this function

delete_channel_moderator(client, channel_arn, channel_moderator_arn, input, options \\ [])

View Source

Deletes a channel moderator.

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.

Link to this function

delete_messaging_streaming_configurations(client, app_instance_arn, input, options \\ [])

View Source

Deletes the streaming configurations for an AppInstance.

For more information, see Streaming messaging data in the Amazon Chime SDK Developer Guide.

Link to this function

describe_channel(client, channel_arn, chime_bearer, options \\ [])

View Source

Returns the full details of a channel in an Amazon Chime AppInstance.

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.

Link to this function

describe_channel_ban(client, channel_arn, member_arn, chime_bearer, options \\ [])

View Source

Returns the full details of a channel ban.

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.

Link to this function

describe_channel_flow(client, channel_flow_arn, options \\ [])

View Source

Returns the full details of a channel flow in an Amazon Chime AppInstance.

This is a developer API.

Link to this function

describe_channel_membership(client, channel_arn, member_arn, sub_channel_id \\ nil, chime_bearer, options \\ [])

View Source

Returns the full details of a user's channel membership.

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.

Link to this function

describe_channel_membership_for_app_instance_user(client, channel_arn, app_instance_user_arn, chime_bearer, options \\ [])

View Source

Returns the details of a channel based on the membership of the specified AppInstanceUser or AppInstanceBot.

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.

Link to this function

describe_channel_moderated_by_app_instance_user(client, channel_arn, app_instance_user_arn, chime_bearer, options \\ [])

View Source

Returns the full details of a channel moderated by the specified AppInstanceUser or AppInstanceBot.

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.

Link to this function

describe_channel_moderator(client, channel_arn, channel_moderator_arn, chime_bearer, options \\ [])

View Source

Returns the full details of a single ChannelModerator.

The 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.

Link to this function

disassociate_channel_flow(client, channel_arn, channel_flow_arn, input, options \\ [])

View Source

Disassociates 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.

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.

Link to this function

get_channel_membership_preferences(client, channel_arn, member_arn, chime_bearer, options \\ [])

View Source

Gets 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.

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.

Link to this function

get_channel_message(client, channel_arn, message_id, sub_channel_id \\ nil, chime_bearer, options \\ [])

View Source

Gets the full details of a channel message.

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.

Link to this function

get_channel_message_status(client, channel_arn, message_id, sub_channel_id \\ nil, chime_bearer, options \\ [])

View Source

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.

Definitions

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.

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.

Link to this function

get_messaging_session_endpoint(client, options \\ [])

View Source

The details of the endpoint for the messaging session.

Link to this function

get_messaging_streaming_configurations(client, app_instance_arn, options \\ [])

View Source

Retrieves the data streaming configuration for an AppInstance.

For more information, see Streaming messaging data in the Amazon Chime SDK Developer Guide.

Link to this function

list_channel_bans(client, channel_arn, max_results \\ nil, next_token \\ nil, chime_bearer, options \\ [])

View Source

Lists all the users and bots banned from a particular 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.

Link to this function

list_channel_flows(client, app_instance_arn, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

Returns a paginated lists of all the channel flows created under a single Chime.

This is a developer API.

Link to this function

list_channel_memberships(client, channel_arn, max_results \\ nil, next_token \\ nil, sub_channel_id \\ nil, type \\ nil, chime_bearer, options \\ [])

View Source

Lists 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.

If you want to list the channels to which a specific app instance user belongs, see the ListChannelMembershipsForAppInstanceUser API.

Link to this function

list_channel_memberships_for_app_instance_user(client, app_instance_user_arn \\ nil, max_results \\ nil, next_token \\ nil, chime_bearer, options \\ [])

View Source

Lists 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.

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.

Link to this function

list_channel_messages(client, channel_arn, max_results \\ nil, next_token \\ nil, not_after \\ nil, not_before \\ nil, sort_order \\ nil, sub_channel_id \\ nil, chime_bearer, options \\ [])

View Source

List 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, 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.

Link to this function

list_channel_moderators(client, channel_arn, max_results \\ nil, next_token \\ nil, chime_bearer, options \\ [])

View Source

Lists all the moderators for 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.

Link to this function

list_channels(client, app_instance_arn, max_results \\ nil, next_token \\ nil, privacy \\ nil, chime_bearer, options \\ [])

View Source

Lists 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.

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.

Link to this function

list_channels_associated_with_channel_flow(client, channel_flow_arn, max_results \\ nil, next_token \\ nil, options \\ [])

View Source

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.

Link to this function

list_channels_moderated_by_app_instance_user(client, app_instance_user_arn \\ nil, max_results \\ nil, next_token \\ nil, chime_bearer, options \\ [])

View Source

A list of the channels moderated by an AppInstanceUser.

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.

Link to this function

list_sub_channels(client, channel_arn, max_results \\ nil, next_token \\ nil, chime_bearer, options \\ [])

View Source

Lists 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.

Link to this function

list_tags_for_resource(client, resource_arn, options \\ [])

View Source

Lists the tags applied to an Amazon Chime SDK messaging resource.

Link to this function

put_channel_expiration_settings(client, channel_arn, input, options \\ [])

View Source

Sets 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.

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.

Link to this function

put_channel_membership_preferences(client, channel_arn, member_arn, input, options \\ [])

View Source

Sets 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.

The x-amz-chime-bearer request header is mandatory. Use the ARN of an AppInstanceUser or AppInstanceBot that makes the API call as the value in the header.

Link to this function

put_messaging_streaming_configurations(client, app_instance_arn, input, options \\ [])

View Source

Sets the data streaming configuration for an AppInstance.

For more information, see Streaming messaging data in the Amazon Chime SDK Developer Guide.

Link to this function

redact_channel_message(client, channel_arn, message_id, input, options \\ [])

View Source

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.

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.

Link to this function

search_channels(client, input, options \\ [])

View Source

Allows 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.

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.

Link to this function

send_channel_message(client, channel_arn, input, options \\ [])

View Source

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.

Link to this function

tag_resource(client, input, options \\ [])

View Source

Applies the specified tags to the specified Amazon Chime SDK messaging resource.

Link to this function

untag_resource(client, input, options \\ [])

View Source

Removes the specified tags from the specified Amazon Chime SDK messaging resource.

Link to this function

update_channel(client, channel_arn, input, options \\ [])

View Source

Update a channel's attributes.

Restriction: You can't change a channel's privacy.

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.

Link to this function

update_channel_flow(client, channel_flow_arn, input, options \\ [])

View Source

Updates channel flow attributes.

This is a developer API.

Link to this function

update_channel_message(client, channel_arn, message_id, input, options \\ [])

View Source

Updates the content of a message.

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.

Link to this function

update_channel_read_marker(client, channel_arn, input, options \\ [])

View Source

The details of the time when a user last read messages 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.