WhatsApp／SMS Business Messaging × Agent

CANDIDATE_ID: ORPHAN-RESCUE-EA229-20261019-C1

企業がAIエージェントからWhatsAppやSMSを送る場合、LLMが文章を生成できることと、メッセージ送信が業務上成立することは別問題である。実運用では、チャネルごとの送信資格、会話ウィンドウやテンプレート制約、同意・オプトアウト、宛先と顧客IDの対応、重複送信防止、配送状態の非同期追跡、失敗時の再試行と照合、監査ログを、エージェントの推論から分離した制御面として持つ必要がある。エージェントには「送信を決める」権限と「任意の宛先へ自由に送る」能力を同一視させない。

Twilio Programmable Messagingでは、APIがメッセージを受理した時点の状態と、その後のsent / delivered / undelivered / read等の状態は区別される。WhatsAppやRCSではread receiptが利用できる場合があるが、readは端末側設定やチャネル対応に依存する。したがって、API呼び出し成功を「相手に届いた」「相手が読んだ」と扱ってはならない。送信時にMessage SID等のprovider-side identifierを保存し、status callbackと後続照合を使って状態を追跡する設計が必要である。

WhatsAppでは、直近の利用者メッセージから24時間のcustomer service window内ではfree-form messageを送れる一方、window外のbusiness-initiated messageには承認済みtemplateが必要になる。Twilioの現行エラー文書では、2025-04-01以降、window外でtemplateをBodyとして送る方式ではなくContentSid/ContentVariablesを使う必要があると明記されている。したがってエージェントは、自然言語生成結果をそのまま任意時点でWhatsAppへ送るのではなく、conversation window判定とtemplate eligibilityを送信前policyとして適用すべきである。

status callbackは非同期Webhookであり、ネットワーク条件によって到着順が送信順と一致する保証がない。callbackのparameter setもchannel/eventにより異なり、追加され得る。よって状態機械はcallback arrival orderだけに依存せず、Message SIDを主キーに、状態遷移の単調性・timestamp・provider fetchによるreconciliationを考慮する必要がある。Twilio自身も、一定時間statusが更新されない場合のpollingと、少なくとも日次のreconciliationを推奨している。

• 送信前に、tenant、sender、recipient、channel、consent/opt-out、conversation window、template eligibility、目的・分類、送信上限をpolicy engineで判定する。LLM出力だけで送信可否を決めない。
• send intentに内部idempotency keyまたは業務操作IDを割り当て、provider Message SIDと対応付ける。timeoutや曖昧応答時に「失敗したはず」と推測して即時再送せず、provider-side recordを照合してから再試行する。
• accepted/queued/sent/delivered/read/failed/undeliveredを別状態として保持し、業務フローが要求する到達条件を明示する。例えば「API accepted」を顧客通知完了の証拠にしない。
• callback endpointではTwilio署名検証をSDK等の推奨手段で行い、未知parameterを拒絶する硬直schemaではなく、既知必須項目を検証しつつ拡張に耐える実装とする。
• callback欠落や順序逆転を前提に、polling/reconciliation jobを持つ。監査ログには内部send intent、provider SID、宛先の安全な参照、template/content version、policy decision、各status event、error code、reconciliation結果を残す。
• opt-outや配信停止、宛先誤り、番号再割当て、地域・契約・carrier/provider制約はLLMでは解決できないため、送信基盤側のhard gateとして扱う。

API 2xx/Message SID取得後でもdeliveryは失敗し得る。status callbackは欠落・遅延・順序逆転し得るため、callback単独を完全な監査台帳とみなせない。WhatsAppでは24時間window外のfree-form送信が拒否され、template/content typeにもbusiness-initiated messageとして利用できないものがある。read receiptは利用者設定やchannel capabilityに依存し、「readが来ない」ことから未読を断定できない。SMSのdeliveredも最終的な人間の閲覧・理解を保証しない。provider statusは配送経路の観測であり、業務成果そのものではない。

本candidateはTwilio Programmable Messagingを主要な実装例としてWhatsApp/SMS agent messagingの運用境界を整理する。Meta WhatsApp Business Platform直結、他SMS aggregator、各国の通信・広告規制、個別carrier DLR semantics、特定tenantの契約・料金・sender registration状態を一律に保証するものではない。provider/channel/region/account planごとの差分は導入時に再確認する。

read statusが存在するチャネルでも、利用者側のread receipts設定等に依存するため、readイベントは完全な閲覧証明ではない。status callbackは有用だが、Twilio自身が未着時のpollingと定期reconciliationを推奨しており、Webhookだけで完全性を保証する設計は不適切である。WhatsAppの24時間windowとtemplate要件は現行Twilio仕様として確認できるが、Meta側ポリシーやTwilio製品仕様は変更され得るため、固定不変の一般則としてコードへ焼き込まない。

特定企業・国・番号種別で必要となる法的同意要件、sender registration、quiet hours、carrier filtering、料金、throughput、retentionは本candidateでは確定しない。Meta直結APIとTwilio経由の全状態遷移差分、全地域のDLR品質、read receiptの実利用率、特定tenantでのretry/dedup挙動も未検証である。これらは導入対象provider/account/regionの契約・仕様・実測で確認する必要がある。

「エージェントはWhatsApp/SMS送信を実行できるが、送信APIの成功は配送・閲覧・業務成果を保証しない。会話window、template eligibility、同意・停止、重複防止、provider-side identifier、非同期status、reconciliationを独立した制御として実装し、チャネル・契約・地域固有の条件を実環境で確認する。」

• Canonical EA identity: Enterprise AI運用辞典_発展拡張_統合管理台帳_EA001-1004 / EA_MASTER / EA-229; exact topic「WhatsApp／SMS Business Messaging × Agent」.
• Existing revision evidence: EA_REVISION_LEDGER / EA-229-FIRST-20261005; Twilio WhatsApp API/session/status/duplicate/undelivered evidence; independent research audit PASS recorded 2026-10-11, with live-send/Meta-direct/exactly-once limitations retained.
• Twilio, “Overview of the WhatsApp Business Platform with Twilio” — https://www.twilio.com/docs/whatsapp/api — 24-hour customer service window and approved-template boundary. Accessed 2026-10-18.
• Twilio, “63016: Outside messaging window. For WhatsApp, use a Message Template instead” — https://www.twilio.com/docs/api/errors/63016 — out-of-session template requirement and ContentSid/ContentVariables behavior. Accessed 2026-10-18.
• Twilio, “Outbound Message Status in Status Callbacks” — https://www.twilio.com/docs/messaging/guides/outbound-message-status-in-status-callbacks — accepted/queued/sent/delivered/undelivered/read state distinctions. Accessed 2026-10-18.
• Twilio, “Track the Message Status of Outbound Messages” — https://www.twilio.com/docs/messaging/guides/track-outbound-message-status — callback variability, signature-validation guidance, out-of-order warning. Accessed 2026-10-18.
• Twilio, “Best Practices for Messaging Delivery Status Logging” — https://www.twilio.com/docs/messaging/guides/outbound-message-logging — persist SID/status, poll stale states, daily reconciliation. Accessed 2026-10-18.

AUDIT_HANDOFF: Review this exact saved candidate against EA-229 canonical topic and the cited provenance. Do not treat READY/AUDIT_PASS/GIT_INTEGRATED/ACCEPTED as producer assertions.