AWS Amazon Connect Participant Service

Name: Amazon Connect Participant Service API
Brand: Amazon Connect Participant Service
Availability: InStock

Browse all Amazonaws APIs

★ Only Publicly Available OpenAPI DocumentCommunicationsChat MessagingAWS Signature v4 (HMAC)8 Endpoints

Install Jentic One Beta

Connect the Amazon Connect Participant Service to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Amazon Connect Participant Service, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Amazon Connect Participant Service API.

Establish a participant connection to a Connect chat using a participant token

Send chat messages and post participant events such as typing and read receipts

Retrieve the chat transcript for a session

GET STARTED

Start building with Amazon Connect Participant Service API

Explore with Jentic

View OpenAPI Document

For Agents

Connect a customer-side participant to an Amazon Connect chat session, send and receive messages, post events, and upload attachments.

Use for: I need to send a chat message as a customer participant, I want to retrieve the transcript of a Connect chat, Get the connection token for a chat participant, Upload an attachment to a Connect chat session

Not supported: Does not handle voice, SMS, or starting chat sessions - use Amazon Connect to start the chat, then this API for the customer-side connection only.

Use Cases

Patterns agents use Amazon Connect Participant Service API for, with concrete tasks.

★ Customer-Side Web Chat Widget

Companies embed a chat widget on their website that talks to Amazon Connect on the customer's behalf. The widget exchanges a participant token (issued by StartChatContact on the agent side) for a connection via CreateParticipantConnection, then uses SendMessage and SendEvent to drive the conversation. Integration takes one to two days for a polished widget.

Call CreateParticipantConnection with a participant token, then SendMessage with ContentType=text/plain and a greeting.

Mobile-App Chat Integration

Mobile apps embed Connect chat directly so customers can reach support without leaving the app. Connect Participant Service handles the connection, message stream, and attachments such as receipts or screenshots, while the agent side uses Connect itself. Push of new messages is via a websocket negotiated through CreateParticipantConnection.

Call StartAttachmentUpload for a JPEG, upload the bytes to the returned URL, then CompleteAttachmentUpload to attach it to the chat.

Transcript Retrieval and Disconnection

When a chat ends, applications need to fetch the transcript for storage, search, and analytics, and to disconnect the participant cleanly. GetTranscript returns paginated message and event history, and DisconnectParticipant ends the participant's session.

Call GetTranscript with a ConnectionToken, page through the results, then call DisconnectParticipant to end the session.

Agent-Bridged Chat Operations

An AI agent operating as a customer-side participant can drive automated chat flows for testing, monitoring, or self-service experimentation. Through Jentic, the agent exchanges the token, sends messages, and inspects transcripts without managing the SigV4 signing required for every Participant Service call.

Use CreateParticipantConnection to obtain a ConnectionToken, send a series of test messages with SendMessage, then GetTranscript to verify they were received.

Key Endpoints

8 endpoints — jentic publishes the only available openapi specification for amazon connect participant service, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/participant/connection#X-Amz-Bearer

Create a participant connection from a participant token

POST

/participant/message#X-Amz-Bearer

Send a chat message

POST

/participant/event#X-Amz-Bearer

Send a chat event such as a typing indicator

POST

/participant/transcript#X-Amz-Bearer

Retrieve the chat transcript

POST

/participant/start-attachment-upload#X-Amz-Bearer

Begin uploading an attachment

POST

/participant/complete-attachment-upload#X-Amz-Bearer

Finalize an attachment upload

POST

/participant/disconnect#X-Amz-Bearer

Disconnect the participant

POST

/participant/connection#X-Amz-Bearer

Create a participant connection from a participant token

POST

/participant/message#X-Amz-Bearer

Send a chat message

POST

/participant/event#X-Amz-Bearer

Send a chat event such as a typing indicator

POST

/participant/transcript#X-Amz-Bearer

Retrieve the chat transcript

POST

/participant/start-attachment-upload#X-Amz-Bearer

Begin uploading an attachment

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your AWS credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'send a chat message as a Connect participant' or 'retrieve the chat transcript', and Jentic returns the matching Amazon Connect Participant Service operation with its input schema so the agent calls the right endpoint without browsing the AWS service reference.

Time to first call

FAQs

Specific to using Amazon Connect Participant Service API through Jentic.

Why is there no official OpenAPI spec for Amazon Connect Participant Service?

AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Amazon Connect Participant Service via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Amazon Connect Participant Service use?

Each operation uses a participant token issued by StartChatContact and exchanged for a ConnectionToken via CreateParticipantConnection. AWS SigV4 still signs the call. Jentic stores the AWS credentials in its vault, signs the request, and threads the participant token through the X-Amz-Bearer header.

Can I send attachments through the Amazon Connect Participant Service?

Yes. Call StartAttachmentUpload to receive a presigned upload URL, PUT the file to that URL, then call CompleteAttachmentUpload. The attachment becomes accessible via GetAttachment for any participant in the chat.

What are the rate limits for the Amazon Connect Participant Service?

Per-account, per-region TPS limits apply, with SendMessage and SendEvent at higher TPS than GetTranscript. Plan for ThrottlingException with exponential backoff, especially when bridging multiple participants from a single backend.

How do I send a customer-side chat message through Jentic?

Search Jentic for 'send a chat message as a Connect participant', load the SendMessage schema, and execute it with the ConnectionToken, ContentType=text/plain (or text/markdown), and the message Content. The message appears in the agent's CCP and in subsequent GetTranscript calls.

Is the Amazon Connect Participant Service free?

There is no separate API charge - usage is billed via Amazon Connect's chat usage pricing, which charges per chat message in active sessions.

Can I limit what my agent is allowed to do with the Amazon Connect Participant Service?

Yes. Because Jentic One is self-hosted, you set the rules for which operations and credentials your agent may use, so you can grant it just the calls it needs, such as CreateParticipantConnection, SendMessage, and GetTranscript. Since the chat is identified by the participant token rather than a resource id in the URL path, scoping is done at the operation level: leave out calls like SendEvent or DisconnectParticipant unless you deliberately add them. The stored AWS credentials are injected only at execution time for the operations you allow, so the agent cannot reach past that boundary.

AWS Amazon Connect Participant Service

Connect the Amazon Connect Participant Service to your agent

Capabilities

Start building with Amazon Connect Participant Service API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs