AWS Chime SDK 電話発信システムセットアップガイド（AWSコンソール版）

このガイドでは、AWS Chime SDKを使用してWebアプリケーションから電話をかけられるシステムをAWSコンソール上で構築する手順を説明します。

前提条件

AWSアカウント（クレジットカード登録済み）
Node.js 18以上がインストール済み
Lambda関数の基本的な作成・デプロイ方法を理解している
IAMロール・ポリシーの基本を理解している

対応リージョン

重要: AWS Chime SDK PSTN Audioは以下のリージョンでのみ利用可能です。

リージョン	リージョンコード	推奨度
米国東部（バージニア北部）	`us-east-1`	必須（電話番号管理）
米国西部（オレゴン）	`us-west-2`	-
アジアパシフィック（東京）	`ap-northeast-1`	Lambda配置推奨
アジアパシフィック（シンガポール）	`ap-southeast-1`	-
アジアパシフィック（シドニー）	`ap-southeast-2`	-

重要な注意点:

電話番号の管理・SIP Media Applicationは us-east-1 で作成
Lambda関数は ap-northeast-1（東京）で作成可能
両リージョンの連携が必要

Lambda関数の準備

Lambda関数コードの作成

以下のコードをLambdaにアップロードしてください。

export const handler = async (event) => {
  console.log('Received event:', JSON.stringify(event, null, 2));

  const { InvocationEventType, CallDetails } = event;

  switch (InvocationEventType) {
    case 'NEW_OUTBOUND_CALL':
      // 発信時の処理
      return {
        SchemaVersion: '1.0',
        Actions: [
          {
            Type: 'CallAndBridge',
            Parameters: {
              CallTimeoutSeconds: 30,
              CallerIdNumber: CallDetails.Participants[0].From
            }
          }
        ]
      };

    case 'CALL_ANSWERED':
      // 応答時の処理
      console.log('Call answered');
      return {
        SchemaVersion: '1.0',
        Actions: []
      };

    case 'HANGUP':
      // 切断時の処理
      console.log('Call ended');
      return {
        SchemaVersion: '1.0',
        Actions: []
      };

    default:
      return {
        SchemaVersion: '1.0',
        Actions: []
      };
  }
};

Chime SDK Voice の電話番号取得

Amazon Chime コンソール

⚠️ 重要: リージョンを us-east-1（バージニア北部）に切り替える

AWSコンソール右上のリージョン選択で「us-east-1」を選択
サービス検索で「Amazon Chime SDK」を検索
左メニューから「Phone number management」→「Orders」を選択

2-2. 電話番号の注文

・「Order phone numbers」をクリック
・以下を設定:

Phone number type: Local
Country: Japan (+81)
Quantity: 1

・利用可能な番号が表示されるので選択
・「Provision」をクリック

2-3. 電話番号の設定確認

「Phone numbers」→「Inventory」を開く
取得した電話番号が「Available」になっていることを確認
電話番号をクリックして詳細を表示
Phone Number IDをメモ（例: +815012345678）

SIP Media Application の作成

SIP Media Application作成

⚠️ リージョンは引き続き us-east-1 のまま

Amazon Chime SDK コンソールで左メニュー「SIP media applications」を選択
「Create SIP media application」をクリック
以下を入力:
- Name: PhoneDialerApp
- Region: US East (N. Virginia)
- Endpoint type: AWS Lambda function ARN
- Lambda function ARN: 先ほどメモしたLambda ARN を入力
```
arn:aws:lambda:ap-northeast-1:123456789012:function:chime-call-control
```
「Create」をクリック
作成されたアプリケーションのSIP Media Application IDをメモ

Lambda リソースポリシーの追加

Lambda関数にChime SDKからの呼び出し権限を付与します。

Lambdaコンソール（リージョン: ap-northeast-1）を開く
chime-call-control 関数を選択
「設定」タブ→「アクセス権限」を選択
「リソースベースのポリシーステートメント」セクションで「ステートメントを追加」
以下を入力:
- ステートメントID: chime-sdk-invoke
- プリンシパル: voiceconnector.chime.amazonaws.com
- ソースARN: arn:aws:chime:us-east-1:YOUR_ACCOUNT_ID:sma/SIP_MEDIA_APP_ID
- アクション: lambda:InvokeFunction
「保存」をクリック

Next.js アプリケーションの作成

プロジェクト作成

npx create-next-app@latest chime-phone-app --typescript --tailwind --app
cd chime-phone-app

必要なパッケージのインストール

npm install @aws-sdk/client-chime-sdk-voice

###　発信API の作成

app/api/calls/start/route.ts を作成:

import { NextRequest, NextResponse } from 'next/server';
import { 
  ChimeSDKVoiceClient, 
  CreateSipMediaApplicationCallCommand 
} from '@aws-sdk/client-chime-sdk-voice';

const client = new ChimeSDKVoiceClient({
  region: process.env.AWS_REGION!,
  credentials: {
    accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
  },
});

export async function POST(request: NextRequest) {
  try {
    const { toPhoneNumber } = await request.json();

    // 電話番号のバリデーション（E.164形式）
    if (!toPhoneNumber.match(/^\+[1-9]\d{1,14}$/)) {
      return NextResponse.json(
        { success: false, error: '正しい電話番号形式で入力してください（例: +819012345678）' },
        { status: 400 }
      );
    }

    const command = new CreateSipMediaApplicationCallCommand({
      FromPhoneNumber: process.env.CHIME_FROM_PHONE_NUMBER!,
      ToPhoneNumber: toPhoneNumber,
      SipMediaApplicationId: process.env.SIP_MEDIA_APPLICATION_ID!,
    });

    const response = await client.send(command);

    return NextResponse.json({
      success: true,
      transactionId: response.SipMediaApplicationCall?.TransactionId,
    });
  } catch (error: any) {
    console.error('Error starting call:', error);
    return NextResponse.json(
      { 
        success: false, 
        error: error.message || 'Failed to start call' 
      },
      { status: 500 }
    );
  }
}

フロントエンドUI の作成

app/page.tsx を作成:

'use client';

import { useState } from 'react';

export default function Home() {
  const [phoneNumber, setPhoneNumber] = useState('');
  const [calling, setCalling] = useState(false);
  const [message, setMessage] = useState('');

  const handleCall = async () => {
    setCalling(true);
    setMessage('');

    try {
      const response = await fetch('/api/calls/start', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ toPhoneNumber: phoneNumber }),
      });

      const data = await response.json();

      if (data.success) {
        setMessage(`✅ 発信成功！\nトランザクションID: ${data.transactionId}`);
      } else {
        setMessage(`❌ エラー: ${data.error}`);
      }
    } catch (error) {
      setMessage('❌ 通信エラーが発生しました');
    } finally {
      setCalling(false);
    }
  };

  return (
    <main className="flex min-h-screen flex-col items-center justify-center p-8 bg-gray-50">
      <div className="max-w-md w-full bg-white rounded-xl shadow-lg p-8 space-y-6">
        <h1 className="text-3xl font-bold text-center text-gray-800">
          📞 電話発信システム
        </h1>
        
        <div className="space-y-4">
          <div>
            <label className="block text-sm font-medium text-gray-700 mb-2">
              発信先電話番号（E.164形式）
            </label>
            <input
              type="tel"
              placeholder="+819012345678"
              value={phoneNumber}
              onChange={(e) => setPhoneNumber(e.target.value)}
              className="w-full px-4 py-3 border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent"
            />
            <p className="mt-1 text-xs text-gray-500">
              例: +819012345678（日本の携帯電話）
            </p>
          </div>
          
          <button
            onClick={handleCall}
            disabled={calling || !phoneNumber}
            className="w-full bg-blue-600 hover:bg-blue-700 text-white font-semibold px-6 py-3 rounded-lg disabled:bg-gray-300 disabled:cursor-not-allowed transition-colors"
          >
            {calling ? '📞 発信中...' : '📞 電話をかける'}
          </button>

          {message && (
            <div className="mt-4 p-4 bg-gray-100 rounded-lg">
              <p className="text-sm whitespace-pre-line">{message}</p>
            </div>
          )}
        </div>

        <div className="pt-4 border-t border-gray-200">
          <h2 className="text-sm font-semibold text-gray-700 mb-2">📋 使い方</h2>
          <ul className="text-xs text-gray-600 space-y-1">
            <li>• 電話番号はE.164形式（+国番号+番号）で入力</li>
            <li>• 日本の場合: +81 の後に先頭の0を除いた番号</li>
            <li>• 例: 090-1234-5678 → +819012345678</li>
          </ul>
        </div>
      </div>
    </main>
  );
}

動作確認とトラブルシューティング

発信テスト

Webアプリで電話番号を入力（例: +819012345678）
「電話をかける」をクリック
成功すると「発信成功！」とトランザクションIDが表示される

5-3. よくあるエラーと対処法

エラー1: `AccessDeniedException`

原因: IAMユーザーにChime SDK権限がない

対処法:

IAMコンソールでユーザーを選択
「許可を追加」→「ポリシーを直接アタッチ」
以下のカスタムポリシーを作成・アタッチ:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "chime:CreateSipMediaApplicationCall",
        "chime:GetSipMediaApplication"
      ],
      "Resource": "*"
    }
  ]
}

エラー2: Lambda関数が実行されない

原因: リソースベースのポリシーが正しく設定されていない

対処法:

Lambda関数のリソースベースのポリシーを再確認
ソースARNが正しいか確認
プリンシパルが voiceconnector.chime.amazonaws.com か確認

エラー3: 電話番号が無効

原因: E.164形式が正しくない

対処法:

正しい形式: +[国番号][市外局番（0なし）][番号]
日本の例:
- ❌ 09012345678
- ❌ +81-90-1234-5678
- ✅ +819012345678

AWS Chime SDK 電話発信システム セットアップガイド（AWSコンソール版）

前提条件

対応リージョン

Lambda関数の準備

Lambda関数コードの作成

Chime SDK Voice の電話番号取得

Amazon Chime コンソール

2-2. 電話番号の注文

2-3. 電話番号の設定確認

SIP Media Application の作成

SIP Media Application作成

Lambda リソースポリシーの追加

Next.js アプリケーションの作成

プロジェクト作成

必要なパッケージのインストール

フロントエンドUI の作成

動作確認とトラブルシューティング

発信テスト

5-3. よくあるエラーと対処法

エラー1: AccessDeniedException

エラー2: Lambda関数が実行されない

エラー3: 電話番号が無効

参考リンク

AWS Chime SDK 電話発信システムセットアップガイド（AWSコンソール版）

エラー1: `AccessDeniedException`