You can transfer and save the voice data of MiiTel calls to your company's Amazon S3 (Cloud Storage).
If you want to limit IP addresses during the integration, set the policy described in "Secure IP address during Amazon S3 Integration" for the IAM user and bucket used for S3 integration, and configure the integration settings.
Contents
NOTE
- You will need to sign up for a different contract for Amazon S3 integration. Please contact us if you wish to use this feature.
How to set the policy for IAM users
For IAM users who are using the S3 integration, please set the policy as below.
- For
<bucket>and<folder>: Enter the name of the bucket and folder you will use for the integration.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "MiiTelPutObject",
"Effect": "Allow",
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::<bucket>/<folder>/*"
},
{
"Sid": "MiiTelConnectionCheck",
"Effect": "Allow",
"Action": [
"s3:ListBucket"
],
"Resource": "*"
}
]
}
NOTE
- "MiiTelConnectionCheck" is used to retrieve the bucket list and test if the values in the settings are correct.
Reference #1: If you can't set "s3:ListBucket"
If you can't set "s3:ListBucket" (exporting the bucket list) to the policy, set the following policy for the IAM users using the S3 integration, then click Save without checking connectivity.
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "MiiTelPutObject",
"Effect": "Allow",
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::<bucket>/<folder>/*"
}
]
}
IMPORTANT
-
If you Save without checking connectivity, you won't be able to do a connection test. Therefore, after you finish the phone call, please check and see if there aren't any errors in the third-party integration error log for Amazon S3.
If you see an error, check the details and see if there are any errors in the integration settings.
Reference #2: Fixed IP address for Amazon S3 integration
For IAM users who are using S3 integration, please set the policy as below.
- For
<bucket>and<folder>: Enter the name of the bucket and folder you will use for the integration.
{
}
NOTE
- In the name of the audio file uploaded to Amazon S3, part of the URL in the corresponding call history (Parent sequence ID) will be used. (ID consists of numbers and alphabets after https:// <CompanyID>.miitel.jp/app/calls/ in the displayed URL after clicking the corresponding call history in MiiTel Analytics.)
- If you are looking for specific audio, download the call history list as CSV in MiiTel Analytics, check the Parent sequence ID of the corresponding call history, and search for the file name that includes the corresponding Parent sequence ID.
-
Below is the format of the audio file saved in Amazon S3.
Audio channel: Stereo
Sample rate: 8 kHz
Bit / sample: 16
How to integrate
- Click Settings
.
- Click Amazon S3 integration.
- Check Enable Amazon S3 integration.
- Configure the following settings and click Check connectivity and save
- Bucket: Set the name of the bucket for Amazon S3 that will save MiiTel audio data.
NOTE
- If the path of the bucket name is s3://bucket_name/ or https://bucket_name.<region-name>.amazonaws.com/ , please set it as bucket_name.
- Folder (optional): Set the name of the folder for Amazon S3 that will save MiiTel audio data.
NOTE
- Use half-width alphabets or numbers, and special characters "_", "-", and "/" to enter the folder name.
- Access key: Set the access key when creating an IAM user or the key created by an existing user.
- Secret access key: Set the secret access key when creating an IAM user or the key created by an existing user.
- Region: Set as ap-northeast-1. (Region name for Asia Pacific (Tokyo). Enter other regions by referring to AWS service endpoints.)
NOTE
- If you can't set "s3:ListBucket" (exporting the bucket list) to the policy, please check Reference #1: If you can't set "s3:ListBucket".
How to remove Amazon S3 integration
Please follow the instructions below if you would like to remove the Amazon S3 integration.
- Log in to MiiTel Admin.
- Click Third Party Integration > Amazon S3.
- Click Remove integration.
Optional settings: Email notification settings for external integration error
When an error occurs in Amazon S3 integration or other external integrations for any reason, you can receive error notification emails and check the details of the error.
For setting procedures, please check Email notification settings for external integration error.