PutOutboundRequestBatchは、Amazon Connectのアウトバウンドキャンペーン(V2)に「この番号へ発信して」「このアドレスへ送って」という依頼を、1回25件までまとめて登録するAPIです。宛先リストを自社のCRMや基幹システムに持ったまま、Amazon Connectから一斉に電話・SMS・メールを届けたいときに使います。この記事では、受け付けるキャンペーンの作り方、リクエストとレスポンスの形、公式ドキュメントに書かれておらず第三者の検証で分かった「有効期限は15分以内」「インスタンス単位の通信制限が効かない」という2つの落とし穴、東京リージョンの料金までを、AWSの公式資料とSDKのサービス定義、boto3で検証したコードで整理します。
まとめ:PutOutboundRequestBatchの要点
- Amazon Connect Outbound Campaigns V2(サービス名
connectcampaignsv2、API版 2024-04-23)の操作。PUT /v2/campaigns/{id}/outbound-requestsに依頼を1〜25件渡し、認証はAWSの署名(SigV4)で行う。 - 送り先のキャンペーンは、コンソールの「Host external campaign」か、CreateCampaignで
sourceを指定せずに作る。 - 各依頼の必須項目は
clientToken・expirationTime・channelSubtypeParameters。expirationTimeは現在時刻から15分以内にしないとInvalidInputで弾かれる(公式は未記載・第三者の実測)。 - HTTP 200でも
failedRequestsに失敗が入る。successfulRequestsは依頼を受け付けたという意味で、電話がつながったかどうかではない。 - 呼び出し上限は10回/秒(バースト10)で、アカウント×リージョン単位で共有される。キャンペーンの同時通話数のクォータは既定0。
- インスタンス単位の通信制限(1人あたりの送信回数の上限)は、このAPIで入れた依頼に効かなかったという検証報告がある(2025年8月)。公式も外部キャンペーンへの適用を書いていないため、同じ番号へ何度もかけないための制御は自前で持つ。
- 東京リージョンから発信できるのは日本の番号だけ。費用はキャンペーンの音声単価(Connect Customerで1分0.045ドル)に、日本国内への通話料1分0.078ドルが加わる。
PutOutboundRequestBatchの位置づけ:Outbound Campaigns V2の発信依頼API
アウトバウンドキャンペーンは、コンタクトセンターから顧客へ一斉に電話やメッセージを届けるAmazon Connectの機能です。2026年からAmazon Connectのコンタクトセンター製品は「Amazon Connect Customer」と呼ばれており、AWSの管理者ガイドも「Connect Customer outbound campaigns」と表記しています。キャンペーン側で発信モードや発信元番号、使うフローを決めておき、PutOutboundRequestBatchで「誰に」「いつまでに」を流し込む、という役割分担です。
AWS CLIでは aws connectcampaignsv2 put-outbound-request-batch、boto3では client("connectcampaignsv2").put_outbound_request_batch() として呼びます。IAMで許可するアクションは connect-campaigns:PutOutboundRequestBatch で、対象リソースはキャンペーンです。Amazon Connect自体の機能や料金体系はAmazon Connectの機能・料金と日本で使うときの注意点にまとめています。
V1のPutDialRequestBatchとの違い
V1(API版 2021-01-30)にも同じ役割のPutDialRequestBatchがあります。V2では電話以外のチャネルを扱えるよう、宛先の書き方がチャネル別の入れ子に変わりました。
| 項目 | V1 PutDialRequestBatch | V2 PutOutboundRequestBatch |
|---|---|---|
| サービス名(SDK) | connectcampaigns | connectcampaignsv2 |
| パス | /campaigns/{id}/dial-requests | /v2/campaigns/{id}/outbound-requests |
| 1回の件数 | 1〜25件 | 1〜25件 |
| 宛先の指定 | phoneNumber(電話のみ) | channelSubtypeParameters(4チャネル) |
| 失敗コード | 3種 | 4種(BufferLimitExceededを追加) |
旧来のキャンペーンにはAmazon Pinpointのジャーニーと組み合わせる構成がありましたが、Pinpointは2026年10月30日にサポートを終えています(影響範囲はAmazon Pinpointの終了と移行先の選び方を参照)。管理者ガイドもV2でのキャンペーン作成を推奨しており、これから作るならV2一択です。
PutProfileOutboundRequestBatchとの違い
V2には名前の似たPutProfileOutboundRequestBatchもあります。こちらは電話番号ではなくCustomer Profilesのプロファイル(32桁の16進ID)を1回20件まで受け取るAPIですが、APIリファレンスと管理者ガイドは、Customer Profilesのイベントトリガーだけが呼び出せるとしています。イベントトリガー型のキャンペーンが内部で呼ぶもので、CloudTrailのログに名前が出るだけです。自分のコードから宛先を入れるときに使うのはPutOutboundRequestBatchのほうです。
外部キャンペーンの作り方:Host external campaignとCreateCampaign
PutOutboundRequestBatchの送り先は、キャンペーン自身が宛先をセグメントやイベントから集めない「外部キャンペーン」です。セグメントを指定したキャンペーンは、開始時刻にセグメントから受信者を決めて動きます。
外部キャンペーンの有効化・番号・クォータの準備
- インスタンスでアウトバウンド発信とアウトバウンドキャンペーンを有効にする。有効化の際にAWS KMSキー(自前のキーかAWS所有キー)を指定し、後からキーを替えるには一度無効化が要る。
- キャンペーンで使うフローと発信元番号(インスタンスに属する番号)を用意する。発信者番号はインスタンスの番号に限られる。
- 日本の携帯番号(+8170・+8180・+8190)は既定で発信を許可されていない場合がある。かけられないときはクォータの引き上げを申請する(既定で発信できる国の一覧)。
- Service Quotasで「Concurrent campaign active calls per instance」(既定0)の引き上げを申請する。0のままだと依頼は受け付けられても相手にはファストビジー(話し中音)が流れる。
外部キャンペーンのコンソール・APIでの作成
管理者サイトのキャンペーン作成画面で「Host external campaign」を選ぶと、自前の宛先リストやキャンペーン管理ツールから依頼を入れる前提のキャンペーンになります。作成後に表示されるキャンペーンIDを、PutOutboundRequestBatchのパスの {id} に使います。
APIで作る場合は、CreateCampaignで source(Customer ProfilesのセグメントARNかイベントトリガー)を指定せずに作ります。source は任意項目で、省くとセグメントもイベントトリガーも持たないキャンペーンになります。必須は name と connectInstanceId だけで、電話を使うなら channelSubtypeConfig.telephony に発信モードと既定のフローを入れます。次の例は自動音声だけで完結するエージェントレスモードです。APIで作ったキャンペーンを管理画面でも表示・編集するには、インスタンスARNを owner タグに入れる必要があります(CreateCampaignのAPIリファレンス)。
import boto3
client = boto3.client("connectcampaignsv2", region_name="ap-northeast-1")
resp = client.create_campaign(
name="reminder-api",
connectInstanceId="<インスタンスID>",
# source を指定しない=宛先は PutOutboundRequestBatch で外から渡す
channelSubtypeConfig={
"telephony": {
"capacity": 1.0,
"outboundMode": {"agentless": {}}, # 自動音声だけで完結させる
"defaultOutboundConfig": {
"connectContactFlowId": "<フローID>",
"connectSourcePhoneNumber": "+81501234567",
},
}
},
# 管理画面でも表示・編集するにはインスタンスARNを owner タグに入れる
tags={"owner": "arn:aws:connect:ap-northeast-1:<アカウントID>:instance/<インスタンスID>"},
)
print(resp["id"])
発信モードは progressive・predictive・agentless・preview(2025年10月にSDKへ追加)の4つから1つを選びます。predictive には2026年7月末のSDK更新(botocore 1.43.62)で放棄率の目標値を決める pacingStrategies が加わりました。放棄は「接続の起点(システム接続・挨拶の開始・挨拶の終了のいずれか)から設定秒数以内に担当者へつながらなかったコンタクト」として数え、放棄率がしきい値に達するとダイヤラーが progressive に自動で切り替わります。発信元番号を指定しない場合はキューの指定が必要で、どちらも無いと発信者番号が決まりません。CreateCampaignのAPIリファレンスには「作成後に source を追加・削除できない」とあり、外部キャンペーンを後からセグメント型に変えることはできません。外から宛先を流し込む用途とセグメントで動かす用途は、キャンペーンを分けて作ります。
リクエストの構造:パス・必須項目・チャネル別パラメータ
パスの {id} にキャンペーンIDを入れ、ボディの outboundRequests 配列に依頼を並べます。boto3 1.43.125が実際に組み立てるリクエストは次の形です(送信直前のボディを取り出して確認)。
PUT /v2/campaigns/<キャンペーンID>/outbound-requests HTTP/1.1
Host: connect-campaigns.ap-northeast-1.amazonaws.com
Content-Type: application/json
Authorization: AWS4-HMAC-SHA256 Credential=...(SDKが署名を付与)
{
"outboundRequests": [
{
"clientToken": "run20261106-C001",
"expirationTime": "2026-11-06T00:10:00Z",
"channelSubtypeParameters": {
"telephony": {
"destinationPhoneNumber": "+819012345678",
"attributes": {"customerId": "C001"}
}
}
}
]
}
| 項目 | 必須 | 制約 |
|---|---|---|
| id(パス) | はい | キャンペーンID |
| outboundRequests | はい | 1〜25件 |
| clientToken | はい | 0〜200文字、英数字と _ – .(7日間有効) |
| expirationTime | はい | ISO 8601の日時(現在から15分以内) |
| channelSubtypeParameters | はい | telephony・sms・email・whatsAppのどれか1つ |
出典:PutOutboundRequestBatch・OutboundRequest(AWS API Reference)。clientTokenにコロンやスラッシュは使えません。boto3は文字種を送信前に検査しないため、違反はサーバー側のValidationException(HTTP 400)で初めて分かります。
電話(telephony)で指定する項目
必須は destinationPhoneNumber(E.164形式、例 +819012345678)と attributes の2つです。attributesはキーと値の組で、通常のコンタクト属性と同じようにフローの中から参照できます。顧客IDや案内の種類を入れておけば、同じフローで顧客ごとに案内文を変えたり、コンタクトレコードから後で突き合わせたりできます。キーに使えるのは英数字・ハイフン・アンダースコアだけです。
任意項目として、発信元番号 connectSourcePhoneNumber、留守番電話の検出設定 answerMachineDetectionConfig、呼び出し時間 ringTimeout(15〜60秒)を依頼ごとに上書きできます。
SMS・メール・WhatsAppで指定する項目
SMSとWhatsAppは destinationPhoneNumber と templateParameters、メールは destinationEmailAddress と templateParameters が必須です。templateParametersはメッセージテンプレートへの差し込み値で、テンプレート(templateArn)と送信元は任意項目です。1依頼に指定できるチャネルは1つなので、同じ顧客に電話とSMSの両方を送るなら、チャネルごとに別の依頼(別のclientToken)にします。
expirationTimeの決め方:形式と15分の実質上限
APIリファレンスの説明文はexpirationTimeを「UNIXタイムスタンプ」と書いていますが、サービス定義の形式はISO 8601です。boto3に datetime を渡すと、上の例のように 2026-11-06T00:10:00Z の形で送られます。CLIやHTTPを直接組み立てる場合も、UTCのこの形式で書くのが確実です。
期限の上限は公式資料に書かれていません。一方でクラスメソッドの検証では、現在時刻から20分後を指定した依頼が failedRequests に InvalidInput で返り、15分以内なら受け付けられています(Customer Profilesを利用せずアウトバウンドキャンペーンを実行する方法、2025年7月)。HTTPとしては200が返るため、例外処理だけ見ていると失敗に気づきません。
ここから決まる設計は2つです。1つは、翌日の朝に発信する分を前夜にまとめて登録する、という使い方ができないこと。発信したい時刻の直前に、その時刻に送る分だけを投入するスケジューラ(EventBridge Schedulerなど)が要ります。もう1つは、件数が多いと投入の途中で期限が迫ることです。次章の実装例では、期限を10分後に置き、残り1分を切ったら送らずに次の実行へ回しています。
レスポンスの判定:HTTP 200に含まれる依頼単位の失敗
このAPIは、25件のうち一部だけが受け付けられなかった場合もHTTP 200を返します。結果は依頼ごとに successfulRequests と failedRequests へ振り分けられ、どちらもclientTokenで元の依頼と対応づけます。
HTTP/1.1 200
Content-Type: application/json
{
"successfulRequests": [
{"clientToken": "run20261106-C001", "id": "EXAMPLE-REQUEST-ID-1"}
],
"failedRequests": [
{"clientToken": "run20261106-C002", "id": "EXAMPLE-REQUEST-ID-2", "failureCode": "InvalidInput"}
]
}
失敗した依頼の failureCode は4種類です。再送してよいかどうかで分けて扱います。
| failureCode | 主な原因 | 対応 |
|---|---|---|
| InvalidInput | 番号形式の誤り・期限が遠すぎる | データを直すまで再送しない |
| RequestThrottled | 依頼単位のスロットリング | 間隔を空けて再送 |
| BufferLimitExceeded | 受け付けバッファの上限超過 | 時間を空けて再送 |
| UnknownError | サービス側の不明なエラー | 回数を決めて再送 |
BufferLimitExceededはV2で追加されたコードですが、バッファの件数や解除条件は公式ドキュメントに記載がありません。再送回数に上限を設け、超えた分は記録して次回に回します。
もう1つの誤解が、successfulRequests に入れば電話がつながる、というものです。これは依頼を受け付けたという意味にすぎず、相手が話し中・電源オフ・存在しない番号でも成功側に入ります。通話の結果は、attributesに入れた顧客IDをキーに、コンタクトレコードやアウトバウンドキャンペーンのパフォーマンスダッシュボードで確かめます。
リクエスト全体が拒否されたときは、HTTPのステータスコードで例外が返ります。
| HTTP | 例外 | 典型的な原因 |
|---|---|---|
| 400 | ValidationException | 26件以上、型や文字種の違反 |
| 403 | AccessDeniedException | IAMポリシーにアクションが無い |
| 404 | ResourceNotFoundException | キャンペーンIDの誤り、別リージョン |
| 409 | InvalidCampaignStateException | キャンペーンが受け付けられない状態 |
| 409 | ConflictException | リソースの状態との競合 |
| 429 | ThrottlingException | 10回/秒の上限超過 |
| 500 | InternalServerException | サービス内部の障害 |
InvalidCampaignStateExceptionには、その時点のキャンペーン状態(Initialized・Running・Paused・Stopped・Failed・Completedのいずれか)が state として入ります。409が返ったら、この値とGetCampaignStateの結果で、停止中や完了済みのキャンペーンに送っていないかを確かめます。
上限とクォータ:25件・10回/秒・同時通話数
1回に送れるのは25件、呼び出しはRateLimit 10回/秒・BurstLimit 10回/秒です。単純計算で毎秒250件までは登録できますが、この上限は利用者やインスタンスではなくアカウント×リージョン単位で共有されます。同じアカウントで夜間バッチと業務アプリが同時に投入すると、片方がThrottlingExceptionを受けます。
| クォータ | 既定値 | 引き上げ |
|---|---|---|
| 1回の依頼件数 | 25件 | 不可(API仕様) |
| PutOutboundRequestBatchの呼び出し | 10回/秒(バースト10) | 記載なし |
| インスタンスあたりの稼働中キャンペーン | 50 | 可 |
| インスタンスあたりのキャンペーン総数 | 500 | 可 |
| キャンペーンの同時通話数 | 0 | 可 |
出典:Connect Customer service quotas(AWS公式)。最後の行の既定値0は、APIで依頼が受け付けられても電話がつながらない原因になります。検証を始める前に引き上げを申請します。
通信制限の適用範囲:同じ番号への重複発信の自前制御
アウトバウンドキャンペーンには、1人の受信者に送る回数を「1日○回・1週間○回」のように抑える通信制限があります(1日は現在時刻から遡る24時間)。キャンペーン単位の制限に加え、インスタンス全体のTotal Communication Limitsも設定でき、重要なキャンペーンだけ「Ignore total limits」で対象外にできます。ただし管理者ガイドはこの機能をセグメントを使うキャンペーンの作成手順の中で説明しており、外部キャンペーンへの適用には触れていません。
クラスメソッドの検証(PutOutboundRequestBatch APIを利用する場合、インスタンスレベルの通信制限は適用不可、2025年8月)では、PutOutboundRequestBatchで入れた依頼にインスタンス単位の通信制限を設定しても、同じ宛先へ連続して発信されました。キャンペーン単位の制限は検証されていませんが、公式に適用の記載がない以上、AWS側で回数を絞れない前提で投入前に自分で数えるのが安全です。
次の関数は、DynamoDBの条件付き更新で「その番号への当日(日本時間)の発信回数が上限未満なら1回分を確保する」ものです。条件に合わなければ ConditionalCheckFailedException になるので、Falseを返してその依頼を投入しません。同時に複数の処理が走っても、確保は1件ずつ原子的に行われます。この例は日本時間の暦日で数えるため、23時台と翌0時台の発信は別の日として通ります。公式の通信制限と同じ「直近24時間」で数えたい場合は、発信時刻のリストを持つなど移動窓の集計に変えます。
import time
from datetime import datetime, timedelta, timezone
import boto3
from botocore.exceptions import ClientError
ddb = boto3.client("dynamodb", region_name="ap-northeast-1")
JST = timezone(timedelta(hours=9))
def reserve(table, phone, max_per_day=1):
"""当日(日本時間)の発信回数が上限未満なら1回分を確保してTrueを返す"""
day = datetime.now(JST).strftime("%Y%m%d")
try:
ddb.update_item(
TableName=table,
Key={"pk": {"S": f"{phone}#{day}"}},
UpdateExpression="ADD cnt :one SET expires_at = :ttl",
ConditionExpression="attribute_not_exists(cnt) OR cnt < :max",
ExpressionAttributeValues={
":one": {"N": "1"},
":max": {"N": str(max_per_day)},
":ttl": {"N": str(int(time.time()) + 3 * 86400)}, # 3日後に期限切れ(TTLの実削除はその後数日以内)
},
)
return True
except ClientError as e:
if e.response["Error"]["Code"] == "ConditionalCheckFailedException":
return False
raise
テーブルはパーティションキー pk(文字列)だけで作り、expires_at をTTL属性に指定します。確保したのにPutOutboundRequestBatchが InvalidInput を返した依頼は実際には発信されないため、件数を戻すかどうかを運用で決めておきます。
boto3の実装例:25件単位の分割・再送と期限の管理
次のコードは、発信対象の一覧を25件ずつに分けて登録し、再送してよい失敗だけを間隔を空けて送り直します。SDK自体のリトライ(ThrottlingExceptionなどの例外)は retries の設定に任せ、HTTP 200の中に入ってくる依頼ごとの失敗はコード側で拾う分担です。boto3のリトライ設定の詳細はboto3のclientとリトライ設定の解説にあります。
import time
from datetime import datetime, timedelta, timezone
import boto3
from botocore.config import Config
client = boto3.client(
"connectcampaignsv2",
region_name="ap-northeast-1",
config=Config(retries={"mode": "standard", "max_attempts": 5}),
)
RETRYABLE = {"RequestThrottled", "BufferLimitExceeded", "UnknownError"}
TTL = timedelta(minutes=10) # 現在時刻から15分を超える期限は InvalidInput になる報告がある
MARGIN = timedelta(seconds=60) # 期限が近い依頼は送らずに次回へ回す
def build_request(row, run_id, expires):
return {
# 再送しても同じ値になるよう、実行IDと顧客IDから組み立てる
"clientToken": f"{run_id}-{row['customer_id']}",
"expirationTime": expires,
"channelSubtypeParameters": {
"telephony": {
"destinationPhoneNumber": row["phone"], # E.164形式(+81...)
"attributes": {"customerId": row["customer_id"]},
}
},
}
def put_all(campaign_id, rows, run_id, max_rounds=3, now=lambda: datetime.now(timezone.utc)):
expires = now() + TTL
pending = [build_request(r, run_id, expires) for r in rows]
accepted, rejected = {}, []
for round_no in range(max_rounds):
retry = []
for i in range(0, len(pending), 25): # 1回の上限は25件
chunk = pending[i:i + 25]
if now() > expires - MARGIN: # 期限切れ間近なら送らない
rejected += [(r["clientToken"], "NotSent") for r in retry + pending[i:]]
return accepted, rejected
by_token = {r["clientToken"]: r for r in chunk}
resp = client.put_outbound_request_batch(id=campaign_id, outboundRequests=chunk)
for ok in resp.get("successfulRequests", []):
accepted[ok["clientToken"]] = ok["id"]
for ng in resp.get("failedRequests", []):
req = by_token[ng["clientToken"]]
if ng["failureCode"] in RETRYABLE:
retry.append(req)
else: # InvalidInput は直さない限り何度送っても通らない
rejected.append((ng["clientToken"], ng["failureCode"]))
time.sleep(0.1) # RateLimit 10回/秒に合わせる
if not retry:
break
pending = retry
time.sleep(2 ** round_no)
else:
rejected += [(r["clientToken"], "RetryExhausted") for r in pending]
return accepted, rejected
要になるのはclientTokenの作り方です。clientTokenは作成から7日間有効で、同じ値で再送されると新しい依頼を作らず既存の依頼IDを返します。uuid.uuid4() のように送るたびに新しい値を振ると、タイムアウト後の再送が別の依頼として扱われ、同じ顧客に2回電話がかかります。上の例は、実行IDと顧客IDが許可文字だけで構成され、連結後が200文字以内で、同一実行内の顧客IDに重複がないことを前提にしています。同じ顧客に案内を複数送る場合は、案内や取引のIDもトークンに含めます(IDの設計はUUIDの構造と使い分けの解説も参考になります)。
このコードはPython 3.15.0・boto3 1.43.125のbotocore Stubberで応答を差し替えて確かめました。30件を渡すと25件と5件の2回に分かれ、RequestThrottledの1件だけが次の周回で再送され、InvalidInputの1件は再送されずに残ります。時計を9分30秒進めた状態では、2回目の5件を送らずに NotSent として返し、同じ周回で再送待ちになった依頼も取りこぼさずに返ります。実サービスでの受理・発信は検証していません。本番では受理結果をバッチごとに保存します。例外で処理が中断して結果の分からない依頼が残ったら、元の実行ID(同じclientToken)のまま送り直します。受理済みの依頼なら既存のIDが返るだけで、二重には発信されません。
AWS CLIによる1件の登録テスト
CLIで1件登録し、権限とキャンペーンの状態を確かめます。期限は実行時点から数分後のUTCにします。次の例はmacOSの date の書き方で、Linuxでは date -u -d '+10 minutes' +%Y-%m-%dT%H:%M:%SZ に置き換えます。
EXPIRES=$(date -u -v+10M +%Y-%m-%dT%H:%M:%SZ) # 10分後(macOS)
aws connectcampaignsv2 put-outbound-request-batch \
--region ap-northeast-1 \
--id "$CAMPAIGN_ID" \
--outbound-requests '[{
"clientToken": "test-20261106-C001",
"expirationTime": "'"$EXPIRES"'",
"channelSubtypeParameters": {
"telephony": {
"destinationPhoneNumber": "+819012345678",
"attributes": {"customerId": "C001"}
}
}
}]'
応答の successfulRequests にIDが返れば登録は成功です。電話がかかってこない場合は、APIではなく同時通話数のクォータ、発信元番号、キャンペーンのフローの順に確かめます。
料金:発信キャンペーンの音声単価と東京の通話料
アウトバウンドキャンペーンの費用は、チャネルごとのキャンペーン単価に、電話回線の通話料が加わる構成です。Amazon Connect Customerの料金表では、キャンペーンの音声は通常の音声単価(Connect Customerで1分0.038ドル)の代わりに次の単価がかかります。日本国内への通話料は、AWSのPrice List APIで取得した東京リージョン(ap-northeast-1、2026年9月15日公開)の値です。
| 項目 | Connect Customer | Customer Basic |
|---|---|---|
| キャンペーンの音声(1分) | 0.045ドル | 0.025ドル |
| 発信の試行(1件) | 単価に含む | 0.005ドル |
| SMS・WhatsApp(1通) | 0.005ドル | 0.005ドル |
| 日本国内への通話料(1分) | 0.078ドル | 0.078ドル |
Connect CustomerはAI機能込みの標準プラン、Customer Basicは機能別課金のプランです。音声はAmazon Connectが発信を始めた時点から秒単位で課金され、最低10秒分かかるため、相手が出なかった発信も無料にはなりません。たとえば課金対象の時間(発信開始から終話まで)を1件1分と仮定して1,000件かけると、Connect Customerは45ドル+78ドルで123ドル、Customer Basicは25ドル+5ドル+78ドルで108ドルです。通話料が6割以上を占めるため、プランを選ぶ前に、留守番電話の検出などで通話時間をどれだけ削れるかを実測し、プランの差(この試算では15ドル)と比べます。メールのキャンペーン単価は1通0.002ドルです。SMS・WhatsAppとメールの配信料は、キャンペーン単価とは別にAmazon End User MessagingとAmazon SESで課金されます。
導入前に確認する前提:リージョンと発信できる番号
アウトバウンドキャンペーンのエンドポイントは、米国東部(バージニア北部)・米国西部(オレゴン)・アフリカ(ケープタウン)・ソウル・シンガポール・シドニー・東京・カナダ(中部)・フランクフルト・ロンドンの10リージョンと、API専用のAWS GovCloud(US-West)です。発信できる番号はインスタンスを作ったリージョンで決まり、東京リージョンのインスタンスから発信できるのは日本の番号だけです(Outbound Campaigns availability by Region)。海外の顧客へもかけるなら、その国に対応するリージョンに別のインスタンスを用意します。
フリーダイヤル番号は国際発信に使えず、UIFN番号は発信そのものができません。発信元には、インスタンスに属する通常の番号を割り当てます。担当者が受ける通話の前に流れる案内を変えたい場合は、Amazon Connectのアウトバウンドウィスパーフローの解説で設定方法を説明しています。
PutOutboundRequestBatchの不採用条件と代替手段
このAPIは「宛先リストを自分で持ち、発信したい時刻の直前に流し込む」ための道具です。次の要件なら別の仕組みのほうが軽く済みます。
- 数日先の予定を組みたい、繰り返し同じ顧客群に送りたい:Customer Profilesのセグメントを指定したキャンペーンにすれば、開始日時と有効期限をキャンペーン側で決められ、通信制限も効く。
- 「申込みが途中で止まった」などのイベントに即時反応したい:イベントトリガー型キャンペーンを使う。内部で呼ばれるのはPutProfileOutboundRequestBatchで、自分で呼ぶ必要はない。
- 1件ずつ単発で発信するだけ:Amazon Connect本体のStartOutboundVoiceContactで足りる。ただし
TrafficType=CAMPAIGNで発信するには、キャンペーン用クォータの引き上げ申請が先に要る(APIリファレンスに「既定では許可されない」とある)。 - 毎秒250件を超える投入が常に必要:同一アカウント・リージョンの公表レートでは追いつかない。キューは一時的な集中の吸収に使い(Amazon SQSのキュー設計の解説)、恒常的な超過は投入量か通話時間を見直す。
逆に、基幹システムの請求データから督促の対象を日次で抽出する、予約システムから前日のリマインドを送る、といった「リストの正本がAmazon Connectの外にある」案件は、このAPIの守備範囲です。CRMや基幹システムとの連携部分を含めて設計するなら、API開発・システム連携の支援でも相談を受け付けています。
よくある質問
PutOutboundRequestBatchの認証方法は?
AWSの署名バージョン4(SigV4)です。APIキーやBearerトークンでは呼べません。boto3やAWS CLIなら署名は自動で付くので、呼び出し元のIAMロールに connect-campaigns:PutOutboundRequestBatch を許可します。
1回に何件まで送れますか?
1回25件までです。26件以上を渡すとValidationException(HTTP 400)になります。大量のリストは25件ずつに分け、呼び出しを10回/秒以内に抑えます。
expirationTimeに翌日の日時を指定できますか?
公式資料に上限の記載はありませんが、現在時刻から20分後でInvalidInputになった検証結果があり、15分以内に収めるのが安全です。先の日時に発信したい場合は、その時刻にスケジューラから投入するか、セグメント型のキャンペーンを使います。
HTTP 200なのに発信されないのはなぜですか?
200でも failedRequests に入った依頼は受け付けられていません。まずfailureCodeを確認します。すべて成功しているのに電話がかからない場合は、キャンペーンの同時通話数クォータが既定の0のままになっていないかを確かめます。
同じ依頼を再送すると二重に発信されますか?
同じclientTokenで7日以内に再送した場合は、新しい依頼は作られず既存の依頼IDが返ります。再送では元のclientTokenを使い、別の発信依頼には異なる値を割り当てます。一方、別のclientTokenで同じ番号に送った依頼は別の依頼として扱われ、インスタンス単位の通信制限でも止まらなかった検証報告があるため、回数の上限は自前で管理します。