View Source AWS.ChimeSDKVoice (aws-elixir v1.0.4)
The Amazon Chime SDK telephony APIs in this section enable developers to create PSTN calling solutions that use Amazon Chime SDK Voice Connectors, and Amazon Chime SDK SIP media applications.
Developers can also order and manage phone numbers, create and manage Voice Connectors and SIP media applications, and run voice analytics.
Link to this section Summary
Functions
Associates phone numbers with the specified Amazon Chime SDK Voice Connector.
Associates phone numbers with the specified Amazon Chime SDK Voice Connector group.
Moves phone numbers into the Deletion queue.
Updates phone number product types, calling names, or phone number names.
Creates an order for phone numbers to be provisioned.
Creates a proxy session for the specified Amazon Chime SDK Voice Connector for the specified participant phone numbers.
Creates a SIP media application.
Creates an outbound call to a phone number from the phone number specified
in the request, and it invokes the endpoint of the specified
sipMediaApplicationId
.
Creates a SIP rule, which can be used to run a SIP media application as a target for a specific trigger type.
Creates an Amazon Chime SDK Voice Connector.
Creates an Amazon Chime SDK Voice Connector group under the administrator's AWS account.
Creates a voice profile, which consists of an enrolled user and their latest voice print.
Creates a voice profile domain, a collection of voice profiles, their voice prints, and encrypted enrollment audio.
Moves the specified phone number into the Deletion queue.
Deletes the specified proxy session from the specified Amazon Chime SDK Voice Connector.
Deletes a SIP media application.
Deletes a SIP rule.
Deletes an Amazon Chime SDK Voice Connector.
Deletes the emergency calling details from the specified Amazon Chime SDK Voice Connector.
Deletes the external systems configuration for a Voice Connector.
Deletes an Amazon Chime SDK Voice Connector group.
Deletes the origination settings for the specified Amazon Chime SDK Voice Connector.
Deletes the proxy configuration from the specified Amazon Chime SDK Voice Connector.
Deletes a Voice Connector's streaming configuration.
Deletes the termination settings for the specified Amazon Chime SDK Voice Connector.
Deletes the specified SIP credentials used by your equipment to authenticate during call termination.
Deletes a voice profile, including its voice print and enrollment data.
Deletes all voice profiles in the domain.
Disassociates the specified phone numbers from the specified Amazon Chime SDK Voice Connector.
Disassociates the specified phone numbers from the specified Amazon Chime SDK Voice Connector group.
Retrieves the global settings for the Amazon Chime SDK Voice Connectors in an AWS account.
Retrieves details for the specified phone number ID, such as associations, capabilities, and product type.
Retrieves details for the specified phone number order, such as the order creation timestamp, phone numbers in E.164 format, product type, and order status.
Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.
Retrieves the specified proxy session details for the specified Amazon Chime SDK Voice Connector.
Retrieves the information for a SIP media application, including name, AWS Region, and endpoints.
Gets the Alexa Skill configuration for the SIP media application.
Retrieves the logging configuration for the specified SIP media application.
Retrieves the details of a SIP rule, such as the rule ID, name, triggers, and target endpoints.
Retrieves the details of the specified speaker search task.
Retrieves details for the specified Amazon Chime SDK Voice Connector, such as timestamps,name, outbound host, and encryption requirements.
Retrieves the emergency calling configuration details for the specified Voice Connector.
Gets information about an external systems configuration for a Voice Connector.
Retrieves details for the specified Amazon Chime SDK Voice Connector group,
such as timestamps,name, and associated VoiceConnectorItems
.
Retrieves the logging configuration settings for the specified Voice Connector.
Retrieves the origination settings for the specified Voice Connector.
Retrieves the proxy configuration details for the specified Amazon Chime SDK Voice Connector.
Retrieves the streaming configuration details for the specified Amazon Chime SDK Voice Connector.
Retrieves the termination setting details for the specified Voice Connector.
Retrieves information about the last time a SIP OPTIONS
ping
was received from your SIP infrastructure for the specified Amazon Chime SDK
Voice
Connector.
Retrieves the details of the specified voice profile.
Retrieves the details of the specified voice profile domain.
Retrieves the details of a voice tone analysis task.
Lists the available AWS Regions in which you can create an Amazon Chime SDK Voice Connector.
Lists the phone numbers for an administrator's Amazon Chime SDK account.
Lists the phone numbers for the specified Amazon Chime SDK account, Amazon Chime SDK user, Amazon Chime SDK Voice Connector, or Amazon Chime SDK Voice Connector group.
Lists the proxy sessions for the specified Amazon Chime SDK Voice Connector.
Lists the SIP media applications under the administrator's AWS account.
Lists the SIP rules under the administrator's AWS account.
Lists the countries that you can order phone numbers from.
Returns a list of the tags in a given resource.
Lists the Amazon Chime SDK Voice Connector groups in the administrator's AWS account.
Lists the SIP credentials for the specified Amazon Chime SDK Voice Connector.
Lists the Amazon Chime SDK Voice Connectors in the administrators AWS account.
Lists the specified voice profile domains in the administrator's AWS account.
Lists the voice profiles in a voice profile domain.
Updates the Alexa Skill configuration for the SIP media application.
Updates the logging configuration for the specified SIP media application.
Updates a Voice Connector's emergency calling configuration.
Adds an external systems configuration to a Voice Connector.
Updates a Voice Connector's logging configuration.
Updates a Voice Connector's origination settings.
Puts the specified proxy configuration to the specified Amazon Chime SDK Voice Connector.
Updates a Voice Connector's streaming configuration settings.
Updates a Voice Connector's termination settings.
Updates a Voice Connector's termination credentials.
Restores a deleted phone number.
Searches the provisioned phone numbers in an organization.
Starts a speaker search task.
Starts a voice tone analysis task.
Stops a speaker search task.
Stops a voice tone analysis task.
Adds a tag to the specified resource.
Removes tags from a resource.
Updates global settings for the Amazon Chime SDK Voice Connectors in an AWS account.
Updates phone number details, such as product type, calling name, or phone number name for the specified phone number ID.
Updates the phone number settings for the administrator's AWS account, such as the default outbound calling name.
Updates the specified proxy session details, such as voice or SMS capabilities.
Updates the details of the specified SIP media application.
Invokes the AWS Lambda function associated with the SIP media application and transaction ID in an update request.
Updates the details of the specified SIP rule.
Updates the details for the specified Amazon Chime SDK Voice Connector.
Updates the settings for the specified Amazon Chime SDK Voice Connector group.
Updates the specified voice profile’s voice print and refreshes its expiration timestamp.
Updates the settings for the specified voice profile domain.
Validates an address to be used for 911 calls made with Amazon Chime SDK Voice Connectors.
Link to this section Functions
associate_phone_numbers_with_voice_connector(client, voice_connector_id, input, options \\ [])
View SourceAssociates phone numbers with the specified Amazon Chime SDK Voice Connector.
associate_phone_numbers_with_voice_connector_group(client, voice_connector_group_id, input, options \\ [])
View SourceAssociates phone numbers with the specified Amazon Chime SDK Voice Connector group.
Moves phone numbers into the Deletion queue.
Phone numbers must be disassociated from any users or Amazon Chime SDK Voice Connectors before they can be deleted.
Phone numbers remain in the Deletion queue for 7 days before they are deleted permanently.
Updates phone number product types, calling names, or phone number names.
You can update one attribute at a time for each
UpdatePhoneNumberRequestItem
. For example, you can update the product type,
the calling name, or phone name.
You cannot have a duplicate phoneNumberId
in a request.
Creates an order for phone numbers to be provisioned.
For numbers outside the U.S., you must use the Amazon Chime SDK SIP media application dial-in product type.
create_proxy_session(client, voice_connector_id, input, options \\ [])
View SourceCreates a proxy session for the specified Amazon Chime SDK Voice Connector for the specified participant phone numbers.
Creates a SIP media application.
For more information about SIP media applications, see Managing SIP media applications and rules in the Amazon Chime SDK Administrator Guide.
create_sip_media_application_call(client, sip_media_application_id, input, options \\ [])
View SourceCreates an outbound call to a phone number from the phone number specified
in the request, and it invokes the endpoint of the specified
sipMediaApplicationId
.
Creates a SIP rule, which can be used to run a SIP media application as a target for a specific trigger type.
For more information about SIP rules, see Managing SIP media applications and rules in the Amazon Chime SDK Administrator Guide.
Creates an Amazon Chime SDK Voice Connector.
For more information about Voice Connectors, see Managing Amazon Chime SDK Voice Connector groups in the Amazon Chime SDK Administrator Guide.
Creates an Amazon Chime SDK Voice Connector group under the administrator's AWS account.
You can associate Amazon Chime SDK Voice Connectors with the
Voice Connector group by including VoiceConnectorItems
in the
request.
You can include Voice Connectors from different AWS Regions in your group. This creates a fault tolerant mechanism for fallback in case of availability events.
Creates a voice profile, which consists of an enrolled user and their latest voice print.
Before creating any voice profiles, you must provide all notices and obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under the AWS service terms for the Amazon Chime SDK.
For more information about voice profiles and voice analytics, see Using Amazon Chime SDK Voice Analytics in the Amazon Chime SDK Developer Guide.
Creates a voice profile domain, a collection of voice profiles, their voice prints, and encrypted enrollment audio.
Before creating any voice profiles, you must provide all notices and obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under the AWS service terms for the Amazon Chime SDK.
For more information about voice profile domains, see Using Amazon Chime SDK Voice Analytics in the Amazon Chime SDK Developer Guide.
delete_phone_number(client, phone_number_id, input, options \\ [])
View SourceMoves the specified phone number into the Deletion queue.
A phone number must be disassociated from any users or Amazon Chime SDK Voice Connectors before it can be deleted.
Deleted phone numbers remain in the Deletion queue queue for 7 days before they are deleted permanently.
delete_proxy_session(client, proxy_session_id, voice_connector_id, input, options \\ [])
View SourceDeletes the specified proxy session from the specified Amazon Chime SDK Voice Connector.
delete_sip_media_application(client, sip_media_application_id, input, options \\ [])
View SourceDeletes a SIP media application.
Deletes a SIP rule.
delete_voice_connector(client, voice_connector_id, input, options \\ [])
View SourceDeletes an Amazon Chime SDK Voice Connector.
Any phone numbers associated with the Amazon Chime SDK Voice Connector must be disassociated from it before it can be deleted.
delete_voice_connector_emergency_calling_configuration(client, voice_connector_id, input, options \\ [])
View SourceDeletes the emergency calling details from the specified Amazon Chime SDK Voice Connector.
delete_voice_connector_external_systems_configuration(client, voice_connector_id, input, options \\ [])
View SourceDeletes the external systems configuration for a Voice Connector.
delete_voice_connector_group(client, voice_connector_group_id, input, options \\ [])
View SourceDeletes an Amazon Chime SDK Voice Connector group.
Any VoiceConnectorItems
and phone numbers associated with the group must be removed before it can be
deleted.
delete_voice_connector_origination(client, voice_connector_id, input, options \\ [])
View SourceDeletes the origination settings for the specified Amazon Chime SDK Voice Connector.
If emergency calling is configured for the Voice Connector, it must be deleted prior to deleting the origination settings.
delete_voice_connector_proxy(client, voice_connector_id, input, options \\ [])
View SourceDeletes the proxy configuration from the specified Amazon Chime SDK Voice Connector.
delete_voice_connector_streaming_configuration(client, voice_connector_id, input, options \\ [])
View SourceDeletes a Voice Connector's streaming configuration.
delete_voice_connector_termination(client, voice_connector_id, input, options \\ [])
View SourceDeletes the termination settings for the specified Amazon Chime SDK Voice Connector.
If emergency calling is configured for the Voice Connector, it must be deleted prior to deleting the termination settings.
delete_voice_connector_termination_credentials(client, voice_connector_id, input, options \\ [])
View SourceDeletes the specified SIP credentials used by your equipment to authenticate during call termination.
delete_voice_profile(client, voice_profile_id, input, options \\ [])
View SourceDeletes a voice profile, including its voice print and enrollment data.
WARNING: This action is not reversible.
delete_voice_profile_domain(client, voice_profile_domain_id, input, options \\ [])
View SourceDeletes all voice profiles in the domain.
WARNING: This action is not reversible.
disassociate_phone_numbers_from_voice_connector(client, voice_connector_id, input, options \\ [])
View SourceDisassociates the specified phone numbers from the specified Amazon Chime SDK Voice Connector.
disassociate_phone_numbers_from_voice_connector_group(client, voice_connector_group_id, input, options \\ [])
View SourceDisassociates the specified phone numbers from the specified Amazon Chime SDK Voice Connector group.
Retrieves the global settings for the Amazon Chime SDK Voice Connectors in an AWS account.
Retrieves details for the specified phone number ID, such as associations, capabilities, and product type.
get_phone_number_order(client, phone_number_order_id, options \\ [])
View SourceRetrieves details for the specified phone number order, such as the order creation timestamp, phone numbers in E.164 format, product type, and order status.
Retrieves the phone number settings for the administrator's AWS account, such as the default outbound calling name.
get_proxy_session(client, proxy_session_id, voice_connector_id, options \\ [])
View SourceRetrieves the specified proxy session details for the specified Amazon Chime SDK Voice Connector.
get_sip_media_application(client, sip_media_application_id, options \\ [])
View SourceRetrieves the information for a SIP media application, including name, AWS Region, and endpoints.
get_sip_media_application_alexa_skill_configuration(client, sip_media_application_id, options \\ [])
View SourceGets the Alexa Skill configuration for the SIP media application.
Due to changes made by the Amazon Alexa service, this API is no longer available for use. For more information, refer to the Alexa Smart Properties page.
get_sip_media_application_logging_configuration(client, sip_media_application_id, options \\ [])
View SourceRetrieves the logging configuration for the specified SIP media application.
Retrieves the details of a SIP rule, such as the rule ID, name, triggers, and target endpoints.
get_speaker_search_task(client, speaker_search_task_id, voice_connector_id, options \\ [])
View SourceRetrieves the details of the specified speaker search task.
Retrieves details for the specified Amazon Chime SDK Voice Connector, such as timestamps,name, outbound host, and encryption requirements.
get_voice_connector_emergency_calling_configuration(client, voice_connector_id, options \\ [])
View SourceRetrieves the emergency calling configuration details for the specified Voice Connector.
get_voice_connector_external_systems_configuration(client, voice_connector_id, options \\ [])
View SourceGets information about an external systems configuration for a Voice Connector.
get_voice_connector_group(client, voice_connector_group_id, options \\ [])
View SourceRetrieves details for the specified Amazon Chime SDK Voice Connector group,
such as timestamps,name, and associated VoiceConnectorItems
.
get_voice_connector_logging_configuration(client, voice_connector_id, options \\ [])
View SourceRetrieves the logging configuration settings for the specified Voice Connector.
Shows whether SIP message logs are enabled for sending to Amazon CloudWatch Logs.
get_voice_connector_origination(client, voice_connector_id, options \\ [])
View SourceRetrieves the origination settings for the specified Voice Connector.
get_voice_connector_proxy(client, voice_connector_id, options \\ [])
View SourceRetrieves the proxy configuration details for the specified Amazon Chime SDK Voice Connector.
get_voice_connector_streaming_configuration(client, voice_connector_id, options \\ [])
View SourceRetrieves the streaming configuration details for the specified Amazon Chime SDK Voice Connector.
Shows whether media streaming is enabled for sending to Amazon Kinesis. It also shows the retention period, in hours, for the Amazon Kinesis data.
get_voice_connector_termination(client, voice_connector_id, options \\ [])
View SourceRetrieves the termination setting details for the specified Voice Connector.
get_voice_connector_termination_health(client, voice_connector_id, options \\ [])
View SourceRetrieves information about the last time a SIP OPTIONS
ping
was received from your SIP infrastructure for the specified Amazon Chime SDK
Voice
Connector.
Retrieves the details of the specified voice profile.
get_voice_profile_domain(client, voice_profile_domain_id, options \\ [])
View SourceRetrieves the details of the specified voice profile domain.
get_voice_tone_analysis_task(client, voice_connector_id, voice_tone_analysis_task_id, is_caller, options \\ [])
View SourceRetrieves the details of a voice tone analysis task.
Lists the available AWS Regions in which you can create an Amazon Chime SDK Voice Connector.
list_phone_number_orders(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the phone numbers for an administrator's Amazon Chime SDK account.
list_phone_numbers(client, filter_name \\ nil, filter_value \\ nil, max_results \\ nil, next_token \\ nil, product_type \\ nil, status \\ nil, options \\ [])
View SourceLists the phone numbers for the specified Amazon Chime SDK account, Amazon Chime SDK user, Amazon Chime SDK Voice Connector, or Amazon Chime SDK Voice Connector group.
list_proxy_sessions(client, voice_connector_id, max_results \\ nil, next_token \\ nil, status \\ nil, options \\ [])
View SourceLists the proxy sessions for the specified Amazon Chime SDK Voice Connector.
list_sip_media_applications(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the SIP media applications under the administrator's AWS account.
list_sip_rules(client, max_results \\ nil, next_token \\ nil, sip_media_application_id \\ nil, options \\ [])
View SourceLists the SIP rules under the administrator's AWS account.
list_supported_phone_number_countries(client, product_type, options \\ [])
View SourceLists the countries that you can order phone numbers from.
Returns a list of the tags in a given resource.
list_voice_connector_groups(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the Amazon Chime SDK Voice Connector groups in the administrator's AWS account.
list_voice_connector_termination_credentials(client, voice_connector_id, options \\ [])
View SourceLists the SIP credentials for the specified Amazon Chime SDK Voice Connector.
list_voice_connectors(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the Amazon Chime SDK Voice Connectors in the administrators AWS account.
list_voice_profile_domains(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the specified voice profile domains in the administrator's AWS account.
list_voice_profiles(client, max_results \\ nil, next_token \\ nil, voice_profile_domain_id, options \\ [])
View SourceLists the voice profiles in a voice profile domain.
put_sip_media_application_alexa_skill_configuration(client, sip_media_application_id, input, options \\ [])
View SourceUpdates the Alexa Skill configuration for the SIP media application.
Due to changes made by the Amazon Alexa service, this API is no longer available for use. For more information, refer to the Alexa Smart Properties page.
put_sip_media_application_logging_configuration(client, sip_media_application_id, input, options \\ [])
View SourceUpdates the logging configuration for the specified SIP media application.
put_voice_connector_emergency_calling_configuration(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's emergency calling configuration.
put_voice_connector_external_systems_configuration(client, voice_connector_id, input, options \\ [])
View SourceAdds an external systems configuration to a Voice Connector.
put_voice_connector_logging_configuration(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's logging configuration.
put_voice_connector_origination(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's origination settings.
put_voice_connector_proxy(client, voice_connector_id, input, options \\ [])
View SourcePuts the specified proxy configuration to the specified Amazon Chime SDK Voice Connector.
put_voice_connector_streaming_configuration(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's streaming configuration settings.
put_voice_connector_termination(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's termination settings.
put_voice_connector_termination_credentials(client, voice_connector_id, input, options \\ [])
View SourceUpdates a Voice Connector's termination credentials.
restore_phone_number(client, phone_number_id, input, options \\ [])
View SourceRestores a deleted phone number.
search_available_phone_numbers(client, area_code \\ nil, city \\ nil, country \\ nil, max_results \\ nil, next_token \\ nil, phone_number_type \\ nil, state \\ nil, toll_free_prefix \\ nil, options \\ [])
View SourceSearches the provisioned phone numbers in an organization.
start_speaker_search_task(client, voice_connector_id, input, options \\ [])
View SourceStarts a speaker search task.
Before starting any speaker search tasks, you must provide all notices and obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under the AWS service terms for the Amazon Chime SDK.
start_voice_tone_analysis_task(client, voice_connector_id, input, options \\ [])
View SourceStarts a voice tone analysis task.
For more information about voice tone analysis, see Using Amazon Chime SDK voice analytics in the Amazon Chime SDK Developer Guide.
Before starting any voice tone analysis tasks, you must provide all notices and obtain all consents from the speaker as required under applicable privacy and biometrics laws, and as required under the AWS service terms for the Amazon Chime SDK.
stop_speaker_search_task(client, speaker_search_task_id, voice_connector_id, input, options \\ [])
View SourceStops a speaker search task.
stop_voice_tone_analysis_task(client, voice_connector_id, voice_tone_analysis_task_id, input, options \\ [])
View SourceStops a voice tone analysis task.
Adds a tag to the specified resource.
Removes tags from a resource.
Updates global settings for the Amazon Chime SDK Voice Connectors in an AWS account.
update_phone_number(client, phone_number_id, input, options \\ [])
View SourceUpdates phone number details, such as product type, calling name, or phone number name for the specified phone number ID.
You can update one phone number detail at a time. For example, you can update either the product type, calling name, or phone number name in one action.
For numbers outside the U.S., you must use the Amazon Chime SDK SIP Media Application Dial-In product type.
Updates to outbound calling names can take 72 hours to complete. Pending updates to outbound calling names must be complete before you can request another update.
Updates the phone number settings for the administrator's AWS account, such as the default outbound calling name.
You can update the default outbound calling name once every seven days. Outbound calling names can take up to 72 hours to update.
update_proxy_session(client, proxy_session_id, voice_connector_id, input, options \\ [])
View SourceUpdates the specified proxy session details, such as voice or SMS capabilities.
update_sip_media_application(client, sip_media_application_id, input, options \\ [])
View SourceUpdates the details of the specified SIP media application.
update_sip_media_application_call(client, sip_media_application_id, transaction_id, input, options \\ [])
View SourceInvokes the AWS Lambda function associated with the SIP media application and transaction ID in an update request.
The Lambda function can then return a new set of actions.
Updates the details of the specified SIP rule.
update_voice_connector(client, voice_connector_id, input, options \\ [])
View SourceUpdates the details for the specified Amazon Chime SDK Voice Connector.
update_voice_connector_group(client, voice_connector_group_id, input, options \\ [])
View SourceUpdates the settings for the specified Amazon Chime SDK Voice Connector group.
update_voice_profile(client, voice_profile_id, input, options \\ [])
View SourceUpdates the specified voice profile’s voice print and refreshes its expiration timestamp.
As a condition of using this feature, you acknowledge that the collection, use, storage, and retention of your caller’s biometric identifiers and biometric information (“biometric data”) in the form of a digital voiceprint requires the caller’s informed consent via a written release. Such consent is required under various state laws, including biometrics laws in Illinois, Texas, Washington and other state privacy laws.
You must provide a written release to each caller through a process that clearly reflects each caller’s informed consent before using Amazon Chime SDK Voice Insights service, as required under the terms of your agreement with AWS governing your use of the service.
update_voice_profile_domain(client, voice_profile_domain_id, input, options \\ [])
View SourceUpdates the settings for the specified voice profile domain.
Validates an address to be used for 911 calls made with Amazon Chime SDK Voice Connectors.
You can use validated addresses in a Presence Information Data Format Location Object file that you include in SIP requests. That helps ensure that addresses are routed to the appropriate Public Safety Answering Point.