TwilioによるSMS
SMS ChannelはTwilio Messagingを使用します。受信メッセージと配信コールバックはWebhookで届き、送信メッセージにはTwilioのREST APIを使います。
必要なもの
- Twilio Account SID（
ACに続く32桁の16進文字）。 - E.164形式のSMS対応
from_number。 - API Key SID（
SKに続く32桁の16進文字）。 - 送信REST呼び出し用のAPI Key Secret。
- Twilio Webhookの署名検証用のAuth Token。
- 公開HTTPSコールバックURL。
最新の電話番号とWebhook設定については、Twilio Messagingドキュメントを参照してください。
Dashboardで接続する
- Dashboard → Channel → Addを開きます。
- **SMS (Twilio)**を選びます。
- Account SID、From番号、API Key SID、Status callback URLを入力します。
- API Key SecretとAuth Tokenを追加します。
- 認証情報を保存し、CLIウィザードでポリシーを確認して、Twilio番号の受信Webhookを設定します。
メッセージングプラットフォームに従って、Anyyの共通WebhookリスナーとHTTPSプロキシを有効にします。コールバックURLはHTTPSで、末尾をアカウントのルートにする必要があります。
https://YOUR_HOST/channels/sms/ACCOUNT_ID/webhook
既定のアカウントIDはtwilioです。受信メッセージと設定する状態コールバックには同じルートを使用します。
アクセスポリシー
SMSの既定値はopenで、open、allowlist、disabledに対応します。対話型のanyy setup channelウィザードでSMSを選んで変更します。Dashboardの認証情報フォームには表示されず、現在の設定アクションではSMSのリスト項目を編集できません。ペアリングは利用できず、allowlistを選ぶだけでは許可された番号は追加されません。
電話番号は+14155550123のようなE.164形式に正規化してください。
同一ホストのプロキシでHTTPSを終端する場合は、正確なX-Forwarded-Proto: httpsとX-Forwarded-Hostを付け、ループバックから転送します。このアダプターは、ループバック以外の接続からの転送URLヘッダーを信頼しません。署名検証のために元の公開URLとフォーム本文を保持してください。
配信確認
Twilioは配信の進行状況をコールバックURLに報告できます。Anyyの送信成功で最初に確認できるのはプロバイダーへの送出です。状態が不明なメッセージを再試行する前に、後続の受領通知／状態を確認します。
受信、送信、通信事業者、国際メッセージの料金は、Twilioアカウントと送信先によって異なります。アクセスを制限し、自動化を有効にする前に既知の番号でテストしてください。
接続を検証する
anyy channel doctor sms
anyy channel reload
受信SMSを1件送り、送信者ポリシーを確認した後、返信と配信状態をテストします。
トラブルシューティング
| 問題 | 確認する項目 |
|---|---|
| TwilioがコールバックURLを拒否する | 正確なHTTPSの/channels/sms/ACCOUNT_ID/webhookパス |
| Webhookの署名検証に失敗する | Auth Tokenと、プロキシが元のURL／本文を保持しているか |
| 送信APIが失敗する | Account SID、API Key SID/Secret、From番号の機能 |
| 送信者が無視される | DMポリシーとE.164形式の許可リスト値 |
| 状態が進まない | Status callback URLとTwilioの配信コールバック設定 |