:doc:`ConnectParticipant <../../connectparticipant>` / Client / send_event

**********
send_event
**********



.. py:method:: ConnectParticipant.Client.send_event(**kwargs)

  

  .. note::

    

    The ``application/vnd.amazonaws.connect.event.connection.acknowledged`` ContentType is no longer maintained since December 31, 2024. This event has been migrated to the `CreateParticipantConnection <https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html>`__ API using the ``ConnectParticipant`` field.

    

   

  Sends an event. Message receipts are not supported when there are more than two active participants in the chat. Using the SendEvent API for message receipts when a supervisor is barged-in will result in a conflict exception.

   

  For security recommendations, see `Amazon Connect Chat security best practices <https://docs.aws.amazon.com/connect/latest/adminguide/security-best-practices.html#bp-security-chat>`__.

   

  .. note::

    

    ``ConnectionToken`` is used for invoking this API instead of ``ParticipantToken``.

    

   

  The Amazon Connect Participant Service APIs do not use `Signature Version 4 authentication <https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/connectparticipant-2018-09-07/SendEvent>`_  


  **Request Syntax**
  ::

    response = client.send_event(
        ContentType='string',
        Content='string',
        ClientToken='string',
        ConnectionToken='string'
    )
    
  :type ContentType: string
  :param ContentType: **[REQUIRED]** 

    The content type of the request. Supported types are:

     

    
    * application/vnd.amazonaws.connect.event.typing
     
    * application/vnd.amazonaws.connect.event.connection.acknowledged (is no longer maintained since December 31, 2024)
     
    * application/vnd.amazonaws.connect.event.message.delivered
     
    * application/vnd.amazonaws.connect.event.message.read
    

    

  
  :type Content: string
  :param Content: 

    The content of the event to be sent (for example, message text). For content related to message receipts, this is supported in the form of a JSON string.

     

    Sample Content: "{\"messageId\":\"11111111-aaaa-bbbb-cccc-EXAMPLE01234\"}"

    

  
  :type ClientToken: string
  :param ClientToken: 

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see `Making retries safe with idempotent APIs <https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/>`__.

    This field is autopopulated if not provided.

  
  :type ConnectionToken: string
  :param ConnectionToken: **[REQUIRED]** 

    The authentication token associated with the participant's connection.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Id': 'string',
          'AbsoluteTime': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Id** *(string) --* 

        The ID of the response.

        
      

      - **AbsoluteTime** *(string) --* 

        The time when the event was sent.

         

        It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.

        
  
  **Exceptions**
  
  *   :py:class:`ConnectParticipant.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`ConnectParticipant.Client.exceptions.InternalServerException`

  
  *   :py:class:`ConnectParticipant.Client.exceptions.ThrottlingException`

  
  *   :py:class:`ConnectParticipant.Client.exceptions.ValidationException`

  
  *   :py:class:`ConnectParticipant.Client.exceptions.ConflictException`

  