WhatsApp Webhook の料金オブジェクト:type、category、billable(2026 年)
料金オブジェクトは ステータス Webhook に含まれ、Meta がそのメッセージをどう分類したかを示します。billable(廃止予定)、pricing_model の PMP、type(regular、free_customer_service、free_entry_point、free_group_customer_service のいずれか)、category(marketing、utility、authentication、service など)、そして任意の subtype である paid_exempt です。2026 年 10 月 1 日以降は、サービスメッセージを含め、課金対象のすべてのメッセージに regular が付与されます。
easyCoexistence は、お使いの WhatsApp Business アプリの番号を、Coexistence によって Meta の Cloud API に接続し、この料金オブジェクトを含むステータス Webhook をお使いのサーバーに渡します。
現在の Webhook の pricing_model は PMP(メッセージごとの従量課金)です。CBP が現れるのは 2025 年 7 月 1 日より前に送信された Webhook のみです。
2026 年 10 月 1 日以降、Meta の無料枠では、ビジネス電話番号 1 件につき月間に配信されたサービスメッセージが無料です。
無料枠を使い切った後に配信されたサービスメッセージを含む、課金対象メッセージの type。
組織が対象の政府機関または非営利団体であるため無料となるサービスメッセージに付与される subtype。
Webhook には階層の詳細が含まれます。ボリューム階層の情報は、Meta が案内する pricing_analytics フィールドで確認できます。
料金オブジェクトはどこに現れますか?
料金オブジェクトは、ステータス Webhook の一部にだけ含まれます。Meta は sent のステータスと、delivered または read のいずれかに含めます。ただし v24.0 のリファレンスの例では、sent には含まれず、代わりに delivered の Webhook で届いています。failed のステータスには一切含まれません。そのため、料金はメッセージの属性として wamid で管理し、どのステータスで届いたかにかかわらず、一度だけ記録してください。サービスメッセージについて、Meta 自身が示す料金オブジェクトの例を、番号の月間無料枠が切れる前と後に分けて示します:
// Service message delivered while the number is within its free tier
"pricing": {
"billable": false,
"pricing_model": "PMP",
"type": "free_customer_service",
"category": "service"
}
// Service message delivered after the number's free tier has been used
"pricing": {
"billable": true,
"pricing_model": "PMP",
"type": "regular",
"category": "service"
}2026 年 10 月 1 日以降、type の値は何を意味しますか?
type は、Meta が課金するかどうかを示すフィールドです。その意味は 2026 年 10 月 1 日に変わりました。この日から Meta は、サービスメッセージと、顧客への返信として送られたユーティリティテンプレートに対しても、メッセージごとの課金を始めました。その日付より前のコードは、free_customer_service を、カスタマーサービスウィンドウが開いている間の返信として読んでいることがあります。現在この値は、番号の月間無料枠内での 1 対 1 のサービスメッセージを意味します。billable は引き続き現れますが、Meta は廃止予定としており、type と category を組み合わせて読むよう求めています。
| Through 30 Sep 2026 | From 1 Oct 2026 | |
|---|---|---|
| regular | A billable message | Billable, now including utility replies to customers and service messages past the number's monthly tier |
| free_customer_service | A utility template or non-template message sent in an open window | A one-to-one service message within the number's monthly tier |
| free_group_customer_service | Group utility or non-template message in an open group window | A group service message within the number's monthly tier |
| free_entry_point | Sent in an open free entry point window | Unchanged |
メッセージはどのカテゴリーを持てますか?
category は、Meta が課金する際に適用した料金区分を示します。Meta の請求書と照合する際は、これでグループ化してください。料金は市場ごとに異なるため、顧客の番号の国と組み合わせます。1 件のメッセージは 1 つの category を持ち、課金は 1 回だけです。テンプレート以外のメッセージに販促内容が含まれていても、それはサービスメッセージのままで、追加のマーケティング課金は発生しません。Meta が挙げる値は次のとおりです:
Webhook から課金を数えるにはどうすればよいですか?
Webhook からわかるのは、どのメッセージが課金対象で、どのカテゴリーかです。金額はわかりません。Meta の請求と一致する利用状況を作るには、メッセージ単位とカテゴリー単位で数え、市場ごとに Meta が公表する料金を適用してください。または、Meta の pricing_analytics フィールドを読むこともできます。メッセージごとの内訳と階層が示されます。
- 料金情報は複数のステータスで届くことがあり、再送で Webhook も繰り返されるため、wamid で重複を除いてください。
- type が regular のメッセージを課金対象として数え、カテゴリーと受信者の国でグループ化してください。
- 失敗したメッセージは無視してください。Meta が課金するのは配信済みのメッセージだけです。
- v24.0 以降は、無料エントリーポイントの期間内を除き、conversation オブジェクトは現れないと想定してください。その期間内では、ID は期間ごとに一意です。
Coexistence 番号の AI 返信には、どんな意味がありますか?
API 経由で AI や自動化が送信する返信はすべて、テンプレート以外のメッセージです。そのため、カテゴリーは service になります。番号の月間無料枠内では free_customer_service と表示され、その後は regular になります。send_template で AI が送るテンプレートは、それぞれ独自の category を持ちます。費用に関わる違いが 1 つあります。WhatsApp Business アプリでオーナーが入力したメッセージは、カスタマーサービスウィンドウの制約を受けず、Cloud API の料金に影響しないと、Meta の Coexistence ガイドに書かれています。
Meta は、メッセージを業務用の WhatsApp Business Account に対して、メッセージごと、カテゴリーと国別に請求します。easyCoexistence は、これらの料金に一切上乗せしません。AI の利用料金は、ご利用の AI プロバイダーが、お客様ご自身のキーを使って請求します。
よくある間違い
- 料金オブジェクトが現れるたびに数えてしまうこと。同じメッセージが複数のステータスで届くことがあるため、数えるのは wamid ごとに 1 回です。
- billable だけを読むこと。Meta は廃止予定としており、type と category を組み合わせて使うよう求めています。
- 2026 年 10 月より前の解釈のまま free_customer_service を扱うこと。2026 年 10 月 1 日以降、この値は番号の月間無料枠内のサービスメッセージを示します。
- ペイロードに金額が含まれると期待すること。料金オブジェクトはカテゴリーを示すだけで、料金は Meta の料金表または pricing_analytics から取得します。
これにより、お客様ご自身のシステムで利用量を集計できます。Meta の料金は、ご自身の WhatsApp Business Account に残り、一切上乗せされません。接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
どのアカウントがメッセージの料金を支払いますか?
そのメッセージを送信した WhatsApp Business Account です。1 つの番号から複数のアカウントが送信する場合、Meta は各料金を、そのメッセージを送ったアカウントに割り当てます。そのアカウントは、独自の支払い方法と支出上限を持ちます。
marketing_lite とは何ですか?
Meta の WhatsApp 向け Marketing Messages API で送信されるメッセージの、カテゴリーと料金の種類です。マーケティングテンプレートのための別の送信経路で、配信ごとの最大料金など、独自の料金オプションがあります。
メッセージ単位の料金は、いつ会話単位の料金に代わりましたか?
2025 年 7 月 1 日です。その日付より前に送信された Webhook には、pricing_model として会話単位の料金を示す CBP が現れることがあります。それ以降の Webhook には PMP が現れます。まだ会話 ID で料金を集計しているコードは、更新が必要です。
無料枠は毎月リセットされますか?
はい。Meta は各ビジネス電話番号に、毎月 1,000 件の配信済みサービスメッセージを無料で提供します。繰り越しはなく、WhatsApp Business Account のタイムゾーンにおける午前 0 時にリセットされます。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日