WhatsApp で認証コード(OTP)を送信する
WhatsApp で認証コード(OTP)を送信するには、企業が認証テンプレートを作成します。その認証テンプレートは、Meta が定めた固定形式「<code> is your verification code.」に、コピーボタンまたはワンタップボタンを付けたものです。企業のバックエンドは Cloud API を通じて、本文とボタンの両方にコードを入れて送信します。コードは最大 15 文字で、任意の有効期限の案内は 1 分から 90 分の範囲で設定できます。
easyCoexistence は、WhatsApp Business の番号を Coexistence 経由で Meta の Cloud API に接続し、バックエンドが認証テンプレートを送るために必要なものを提供します。
認証テンプレートが受け付ける最長のパラメータ。本文またはパラメータには、URL、メディア、絵文字を使えません。
code_expiration_minutes の範囲。メッセージに「This code expires in N minutes.」の行を追加します。
認証テンプレートの既定の有効期間(TTL)。30 秒から 15 分の範囲で設定できます。
認証テンプレートを電話番号ではなく、企業スコープのユーザー ID に送信したときに返されるエラー。
認証メッセージは、ユーザーのメインの WhatsApp デバイスにのみ配信されます。リンクされたデバイスには、代わりに案内が表示されます。
Coexistence 番号の固定スループット。ログインコードが一斉に送られる際の上限です。
WhatsApp の認証テンプレートとは何ですか?
Meta が認める唯一のワンタイムパスワードと認証コードの形式です。アプリがコードを WhatsApp で提供する場合は、この形式を使う必要があります。ユーティリティテンプレートやマーケティングテンプレートにパスコードを含めることはできません。本文は固定で、「<code> is your verification code.」です。任意で、「For your security, do not share this code.」と「This code expires in <N> minutes.」の 2 行を追加できます。選ぶのはボタンです。WhatsApp はこのメッセージの転送を無効にします。iOS 26 以降では、コードがキーボードの候補にも表示されます。これは追加の作業なしで行われます。
認証テンプレートはどのように作成しますか?
WhatsApp Manager のテンプレートライブラリから選ぶか、API から送信します。API の場合は、AI が create_template と category AUTHENTICATION を使って作成できます。本文は送信しません。Meta が設定内容から、選んだ言語で本文を作成し、作成時に OTP ボタンを URL ボタンに変換します。テンプレートは言語ごとに 1 つです。コネクタの create_template は message_send_ttl_seconds を渡さないため、Meta の API で変更しない限り、既定の 10 分の有効期間が適用されます。
{
"connection_id": "<from list_numbers>",
"name": "login_code",
"language": "en_US",
"category": "AUTHENTICATION",
"components": [
{ "type": "BODY", "add_security_recommendation": true },
{ "type": "FOOTER", "code_expiration_minutes": 5 },
{ "type": "BUTTONS", "buttons": [
{ "type": "OTP", "otp_type": "COPY_CODE", "text": "Copy code" }
]}
]
}バックエンドはどのようにコードを送信しますか?
コードごとに、番号の /messages エンドポイントへリクエストを 1 回送ります。アクセストークンは get_api_credentials か、ダッシュボードの「Plug in your own system」カードから取得します。同じコードを本文パラメータと、インデックス 0 の URL ボタンパラメータの両方に入れ、受信者は電話番号である必要があります。送信前に、バックエンドはコードを生成し、そのハッシュを有効期限と試行回数のカウンターとともに保存します。その後、ユーザーが入力した値をそのハッシュと照合します。
POST https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages
Authorization: Bearer <ACCESS_TOKEN>
{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "template",
"template": {
"name": "login_code",
"language": { "code": "en_US" },
"components": [
{ "type": "body",
"parameters": [{ "type": "text", "text": "482913" }] },
{ "type": "button", "sub_type": "url", "index": "0",
"parameters": [{ "type": "text", "text": "482913" }] }
]
}
}なぜコードはオートメーションではなく、バックエンドから送るのですか?
ユーザーをログインさせるシステムが、コードを作成し、保持し、照合する必要があるからです。コードが必要になるタイミングを知っているのも、そのシステムだけです。オートメーションは、お客様が送ってきたメッセージに応答するものです。ログイン画面が番号に書き込むことはありません。テンプレート自体もオートメーションを除外します。OTP ボタンはコードをボタン変数として持ち、「テンプレートを送信」ステップは本文変数しか埋めないため、認証テンプレートは送れません。AI は send_template で送ることができます。これはボタンコンポーネントを Meta に渡せますが、用途はテストであり、ログインフローではありません。
WhatsApp OTP フローを安全にするものは何ですか?
Meta のベストプラクティスとフォーマットの制限は、同じチェックリストを示しています。必要なのは、バックエンドと Cloud API だけです:
- 最初のコードを送る前に、ユーザーの WhatsApp 番号を確認し、コードは WhatsApp に届くと伝えてください。
- 有効期間は、コードの有効期限以下に設定してください。遅れて届いたときに、無効なコードが表示されないようにするためです。
- 番号ごとに試行回数と再送信の回数を制限し、コードは最初の使用で期限切れにしてください。
- WhatsApp のコードを、アカウント復旧の唯一の認証要素にしないでください。再利用された電話番号では、古い WhatsApp アカウントに届く可能性があります。
- ステータスの Webhook を監視し、コードの配信に失敗したら SMS またはメールを提案してください。
番号が WhatsApp Business アプリでも使われている場合、何が変わりますか?
送信は、どの Cloud API 番号とも同じように機能し、1 秒あたり最大 20 件のメッセージを送信できます。Meta は API 経由で送信したメッセージをアプリのチャットにも反映します。そのため、Coexistence 番号では、送信したコードが業務用の端末のチャットにも表示されます。その端末は信頼できる人と一緒に管理するか、別の番号からコードを送信してください。Meta のベストプラクティスでは、各企業が認証テンプレートを自社の番号から送るよう求めており、企業間で番号を共有することはありません。認証は有料のテンプレートカテゴリで、受信者の国ごとに配信済みメッセージ単位で課金されます。一部の市場では、authentication-international の別料金が適用されます。easyCoexistence による上乗せはありません。
設定方法
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow, or use a separate number reserved for codes.
- Create the authentication templateAsk your AI to submit login_code with create_template, category AUTHENTICATION, a copy-code button and an expiry, then check get_template_status for APPROVED.
- Store the credentials on your serverCall get_api_credentials or open "Plug in your own system" in the dashboard, and put the Send endpoint and access token in your backend's secrets.
- Build generate, send and verifyGenerate the code, store its hash with an expiry, send the template with the code in the body and button, then check the user's entry against the hash.
- Handle failuresRead failed statuses from the number's webhook, then offer SMS or email and show the user which number the code went to.
よくある間違い
- ユーティリティテンプレートやマーケティングテンプレート(例:「Your code is {{1}}」)にコードを入れること。Meta はパスコードを認証テンプレートでのみ許可し、ユーティリティやマーケティングのテンプレートにパスコードが含まれていると却下します。
- コードを本文だけに入れること。コピーボタンには、パラメータとして同じ値が必要です。Meta はリクエストにコードを 2 回含めることを求めています。
- 古い認証テンプレートで 30 日間の有効期間を維持すること。1 時間オフラインだった電話は、期限切れのコードを受け取ります。有効期間は、コードの有効期限以下に設定してください。
- コードを企業スコープのユーザー ID 宛に送ること。認証テンプレートは電話番号宛てのみで、Meta はエラー 131062 を返します。
具体的には、Send エンドポイント、アクセストークン、そして AI を通じた create_template と get_template_status です。番号は 24 時間体制で監視されるため、ログインコードが止まるような接続切れは、メールでお知らせします。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
WhatsApp の OTP は SMS の認証コードより安いですか?
Meta は、受信者の国ごとの料金で、配信された認証メッセージ 1 件ごとに課金します。一部の市場には別料金があります。SMS の料金は通信事業者と経路によって異なります。主要な国ごとに、Meta の料金表と SMS プロバイダーの料金を比べてから切り替えてください。
WhatsApp の 2 段階認証 PIN と同じものですか?
いいえ。2 段階認証は、企業自身の WhatsApp 番号を保護する 6 桁の PIN です。認証テンプレートは、お客様にコードを送り、アプリやサイトが本人であることを確認するためのものです。
ユーザーはコードを受け取るために、オプトインする必要がありますか?
はい。Meta のポリシーでは、企業がメッセージを送る前に許可を得ることが求められています。Meta の OTP ガイダンスは、WhatsApp、SMS、メールなど複数のチャネルから選べることを提案しています。ログイン画面で番号の横の WhatsApp を選択すること自体が、その許可になります。
代理店が 1 つの番号で複数のクライアントのコードを送れますか?
いいえ。Meta のベストプラクティスでは、認証テンプレートごとに、各企業が自社の WhatsApp Business アカウントと電話番号を持つことが求められています。企業間で 1 つの番号を共有することは、Meta の規約とポリシーに違反します。代わりに、クライアントごとに番号を接続してください。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日