Amazon S3 integration (transfer and save the voice data to cloud storage)

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>/*"
       }
    ]
}

eng_s3_no_test_save.png

  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.
{
   "Version": "2012-10-17",
   "Statement": [
       {
           "Sid": "MiiTelPutObject",
           "Effect": "Allow",
           "Action": "s3:PutObject",
           "Resource": "arn:aws:s3:::<bucket>/<folder>/*",
           "Condition": {
               "IpAddress": {
                   "aws:SourceIp": [
                      "18.177.83.94/32", "35.73.236.241/32"
                   ]
               }
           }
       },
       {
           "Sid": "MiiTelConnectionCheck",
           "Effect": "Allow",
           "Action": [
               "s3:ListBucket"
           ],
          "Resource": "*",
           "Condition": {
               "IpAddress": {
                   "aws:SourceIp": [
                      "18.177.83.94/32", "35.73.236.241/32"
                   ]
               }
           }
       }
   ]
}

  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

  1. Click Settings __________2019-10-01_18.33.51.png .
  2. Click Amazon S3 integration.
  3. Check Enable Amazon S3 integration.

__________2021-09-02_18.43.29.png

  1. 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

How to remove Amazon S3 integration

Please follow the instructions below if you would like to remove the Amazon S3 integration.

  1. Log in to MiiTel Admin.
  2. Click Third Party Integration > Amazon S3.
  3. Click Remove integration.

eng_S3_disconnect.png 

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.

Was this article helpful?