ivschat / Client / send_event

send_event#

ivschat.Client.send_event(**kwargs)#

Sends an event to a room. Use this within your application’s business logic to send events to clients of a room; e.g., to notify clients to change the way the chat UI is rendered.

See also: AWS API Documentation

Request Syntax

response = client.send_event(
    attributes={
        'string': 'string'
    },
    eventName='string',
    roomIdentifier='string'
)
Parameters:

  • attributes (dict) –

    Application-defined metadata to attach to the event sent to clients. The maximum length of the metadata is 1 KB total.

    • (string) –

      • (string) –

  • eventName (string) –

    [REQUIRED]

    Application-defined name of the event to send to clients.

  • roomIdentifier (string) –

    [REQUIRED]

    Identifier of the room to which the event will be sent. Currently this must be an ARN.

Return type:

dict

Returns:

Response Syntax

{
    'id': 'string'
}

Response Structure

  • (dict) –

    • id (string) –

      An identifier generated by Amazon IVS Chat. This identifier must be used in subsequent operations for this message, such as DeleteMessage.

Exceptions

  • ivschat.Client.exceptions.ThrottlingException

  • ivschat.Client.exceptions.AccessDeniedException

  • ivschat.Client.exceptions.ResourceNotFoundException

  • ivschat.Client.exceptions.PendingVerification

  • ivschat.Client.exceptions.ValidationException