You can transfer and save the voice data of MiiTel calls to your organization'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 set the integration settings.
Contents
NOTE
- You will need to subscribe to Amazon S3 integration. If you want to integrate MiiTel with Amazon S3, please contact us..
How to set the policy for IAM role
For the IAM role that is using the S3 integration, set the policy as below.
IMPORTANT
- If you are currently using the old settings, please switch them to the new settings by August 28, 2024. If you don't change the settings, the Amazon S3 integration will be disconnected.
- Set the following to the Permissions tab of the IAM role created in the AWS management console.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "＜ARN created by RevComm account displayed in Third Party Integration > Amazon S3 of MiiTel Admin＞"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "＜External ID displayed in Third Party Integration > Amazon S3 of MiiTel Admin＞"
}
}
}
]
}
- Attach the high-level policy that has access to the bucket and folder names used for this integration to the Trust relationship tab. (Change
<bucket>and<folder>to the bucket and folder names used in the integration.)
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::<bucket>/<folder>/*"
},
{
"Effect": "Allow",
"Action": "s3:ListBucket",
"Resource": "*"
}
]
}
NOTE
-
If you do not set a folder in Amazon S3 integration settings (MiiTel Admin), replace
"Resource": "arn:aws:s3:::＜backet＞/＜folder＞/*"with"Resource": "arn:aws:s3:::＜backet＞/*".
Reference: Fixed IP address for Amazon S3 integration
Please set the policy below for the IAM role that is used for the S3 integration.
- 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 a 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
IMPORTANT
- IIf you are currently using the old settings, please switch them to the new settings by August 28, 2024. If you don't change the settings, the Amazon S3 integration will be disconnected.
- Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
- Click
Open MiiTel Admin on the top right of the page.
- Click Third Party Integration > Amazon S3 integration.
- Configure the following settings and click Integrate.
1Bucket: Set the bucket name 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.
2Folder (optional): Set the folder name 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.
3Create IAM role: Set the ARN for the created IAM role (The ARN is displayed in Summary when you select the role you created in Amazon S3 under IAM > Roles)
4External ID: Use this ID when you set up the policy for IAM role.
5IAM ARN created by RevComm account: Use this when you set up the policy for IAM role.
How to remove Amazon S3 integration
Follow the instructions below to remove the Amazon S3 integration.
- Visit https://account.miitel.jp/v1/signin and log in to MiiTel Analytics.
-
Click
- 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.