WHwhispa
awsconnect

Call Started

Webhook called by Lambda when an AWS Connect call starts.

The Lambda function sends this when:

  • A call connects to an agent
  • KVS streaming is started for the contact

This endpoint:

  1. Creates a Whispa session for the call (if agent is mapped)
  2. Starts consuming the KVS stream
  3. Pipes audio to the transcription pipeline

Returns:

  • CallStartedResponse with status="started" and session_id if call is captured
  • CallStartedResponse with status="ignored" and reason if agent is not mapped
post/integrations/telephony/awsconnect/call-started

Request

  • Base URL
    https://dev.whispa.net (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Request body

contact_idstring required

AWS Connect Contact ID

stream_arnstring required

KVS Stream ARN for this call

agent_arnstring nullable

Agent ARN (for user mapping)

customer_numberstring nullable

Customer's phone number

instance_arnstring nullable

AWS Connect Instance ARN

queue_namestring nullable

Queue name the call came through

agent_usernamestring nullable

Agent username in AWS Connect

initiation_methodstring nullable

Call initiation method: INBOUND, OUTBOUND, TRANSFER, CALLBACK, API, etc.

Response

Successful Response

session_idstring uuid nullable

Session ID (None if call was ignored)

statusstring

started, ignored, or error

reasonstring nullable

Reason if status is ignored

Changes

No recorded changes to this operation across all 1 revision of this API.