Skip to main content

Meta WhatsApp

WhatsApp Business Platform developer documentation: Cloud API, messages, templates, webhooks, phone numbers, onboarding, and payments.

Access Tokens

How to generate and use access tokens for WhatsApp Business Platform APIs.

Analytics

Compare available reports, message results and ChatArchitect billing records. Confirm each report...

Block Users

API guidance for blocking WhatsApp users and managing blocked contacts.

Business Phone Numbers

Set up WhatsApp business phone numbers: registration, two-step verification, and related Cloud AP...

Business Profiles

Manage the public profile details of a WhatsApp Business Platform account.

Business Scoped User Ids

Understand business-scoped user IDs used by the WhatsApp Business Platform.

Calling

ChatArchitect does not support WhatsApp Business Calling through its API or ready-made integratio...

Catalogs

Availability of native WhatsApp catalogs, product cards, carts and orders in ChatArchitect, with ...

Core

For an overview, see About the WhatsApp Business Platform.

Ctwa

API guide to welcome message sequences for ads that click to WhatsApp.

Data Privacy And Security

Privacy and security guidance for WhatsApp Business Platform data and API use.

Display Names

Requirements and setup for WhatsApp business phone number display names.

Docs

Introduction to the WhatsApp Business Platform and its core documentation.

Embedded Signup

Connect WhatsApp through ChatArchitect, finish setup and use the Business app with coexistence. C...

Getting Opt In

How to obtain user opt-in before sending WhatsApp Business messages.

Identity Change

Identity change behavior and handling in the WhatsApp Business Platform.

Link Previews

Enable and control link previews in WhatsApp Business messages.

Local Storage

How local storage works for WhatsApp Business Platform data.

Marketing Messages

Set up Marketing Messages API, send campaigns, track click events and conversions, and review met...

Marketing Messages API for WhatsApp | Developer Documentation

Marketing Messages API and ChatArchitect campaigns Meta's Marketing Messages API for WhatsApp is ...

Get started | Developer Documentation

Get started with a WhatsApp marketing campaign This guide is for businesses sending marketing mes...

Features | Developer Documentation

WhatsApp marketing features in ChatArchitect Meta describes a broad set of features for its Marke...

Onboard | Developer Documentation

Prepare a ChatArchitect number for WhatsApp marketing This page covers the customer setup needed ...

Setting up conversion measurement | Developer Documentation

Measure a ChatArchitect WhatsApp marketing campaign Start with a question you can answer using da...

Tracking click events | Developer Documentation

Track links in a ChatArchitect WhatsApp campaign You can use a tagged destination on your own web...

Viewing metrics | Developer Documentation

Review WhatsApp campaign results with ChatArchitect To review a marketing campaign sent through C...

Deep links | Developer Documentation

Test website and app links in ChatArchitect templates A deep link takes a recipient to a particul...

Send Marketing Messages | Developer Documentation

Send an approved marketing template through ChatArchitect Use your connected CRM, help desk or ot...

Onboard business customers | Developer Documentation

Hand over a ChatArchitect marketing setup to your team Use this checklist when the people connect...

Set a max-price for marketing messages (BETA) | Developer Documentation

Maximum-price settings and campaign costs in ChatArchitect ChatArchitect does not currently provi...

Messages

Send WhatsApp Business messages in text, media, interactive, location, and template formats.

Sending messages | Developer Documentation

Send your first WhatsApp message with ChatArchitect Use this guide to test a WhatsApp Business nu...

Audio messages | Developer Documentation

Check WhatsApp audio and voice messages in ChatArchitect Use this checklist when your connected C...

Contacts messages | Developer Documentation

Send and verify a WhatsApp contact card with ChatArchitect ChatArchitect supports contact-card me...

Document messages | Developer Documentation

Prepare and check a WhatsApp document attachment Use this checklist when sending an invoice, deli...

Image messages | Developer Documentation

Prepare and check a WhatsApp image attachment Use this checklist for a product photo, delivery im...

Interactive Call-to-Action URL Button Messages | Developer Documentation

Interactive Call-to-Action URL Button Messages Updated: Nov 3, 2025 WhatsApp users may be hesitan...

Interactive list messages | Developer Documentation

Interactive list messages Updated: Nov 3, 2025 Interactive list messages allow you to present Wha...

Interactive media carousel messages | Developer Documentation

Interactive media carousels and ChatArchitect ChatArchitect does not support standalone interacti...

Location messages | Developer Documentation

Send and verify a WhatsApp map location with ChatArchitect ChatArchitect supports location messag...

Location request messages | Developer Documentation

Location-request buttons and ChatArchitect ChatArchitect does not support the special WhatsApp me...

Reaction messages | Developer Documentation

Send a reaction to a customer's WhatsApp message ChatArchitect supports sending an emoji reaction...

Template Messages | Developer Documentation

When to use a WhatsApp template message with ChatArchitect A template is a reusable message that ...

Text messages | Developer Documentation

Write and send a text reply through ChatArchitect Use the conversation in your connected CRM or h...

Video Messages | Developer Documentation

Prepare and check WhatsApp video attachments with ChatArchitect Use this checklist if your connec...

Mark messages as read | Developer Documentation

Check what a WhatsApp read indicator means Before relying on a read indicator in a conversation h...

Contextual replies | Developer Documentation

Check a reply that quotes a customer's message When a customer sends several questions, a quoted ...

Address Messages | Developer Documentation

Address Messages Updated: Nov 7, 2025 This feature is only available for businesses based in Indi...

Messaging Limits

Understand WhatsApp Business Platform messaging limits and how they affect outreach.

No Storage

Overview of the No Storage option for WhatsApp Business Platform data.

Official Business Accounts

Learn about Official Business Accounts on the WhatsApp Business Platform.

Payments

Send an external checkout link through ChatArchitect and confirm payment with your payment provid...

Permissions

Reference for permissions required by WhatsApp Business Platform integrations.

Policy Enforcement

Understand WhatsApp Business Platform policies, spam enforcement, and account restrictions.

Policy Enforcement Violations

Reference for WhatsApp Business Platform policy violations and how they are reported.

Qr Codes

Create and manage QR codes and short links for WhatsApp Business accounts.

Reference

API reference for WhatsApp accounts, phone numbers, media, groups, message history, and partner o...

Meta Graph API - Application Connected Client Businesses | Developer Documentation

Review which customer each connection serves Use this checklist when your own service connects se...

WhatsApp Business Management - Add Phone Numbers API | Developer Documentation

Use a phone number you control with ChatArchitect ChatArchitect does not supply or sell phone num...

WhatsApp Cloud API - Business Account API | Developer Documentation

Label each reference before using it A number copied from an account screen may identify an accou...

WhatsApp Business Management API - Owned WhatsApp Business Accounts | Developer Documentation

Confirm who controls the intended business assets Use this check before connecting a business num...

WhatsApp Business Accounts API | Developer Documentation

Choose the intended account before starting setup A new integration does not automatically requir...

WhatsApp Business Partner Onboarding to MM Lite API | Developer Documentation

WhatsApp Business Partner Onboarding to MM Lite APICopy for LLMView as MarkdownVersionAPI for onb...

WhatsApp Business Pre-Verified Phone Numbers API | Developer Documentation

Check a pre-verified WhatsApp number offer before connecting it ChatArchitect does not supply or ...

WhatsApp Cloud API - Media API | Developer Documentation

Find and manage the copies of a WhatsApp attachment ChatArchitect does not store customer message...

WhatsApp Cloud API - Media Download API | Developer Documentation

Find why a received attachment will not open Open the conversation in the application that receiv...

WhatsApp Business Message History Events API | Developer Documentation

A worksheet for one WhatsApp sending attempt Copy the table into your own incident record when a ...

WhatsApp Business - Assigned WhatsApp Business Accounts API | Developer Documentation

Compare the visible Meta account with the missing signup choice Use this worksheet when the inten...

WhatsApp Incoming Webhook Payload | Developer Documentation

Read a ChatArchitect WhatsApp callback payload Use this reference to identify incoming text and o...

WhatsApp Business API - WhatsApp Account Number API | Developer Documentation

Check the destination of a send request The ChatArchitect API Quick Start specifies international...

WhatsApp Business Account - Assigned Users Management API | Developer Documentation

Transfer responsibility without losing the working route Use this checklist when the person who m...

WhatsApp Business Account - Conversational Automation API | Developer Documentation

Find where a WhatsApp prompt stops working An ice breaker or command configured in WhatsApp Manag...

WhatsApp Cloud API - Extended Credits API | Developer Documentation

Investigate a ChatArchitect WhatsApp billing discrepancy Use this checklist when an invoice, char...

WhatsApp Business API - Phone Number Management API | Developer Documentation

Keep a routing record for each business number Use this audit when your business or application w...

WhatsApp Business Account - Schedules API | Developer Documentation

Separate a scheduled job from a WhatsApp sending attempt A reminder or campaign planned for later...

WhatsApp Business Account - Subscribed Apps API | Developer Documentation

Check the message receiver after changing a connected tool Use this checklist when a CRM, applica...

WhatsApp Cloud API - Template API | Developer Documentation

Fetch approved WhatsApp templates with the ChatArchitect API Use this reference when your applica...

WhatsApp Business Account Solutions List API | Developer Documentation

Identify what a provider relationship record actually describes An application or partner-solutio...

WhatsApp Business Account - Migration Intent Details API | Developer Documentation

Check the outcome of an agreed number change Use this acceptance checklist after support and the ...

WhatsApp Business Bot - Bot Details API | Developer Documentation

Start with the reply that was actually sent Use this diagnostic when a customer receives an unexp...

WhatsApp Cloud API - Business Encryption API | Developer Documentation

Encryption keys and ChatArchitect credentials ChatArchitect has no customer setting for supplying...

WhatsApp Cloud API - Marketing Messages Lite API | Developer Documentation

WhatsApp Cloud API - Marketing Messages Lite API Copy for LLM View as Markdown Version ...

WhatsApp Cloud API - Media Upload API | Developer Documentation

Prepare a file before sending it through ChatArchitect Start with the file types and attachment c...

WhatsApp Cloud API - Message API | Developer Documentation

Send a WhatsApp message with the ChatArchitect API Use this reference to prepare an ordinary text...

WhatsApp Cloud API - Phone Number API | Developer Documentation

Prepare a number change before altering a working connection Use this checklist when you want to ...

WhatsApp Cloud API - Settings API | Developer Documentation

Choose the owner of the setting you want to change WhatsApp Manager, ChatArchitect and your conne...

WhatsApp Business Account Phone Number Verification - Verify Code API | Developer Documentation

Troubleshoot the code used to verify your phone number The supplied ChatArchitect connection flow...

WhatsApp Cloud API - WhatsApp Business QR Code Management API | Developer Documentation

Check every published QR code against the intended number Use this checklist to audit a poster, w...

WhatsApp Business Pre-Verified Phone Number Partners API | Developer Documentation

Check an access request for a verified WhatsApp number Someone may ask for business access while ...

WhatsApp Business Profile Node API | Developer Documentation

Locate the screen showing the wrong business details Start by recording where the outdated name, ...

WhatsApp Cloud API - Register API | Developer Documentation

Confirm which part of the WhatsApp setup is ready A successful ownership code, a listed business ...

Solution Providers

Customer account, number, credential, billing and webhook guides for ChatArchitect, with separate...

Solution providers | Developer Documentation

Who sets up a WhatsApp connection with ChatArchitect? Use this guide when your business wants to ...

Become a Tech Provider | Developer Documentation

Do you need to become a Meta Tech Provider to use ChatArchitect? For an application that uses the...

Get started as a Solution Partner | Developer Documentation

Agree on responsibilities when another company helps connect WhatsApp A consultant or integration...

Measurement Partners | Developer Documentation

Prepare a WhatsApp measurement brief for an external analyst Start with the question you want the...

Upgrading to a Tech Partner | Developer Documentation

Evaluate a ChatArchitect plan change for your WhatsApp workload A change to your ChatArchitect se...

App Review | Developer Documentation

A Meta App Review request during ChatArchitect setup An application using the ChatArchitect servi...

Partner-initiated WABA creation | Developer Documentation

Check what the invitation is asking you to authorize An invitation to create or share a WhatsApp ...

Multi-Partner Solutions | Developer Documentation

Give each part of the connection a responsible owner A business, ChatArchitect and a company that...

Multi-Partner Solution — Embedded creation | Developer Documentation

Check the entry point when a setup screen looks unfamiliar ChatArchitect customers use its prepar...

How to use Multi-Solution Conversations (MSC) | Developer Documentation

Confirm the arrangement before treating several tools as one conversation When several teams or s...

Partner-led Business Verification | Developer Documentation

Submit your company's business verification to Meta A ChatArchitect client submits the company's ...

Tracking with the Meta Pixel | Developer Documentation

Check what your website tracking measures around WhatsApp Your website's tracking and your ChatAr...

Managing WhatsApp Business Accounts | Developer Documentation

Check the WhatsApp business account used by your connection Before configuring the sending tool, ...

Registering business phone numbers | Developer Documentation

A verified WhatsApp number that cannot yet send or receive Accepting the phone verification code ...

Manage System Users | Developer Documentation

Use the credentials for your ChatArchitect connection A custom service connected through ChatArch...

On-Behalf-Of account ownership model deprecation | Developer Documentation

Use current account evidence when an old migration notice resurfaces An old notice about Meta's O...

Migrate an existing WhatsApp Number to a Business Account | Developer Documentation

Prepare an existing WhatsApp number for ChatArchitect Before changing a working number, identify ...

Business customer phone numbers | Developer Documentation

Match the business number to the intended integration Keep a clear record of the business phone n...

Managing credit lines | Developer Documentation

Check billing for your ChatArchitect WhatsApp connection For WhatsApp messaging through ChatArchi...

Managing Webhooks | Developer Documentation

Manage the receiver for your ChatArchitect connection A custom application uses a receiver to get...

Templates

Create and manage WhatsApp message templates, with guidance on categories, authentication, qualit...

Utility templates | Developer Documentation

Create a utility WhatsApp template with ChatArchitect Choose Utility for a non-promotional update...

Best practices for authenticating users via WhatsApp | Developer Documentation

Best practices for authenticating users via WhatsApp Updated: Nov 21, 2025 Security To register w...

One-tap autofill authentication templates | Developer Documentation

One-tap autofill authentication templates Updated: Feb 6, 2026 Upcoming deprecation: Starting Apr...

Zero-tap authentication templates | Developer Documentation

Zero-tap authentication templates Updated: Feb 6, 2026 Upcoming deprecation: Starting April 15, 2...

Copy code authentication templates | Developer Documentation

Copy code authentication templates Updated: Nov 4, 2025 Copy code authentication templates allow ...

Error Signals | Developer Documentation

Error Signals Updated: Feb 6, 2026 Upcoming deprecation: Starting April 15, 2026, the PendingIn...

Bulk management | Developer Documentation

Prepare several template language versions in ChatArchitect Use a working list when you need seve...

Template previews | Developer Documentation

Review a WhatsApp template before submission and sending Check the message text and sample values...

Templates | Developer Documentation

Create WhatsApp message templates with ChatArchitect Use this guide to prepare a WhatsApp message...

Marketing templates | Developer Documentation

Create a WhatsApp marketing template with ChatArchitect Use a Marketing template for an offer, pr...

Coupon code templates | Developer Documentation

Include a coupon code in a WhatsApp template with ChatArchitect Use a Marketing text template to ...

Limited-time offer templates | Developer Documentation

Communicate a time-limited offer with ChatArchitect Use an approved Marketing text template to st...

Template categorization | Developer Documentation

Choose a WhatsApp template category in ChatArchitect Choose a category that matches the purpose o...

Template components | Developer Documentation

Parts of a WhatsApp message template in ChatArchitect A template combines message text, variables...

Template Library | Developer Documentation

Template Library Updated: Nov 14, 2025 Template Library makes it faster and easier for businesses...

Template management | Developer Documentation

Edit or delete a WhatsApp template in ChatArchitect You can change or delete an existing template...

Business portfolio pacing | Developer Documentation

Why a WhatsApp campaign may slow across several numbers Meta can release a large template campaig...

Template pacing | Developer Documentation

Why WhatsApp template messages may be held before delivery If some messages in a ChatArchitect ca...

Template pausing | Developer Documentation

What to do when a WhatsApp template is paused Meta may pause a WhatsApp message template after po...

Per-user marketing template message limits | Developer Documentation

When a WhatsApp marketing message is limited for one recipient A marketing template can be approv...

Template quality rating | Developer Documentation

Check the quality of a WhatsApp message template A template can be approved and still perform poo...

Template review | Developer Documentation

What happens after you submit a WhatsApp template When you submit a message template through Chat...

Tap target title URL override | Developer Documentation

Clickable template areas in ChatArchitect ChatArchitect does not support Meta's tap-target overri...

Configure message time-to-live | Developer Documentation

Plan WhatsApp message validity with ChatArchitect Use this checklist for an offer, reminder or up...

Template groups | Developer Documentation

Keep a campaign template register with ChatArchitect Use a shared register when a campaign involv...

Template Comparison | Developer Documentation

Compare WhatsApp template results in a ChatArchitect campaign Compare two approved templates when...

Template migration | Developer Documentation

Prepare WhatsApp templates before an account change with ChatArchitect If you plan to change a Wh...

Throughput

Understand message throughput limits for the WhatsApp Business Platform.

Typing Indicators

How to send typing indicators through the WhatsApp Business Platform.

Upcoming Messaging Limits Changes

Review planned changes to WhatsApp Business Platform messaging limits.

Webhooks

Configure WhatsApp Business Platform webhooks and reference event payloads for messages and accou...

Webhooks | Developer Documentation

Receive and understand WhatsApp webhooks from ChatArchitect Use this guide for a custom service c...

Create a webhook endpoint | Developer Documentation

Prepare a webhook endpoint for the ChatArchitect API Use this checklist when building your own Ch...

Create a test webhook endpoint | Developer Documentation

Test a ChatArchitect webhook receiver before using it with customers Use this guide to check a re...

business_capability_update webhook reference | Developer Documentation

Review a changed WhatsApp account limit before your next campaign If Meta or support reports a ch...

history webhook reference | Developer Documentation

Check WhatsApp Business app chat history in ChatArchitect When connecting an existing WhatsApp Bu...

message_template_components_update webhook reference | Developer Documentation

Check changed WhatsApp template content in ChatArchitect After editing a WhatsApp template, check...

message_template_quality_update webhook reference | Developer Documentation

Respond to a change in WhatsApp template quality A template's quality can change after it has bee...

message_template_status_update webhook reference | Developer Documentation

Handle a WhatsApp template status change in ChatArchitect Use this checklist when a template is a...

messages webhook reference | Developer Documentation

Route WhatsApp message events correctly in ChatArchitect An incoming customer text and a delivery...

Button messages webhook reference | Developer Documentation

Check replies to WhatsApp template buttons in ChatArchitect If an approved WhatsApp template offe...

Contacts messages webhook reference | Developer Documentation

Handle incoming WhatsApp contact cards with ChatArchitect A customer may share a contact card whi...

Edit messages webhook reference | Developer Documentation

Check edited WhatsApp messages in ChatArchitect A customer can correct a message after your team ...

Errors messages webhooks reference | Developer Documentation

Investigate a WhatsApp sending error with ChatArchitect Start with the operation and the specific...

Interactive messages webhook reference | Developer Documentation

Interactive messages webhook reference Updated: Oct 22, 2025 This reference describes trigger eve...

Location messages webhook reference | Developer Documentation

Check incoming WhatsApp locations with ChatArchitect Use this checklist when a customer shares a ...

Reaction messages webhook reference | Developer Documentation

Handle incoming WhatsApp reactions with ChatArchitect A customer may add or remove an emoji react...

Status messages webhook reference | Developer Documentation

Track a WhatsApp message's delivery through ChatArchitect Use the sending tool's message history,...

System messages webhook reference | Developer Documentation

Check WhatsApp customer identifier changes in ChatArchitect If a conversation appears under a cha...

Text messages webhook reference | Developer Documentation

Route incoming WhatsApp texts from ChatArchitect to your application Use this guide for the incom...

Unsupported messages webhook reference | Developer Documentation

Handle an incoming WhatsApp message you cannot view If a conversation connected to ChatArchitect ...

partner_solutions webhook reference | Developer Documentation

Start with the notice and the customer outcome A notification about a provider relationship is di...

payment_configuration_update webhook reference | Developer Documentation

Check payment confirmation after sending a WhatsApp link When you send an external checkout link ...

phone_number_name_update webhook reference | Developer Documentation

Check the result of a WhatsApp display name review After adding a business number or submitting a...

phone_number_quality_update webhook reference | Developer Documentation

Review a throughput change for your connected WhatsApp number A notice about increased platform t...

security webhook reference | Developer Documentation

Review WhatsApp PIN change notices with ChatArchitect A security notice about a business number c...

smb_app_state_sync webhook reference | Developer Documentation

Check Business app contact sync with ChatArchitect If your team keeps the WhatsApp Business app a...

smb_message_echoes webhook reference | Developer Documentation

Check WhatsApp Business app sends in ChatArchitect When agents use the WhatsApp Business app and ...

template_category_update webhook reference | Developer Documentation

Check a change to a WhatsApp template category The category shown when you submitted a template c...

user_preferences webhook reference | Developer Documentation

Handle WhatsApp marketing preference changes in ChatArchitect When a customer asks to stop market...

automatic_events webhook reference | Developer Documentation

Why automatic_events is not a ChatArchitect callback workflow ChatArchitect does not support auto...

Webhook overrides | Developer Documentation

Prepare a webhook receiver URL change for ChatArchitect Use this guide to plan a callback change ...

Whatsapp Business Accounts

Manage WhatsApp Business Accounts through the platform and its APIs.