.png?sv=2022-11-02&spr=https&st=2025-10-11T15%3A51%3A35Z&se=2025-10-11T16%3A01%3A35Z&sr=c&sp=r&sig=geSQoIjn%2BBhI8bHaZRLkyLPfXc3ymtCqPraTaRWXTdc%3D){kind=logo}
Conference Call
- DarkLight
Conference Call
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
This API allows an Agent to start a Conference with a customer and a consulted agent.
Pre-requisite
The agent must be on a consult call.
Sequence Diagram
The following figure illustrates the workflow of conference call API:
The following figure illustrates the workflow of leave conference call API:
Message Structure
Request Parameters | Value |
|---|---|
channel | Amazon |
topic | InboundCall |
subtopic | Conference |
source | «app-name-broadcasting-this-message» |
Response Parameters | Value |
|---|---|
channel | Amazon |
topic | InboundCall |
subtopic | InboundCallStateChange |
message | Refer Call Event Parameters |
Possible Error Codes
Error Type | Code | Error Message |
|---|---|---|
CONFERENCE_CALL_FAILED | Amazon Connect Failure Error Message. | Conference call failed. |
Sample Request
{
"channel": "Amazon",
"topic": "InboundCall",
"subtopic": "Conference",
"source": "myapp"
}Sample Response - Call Type: Agent
{
"channel": "Amazon",
"topic": "InboundCall",
"subtopic": "InboundCallStateChange",
"message": {
"call": {
"ButtonStates": {
"items": {
"answer": "Hide",
"reject": "Hide",
"disconnect": "Enable",
"hold": "Hide",
"resume": "Hide",
"clearContact": "Hide",
"consult": "Hide",
"numberpad": "Enable",
"swap": "Hide",
"transfer": "Hide",
"conference": "Hide"
},
"count": 11
},
"ActionsAllowed": null,
"ResponseType": 0,
"ResponseText": "Success",
"ResponseActual": {
"connectionId": "1b91bcc7-ec45-46a9-a82f-57583b7df81b",
"contactId": "9ac52506-1095-47e5-be86-26c594406f0f",
"phoneNumber": null,
"status": "connected",
"statusTimestamp": "2020-04-09T13:09:29.444Z",
"type": "agent",
"buttonStates": {
"answer": false,
"reject": false,
"disconnect": true,
"hold": false,
"resume": false,
"clearContact": false,
"consult": false,
"numberpad": true,
"swap": false,
"transfer": false,
"conference": false
},
"previousStatus": "connecting"
},
"CallVariables": {
"ANI": "+161081111",
"AllowAuxTransfer": "false",
"DNIS": "+16013261548"
},
"ExtendedCallVariables": null,
"ResponseFields": {
"Participants": [],
"MediaProperties": {
"callType": "agent",
"queueName": "InboundTest",
"queueTimestamp": "2020-04-09T13:09:29.444Z"
},
"fromAddress": null,
"CallState": "connected",
"Type": "agent",
"CurrentStateTime": "2020-04-09T13:09:29.444Z",
"Campaign": "",
"DN": "InboundTest"
},
"id": "1b91bcc7-ec45-46a9-a82f-57583b7df81b",
"event": "connected",
"CallType": "agent"
},
"source": "event"
}
}Sample Response - Call Type: Inbound
{
"channel": "Amazon",
"topic": "InboundCall",
"subtopic": "InboundCallStateChange",
"message": {
"call": {
"ButtonStates": {
"items": {
"answer": "Hide",
"reject": "Hide",
"disconnect": "Enable",
"hold": "Enable",
"resume": "Hide",
"clearContact": "Hide",
"consult": "Hide",
"numberpad": "Hide",
"swap": "Hide",
"transfer": "Hide",
"conference": "Hide"
},
"count": 11
},
"ActionsAllowed": null,
"ResponseType": 0,
"ResponseText": "Success",
"ResponseActual": {
"connectionId": "9ac52506-1095-47e5-be86-26c594406f0f",
"contactId": "9ac52506-1095-47e5-be86-26c594406f0f",
"phoneNumber": "+161081111",
"status": "connected",
"statusTimestamp": "2020-04-09T13:09:29.444Z",
"type": "inbound",
"buttonStates": {
"answer": false,
"reject": false,
"disconnect": true,
"hold": true,
"resume": false,
"clearContact": false,
"consult": false,
"numberpad": false,
"swap": false,
"transfer": false,
"conference": false
},
"previousStatus": "hold"
},
"CallVariables": {
"ANI": "+161081111",
"AllowAuxTransfer": "false",
"DNIS": "+16013261548"
},
"ExtendedCallVariables": null,
"ResponseFields": {
"Participants": [],
"MediaProperties": {
"callType": "inbound",
"queueName": "InboundTest",
"queueTimestamp": "2020-04-09T13:09:29.444Z"
},
"fromAddress": "+161081111",
"CallState": "connected",
"Type": "inbound",
"CurrentStateTime": "2020-04-09T13:09:29.444Z",
"Campaign": "",
"DN": "InboundTest"
},
"id": "9ac52506-1095-47e5-be86-26c594406f0f",
"event": "connected",
"CallType": "inbound"
},
"source": "event"
}
}Sample Response - Call Type: Outbound
{
"channel": "Amazon",
"topic": "InboundCall",
"subtopic": "InboundCallStateChange",
"message": {
"call": {
"ButtonStates": {
"items": {
"answer": "Hide",
"reject": "Hide",
"disconnect": "Enable",
"hold": "Enable",
"resume": "Hide",
"clearContact": "Hide",
"consult": "Hide",
"numberpad": "Hide",
"swap": "Hide",
"transfer": "Hide",
"conference": "Hide"
},
"count": 11
},
"ActionsAllowed": null,
"ResponseType": 0,
"ResponseText": "Success",
"ResponseActual": {
"connectionId": "84e773b7-73d9-4290-8199-ba9c61f3aa9d",
"contactId": "9ac52506-1095-47e5-be86-26c594406f0f",
"phoneNumber": "INTERNAL-TRANSFER",
"status": "connected",
"statusTimestamp": "2020-04-09T13:09:29.444Z",
"type": "outbound",
"buttonStates": {
"answer": false,
"reject": false,
"disconnect": true,
"hold": true,
"resume": false,
"clearContact": false,
"consult": false,
"numberpad": false,
"swap": false,
"transfer": false,
"conference": false
},
"previousStatus": "connecting"
},
"CallVariables": {
"ANI": "+161081111",
"AllowAuxTransfer": "false",
"DNIS": "+16013261548"
},
"ExtendedCallVariables": null,
"ResponseFields": {
"Participants": [],
"MediaProperties": {
"callType": "outbound",
"queueName": "InboundTest",
"queueTimestamp": "2020-04-09T13:09:29.444Z"
},
"fromAddress": "INTERNAL-TRANSFER",
"CallState": "connected",
"Type": "outbound",
"CurrentStateTime": "2020-04-09T13:09:29.444Z",
"Campaign": "",
"DN": "InboundTest"
},
"id": "84e773b7-73d9-4290-8199-ba9c61f3aa9d",
"event": "connected",
"CallType": "outbound"
},
"source": "event"
}
}Was this article helpful?