Skip to content

Commit

Permalink
feat(client-chime-sdk-voice): This release adds supports for enterpri…
Browse files Browse the repository at this point in the history
…ses to integrate Amazon Connect with other voice systems. It supports directly transferring voice calls and metadata without using the public telephone network. It also supports real-time and post-call analytics.
  • Loading branch information
awstools committed Dec 2, 2024
1 parent 263848d commit 79dd462
Show file tree
Hide file tree
Showing 14 changed files with 1,168 additions and 0 deletions.
24 changes: 24 additions & 0 deletions clients/client-chime-sdk-voice/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -355,6 +355,14 @@ DeleteVoiceConnectorEmergencyCallingConfiguration

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/DeleteVoiceConnectorEmergencyCallingConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput/)

</details>
<details>
<summary>
DeleteVoiceConnectorExternalSystemsConfiguration
</summary>

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/DeleteVoiceConnectorExternalSystemsConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/DeleteVoiceConnectorExternalSystemsConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput/)

</details>
<details>
<summary>
Expand Down Expand Up @@ -531,6 +539,14 @@ GetVoiceConnectorEmergencyCallingConfiguration

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/GetVoiceConnectorEmergencyCallingConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/GetVoiceConnectorEmergencyCallingConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/GetVoiceConnectorEmergencyCallingConfigurationCommandOutput/)

</details>
<details>
<summary>
GetVoiceConnectorExternalSystemsConfiguration
</summary>

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/GetVoiceConnectorExternalSystemsConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/GetVoiceConnectorExternalSystemsConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/GetVoiceConnectorExternalSystemsConfigurationCommandOutput/)

</details>
<details>
<summary>
Expand Down Expand Up @@ -739,6 +755,14 @@ PutVoiceConnectorEmergencyCallingConfiguration

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/PutVoiceConnectorEmergencyCallingConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/PutVoiceConnectorEmergencyCallingConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/PutVoiceConnectorEmergencyCallingConfigurationCommandOutput/)

</details>
<details>
<summary>
PutVoiceConnectorExternalSystemsConfiguration
</summary>

[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/chime-sdk-voice/command/PutVoiceConnectorExternalSystemsConfigurationCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/PutVoiceConnectorExternalSystemsConfigurationCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-chime-sdk-voice/Interface/PutVoiceConnectorExternalSystemsConfigurationCommandOutput/)

</details>
<details>
<summary>
Expand Down
69 changes: 69 additions & 0 deletions clients/client-chime-sdk-voice/src/ChimeSDKVoice.ts
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,11 @@ import {
DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput,
DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand";
import {
DeleteVoiceConnectorExternalSystemsConfigurationCommand,
DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/DeleteVoiceConnectorExternalSystemsConfigurationCommand";
import {
DeleteVoiceConnectorGroupCommand,
DeleteVoiceConnectorGroupCommandInput,
Expand Down Expand Up @@ -204,6 +209,11 @@ import {
GetVoiceConnectorEmergencyCallingConfigurationCommandInput,
GetVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/GetVoiceConnectorEmergencyCallingConfigurationCommand";
import {
GetVoiceConnectorExternalSystemsConfigurationCommand,
GetVoiceConnectorExternalSystemsConfigurationCommandInput,
GetVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/GetVoiceConnectorExternalSystemsConfigurationCommand";
import {
GetVoiceConnectorGroupCommand,
GetVoiceConnectorGroupCommandInput,
Expand Down Expand Up @@ -334,6 +344,11 @@ import {
PutVoiceConnectorEmergencyCallingConfigurationCommandInput,
PutVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/PutVoiceConnectorEmergencyCallingConfigurationCommand";
import {
PutVoiceConnectorExternalSystemsConfigurationCommand,
PutVoiceConnectorExternalSystemsConfigurationCommandInput,
PutVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/PutVoiceConnectorExternalSystemsConfigurationCommand";
import {
PutVoiceConnectorLoggingConfigurationCommand,
PutVoiceConnectorLoggingConfigurationCommandInput,
Expand Down Expand Up @@ -481,6 +496,7 @@ const commands = {
DeleteSipRuleCommand,
DeleteVoiceConnectorCommand,
DeleteVoiceConnectorEmergencyCallingConfigurationCommand,
DeleteVoiceConnectorExternalSystemsConfigurationCommand,
DeleteVoiceConnectorGroupCommand,
DeleteVoiceConnectorOriginationCommand,
DeleteVoiceConnectorProxyCommand,
Expand All @@ -503,6 +519,7 @@ const commands = {
GetSpeakerSearchTaskCommand,
GetVoiceConnectorCommand,
GetVoiceConnectorEmergencyCallingConfigurationCommand,
GetVoiceConnectorExternalSystemsConfigurationCommand,
GetVoiceConnectorGroupCommand,
GetVoiceConnectorLoggingConfigurationCommand,
GetVoiceConnectorOriginationCommand,
Expand All @@ -529,6 +546,7 @@ const commands = {
PutSipMediaApplicationAlexaSkillConfigurationCommand,
PutSipMediaApplicationLoggingConfigurationCommand,
PutVoiceConnectorEmergencyCallingConfigurationCommand,
PutVoiceConnectorExternalSystemsConfigurationCommand,
PutVoiceConnectorLoggingConfigurationCommand,
PutVoiceConnectorOriginationCommand,
PutVoiceConnectorProxyCommand,
Expand Down Expand Up @@ -869,6 +887,23 @@ export interface ChimeSDKVoice {
cb: (err: any, data?: DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput) => void
): void;

/**
* @see {@link DeleteVoiceConnectorExternalSystemsConfigurationCommand}
*/
deleteVoiceConnectorExternalSystemsConfiguration(
args: DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
options?: __HttpHandlerOptions
): Promise<DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput>;
deleteVoiceConnectorExternalSystemsConfiguration(
args: DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
cb: (err: any, data?: DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;
deleteVoiceConnectorExternalSystemsConfiguration(
args: DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
options: __HttpHandlerOptions,
cb: (err: any, data?: DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;

/**
* @see {@link DeleteVoiceConnectorGroupCommand}
*/
Expand Down Expand Up @@ -1233,6 +1268,23 @@ export interface ChimeSDKVoice {
cb: (err: any, data?: GetVoiceConnectorEmergencyCallingConfigurationCommandOutput) => void
): void;

/**
* @see {@link GetVoiceConnectorExternalSystemsConfigurationCommand}
*/
getVoiceConnectorExternalSystemsConfiguration(
args: GetVoiceConnectorExternalSystemsConfigurationCommandInput,
options?: __HttpHandlerOptions
): Promise<GetVoiceConnectorExternalSystemsConfigurationCommandOutput>;
getVoiceConnectorExternalSystemsConfiguration(
args: GetVoiceConnectorExternalSystemsConfigurationCommandInput,
cb: (err: any, data?: GetVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;
getVoiceConnectorExternalSystemsConfiguration(
args: GetVoiceConnectorExternalSystemsConfigurationCommandInput,
options: __HttpHandlerOptions,
cb: (err: any, data?: GetVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;

/**
* @see {@link GetVoiceConnectorGroupCommand}
*/
Expand Down Expand Up @@ -1674,6 +1726,23 @@ export interface ChimeSDKVoice {
cb: (err: any, data?: PutVoiceConnectorEmergencyCallingConfigurationCommandOutput) => void
): void;

/**
* @see {@link PutVoiceConnectorExternalSystemsConfigurationCommand}
*/
putVoiceConnectorExternalSystemsConfiguration(
args: PutVoiceConnectorExternalSystemsConfigurationCommandInput,
options?: __HttpHandlerOptions
): Promise<PutVoiceConnectorExternalSystemsConfigurationCommandOutput>;
putVoiceConnectorExternalSystemsConfiguration(
args: PutVoiceConnectorExternalSystemsConfigurationCommandInput,
cb: (err: any, data?: PutVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;
putVoiceConnectorExternalSystemsConfiguration(
args: PutVoiceConnectorExternalSystemsConfigurationCommandInput,
options: __HttpHandlerOptions,
cb: (err: any, data?: PutVoiceConnectorExternalSystemsConfigurationCommandOutput) => void
): void;

/**
* @see {@link PutVoiceConnectorLoggingConfigurationCommand}
*/
Expand Down
18 changes: 18 additions & 0 deletions clients/client-chime-sdk-voice/src/ChimeSDKVoiceClient.ts
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,10 @@ import {
DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput,
DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/DeleteVoiceConnectorEmergencyCallingConfigurationCommand";
import {
DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/DeleteVoiceConnectorExternalSystemsConfigurationCommand";
import {
DeleteVoiceConnectorGroupCommandInput,
DeleteVoiceConnectorGroupCommandOutput,
Expand Down Expand Up @@ -181,6 +185,10 @@ import {
GetVoiceConnectorEmergencyCallingConfigurationCommandInput,
GetVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/GetVoiceConnectorEmergencyCallingConfigurationCommand";
import {
GetVoiceConnectorExternalSystemsConfigurationCommandInput,
GetVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/GetVoiceConnectorExternalSystemsConfigurationCommand";
import {
GetVoiceConnectorGroupCommandInput,
GetVoiceConnectorGroupCommandOutput,
Expand Down Expand Up @@ -270,6 +278,10 @@ import {
PutVoiceConnectorEmergencyCallingConfigurationCommandInput,
PutVoiceConnectorEmergencyCallingConfigurationCommandOutput,
} from "./commands/PutVoiceConnectorEmergencyCallingConfigurationCommand";
import {
PutVoiceConnectorExternalSystemsConfigurationCommandInput,
PutVoiceConnectorExternalSystemsConfigurationCommandOutput,
} from "./commands/PutVoiceConnectorExternalSystemsConfigurationCommand";
import {
PutVoiceConnectorLoggingConfigurationCommandInput,
PutVoiceConnectorLoggingConfigurationCommandOutput,
Expand Down Expand Up @@ -387,6 +399,7 @@ export type ServiceInputTypes =
| DeleteSipRuleCommandInput
| DeleteVoiceConnectorCommandInput
| DeleteVoiceConnectorEmergencyCallingConfigurationCommandInput
| DeleteVoiceConnectorExternalSystemsConfigurationCommandInput
| DeleteVoiceConnectorGroupCommandInput
| DeleteVoiceConnectorOriginationCommandInput
| DeleteVoiceConnectorProxyCommandInput
Expand All @@ -409,6 +422,7 @@ export type ServiceInputTypes =
| GetSpeakerSearchTaskCommandInput
| GetVoiceConnectorCommandInput
| GetVoiceConnectorEmergencyCallingConfigurationCommandInput
| GetVoiceConnectorExternalSystemsConfigurationCommandInput
| GetVoiceConnectorGroupCommandInput
| GetVoiceConnectorLoggingConfigurationCommandInput
| GetVoiceConnectorOriginationCommandInput
Expand All @@ -435,6 +449,7 @@ export type ServiceInputTypes =
| PutSipMediaApplicationAlexaSkillConfigurationCommandInput
| PutSipMediaApplicationLoggingConfigurationCommandInput
| PutVoiceConnectorEmergencyCallingConfigurationCommandInput
| PutVoiceConnectorExternalSystemsConfigurationCommandInput
| PutVoiceConnectorLoggingConfigurationCommandInput
| PutVoiceConnectorOriginationCommandInput
| PutVoiceConnectorProxyCommandInput
Expand Down Expand Up @@ -485,6 +500,7 @@ export type ServiceOutputTypes =
| DeleteSipRuleCommandOutput
| DeleteVoiceConnectorCommandOutput
| DeleteVoiceConnectorEmergencyCallingConfigurationCommandOutput
| DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput
| DeleteVoiceConnectorGroupCommandOutput
| DeleteVoiceConnectorOriginationCommandOutput
| DeleteVoiceConnectorProxyCommandOutput
Expand All @@ -507,6 +523,7 @@ export type ServiceOutputTypes =
| GetSpeakerSearchTaskCommandOutput
| GetVoiceConnectorCommandOutput
| GetVoiceConnectorEmergencyCallingConfigurationCommandOutput
| GetVoiceConnectorExternalSystemsConfigurationCommandOutput
| GetVoiceConnectorGroupCommandOutput
| GetVoiceConnectorLoggingConfigurationCommandOutput
| GetVoiceConnectorOriginationCommandOutput
Expand All @@ -533,6 +550,7 @@ export type ServiceOutputTypes =
| PutSipMediaApplicationAlexaSkillConfigurationCommandOutput
| PutSipMediaApplicationLoggingConfigurationCommandOutput
| PutVoiceConnectorEmergencyCallingConfigurationCommandOutput
| PutVoiceConnectorExternalSystemsConfigurationCommandOutput
| PutVoiceConnectorLoggingConfigurationCommandOutput
| PutVoiceConnectorOriginationCommandOutput
| PutVoiceConnectorProxyCommandOutput
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ export interface CreateVoiceConnectorCommandOutput extends CreateVoiceConnectorR
* Value: "STRING_VALUE", // required
* },
* ],
* IntegrationType: "CONNECT_CALL_TRANSFER_CONNECTOR" || "CONNECT_ANALYTICS_CONNECTOR",
* };
* const command = new CreateVoiceConnectorCommand(input);
* const response = await client.send(command);
Expand All @@ -65,6 +66,7 @@ export interface CreateVoiceConnectorCommandOutput extends CreateVoiceConnectorR
* // CreatedTimestamp: new Date("TIMESTAMP"),
* // UpdatedTimestamp: new Date("TIMESTAMP"),
* // VoiceConnectorArn: "STRING_VALUE",
* // IntegrationType: "CONNECT_CALL_TRANSFER_CONNECTOR" || "CONNECT_ANALYTICS_CONNECTOR",
* // },
* // };
*
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
// smithy-typescript generated code
import { getEndpointPlugin } from "@smithy/middleware-endpoint";
import { getSerdePlugin } from "@smithy/middleware-serde";
import { Command as $Command } from "@smithy/smithy-client";
import { MetadataBearer as __MetadataBearer } from "@smithy/types";

import { ChimeSDKVoiceClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../ChimeSDKVoiceClient";
import { commonParams } from "../endpoint/EndpointParameters";
import { DeleteVoiceConnectorExternalSystemsConfigurationRequest } from "../models/models_0";
import {
de_DeleteVoiceConnectorExternalSystemsConfigurationCommand,
se_DeleteVoiceConnectorExternalSystemsConfigurationCommand,
} from "../protocols/Aws_restJson1";

/**
* @public
*/
export type { __MetadataBearer };
export { $Command };
/**
* @public
*
* The input for {@link DeleteVoiceConnectorExternalSystemsConfigurationCommand}.
*/
export interface DeleteVoiceConnectorExternalSystemsConfigurationCommandInput
extends DeleteVoiceConnectorExternalSystemsConfigurationRequest {}
/**
* @public
*
* The output of {@link DeleteVoiceConnectorExternalSystemsConfigurationCommand}.
*/
export interface DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput extends __MetadataBearer {}

/**
* <p>Deletes the external systems configuration for a Voice Connector.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
* import { ChimeSDKVoiceClient, DeleteVoiceConnectorExternalSystemsConfigurationCommand } from "@aws-sdk/client-chime-sdk-voice"; // ES Modules import
* // const { ChimeSDKVoiceClient, DeleteVoiceConnectorExternalSystemsConfigurationCommand } = require("@aws-sdk/client-chime-sdk-voice"); // CommonJS import
* const client = new ChimeSDKVoiceClient(config);
* const input = { // DeleteVoiceConnectorExternalSystemsConfigurationRequest
* VoiceConnectorId: "STRING_VALUE", // required
* };
* const command = new DeleteVoiceConnectorExternalSystemsConfigurationCommand(input);
* const response = await client.send(command);
* // {};
*
* ```
*
* @param DeleteVoiceConnectorExternalSystemsConfigurationCommandInput - {@link DeleteVoiceConnectorExternalSystemsConfigurationCommandInput}
* @returns {@link DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput}
* @see {@link DeleteVoiceConnectorExternalSystemsConfigurationCommandInput} for command's `input` shape.
* @see {@link DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput} for command's `response` shape.
* @see {@link ChimeSDKVoiceClientResolvedConfig | config} for ChimeSDKVoiceClient's `config` shape.
*
* @throws {@link BadRequestException} (client fault)
* <p>The input parameters don't match the service's restrictions.</p>
*
* @throws {@link ForbiddenException} (client fault)
* <p>The client is permanently forbidden from making the request.</p>
*
* @throws {@link NotFoundException} (client fault)
* <p>The requested resource couldn't be found.</p>
*
* @throws {@link ServiceFailureException} (server fault)
* <p>The service encountered an unexpected error.</p>
*
* @throws {@link ServiceUnavailableException} (server fault)
* <p>The service is currently unavailable.</p>
*
* @throws {@link ThrottledClientException} (client fault)
* <p>The number of customer requests exceeds the request rate limit.</p>
*
* @throws {@link UnauthorizedClientException} (client fault)
* <p>The client isn't authorized to request a resource.</p>
*
* @throws {@link ChimeSDKVoiceServiceException}
* <p>Base exception class for all service exceptions from ChimeSDKVoice service.</p>
*
* @public
*/
export class DeleteVoiceConnectorExternalSystemsConfigurationCommand extends $Command
.classBuilder<
DeleteVoiceConnectorExternalSystemsConfigurationCommandInput,
DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput,
ChimeSDKVoiceClientResolvedConfig,
ServiceInputTypes,
ServiceOutputTypes
>()
.ep(commonParams)
.m(function (this: any, Command: any, cs: any, config: ChimeSDKVoiceClientResolvedConfig, o: any) {
return [
getSerdePlugin(config, this.serialize, this.deserialize),
getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
];
})
.s("ChimeSDKTelephonyService", "DeleteVoiceConnectorExternalSystemsConfiguration", {})
.n("ChimeSDKVoiceClient", "DeleteVoiceConnectorExternalSystemsConfigurationCommand")
.f(void 0, void 0)
.ser(se_DeleteVoiceConnectorExternalSystemsConfigurationCommand)
.de(de_DeleteVoiceConnectorExternalSystemsConfigurationCommand)
.build() {
/** @internal type navigation helper, not in runtime. */
protected declare static __types: {
api: {
input: DeleteVoiceConnectorExternalSystemsConfigurationRequest;
output: {};
};
sdk: {
input: DeleteVoiceConnectorExternalSystemsConfigurationCommandInput;
output: DeleteVoiceConnectorExternalSystemsConfigurationCommandOutput;
};
};
}
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ export interface GetVoiceConnectorCommandOutput extends GetVoiceConnectorRespons
* // CreatedTimestamp: new Date("TIMESTAMP"),
* // UpdatedTimestamp: new Date("TIMESTAMP"),
* // VoiceConnectorArn: "STRING_VALUE",
* // IntegrationType: "CONNECT_CALL_TRANSFER_CONNECTOR" || "CONNECT_ANALYTICS_CONNECTOR",
* // },
* // };
*
Expand Down
Loading

0 comments on commit 79dd462

Please sign in to comment.