WhatsApp API / Migration planning guide
WhatsApp Web Sessions and Official API Migration: A Planning Guide
If a business workflow relies on a linked browser session, understand that dependency before changing it. An official API implementation can use a different connection model, but registration, eligibility, permissions, delivery and recovery still need a plan. Neither a logout headline nor a provider’s sales claim proves a safe migration for your number.
- Published
- Reading time
- 9 min
- Attribution
- Pending

In this guide
- Read the six-hour announcement as dated context
- Inventory the existing connection and its failures
- Assess standard and eligible hybrid paths separately
- Plan the standard API interface and number transition
- Check hybrid behavior without promising seamless history
- Provide genuine business information and a real website when requested
- Prepare templates, permission and a human fallback
- Confirm migration and subscription costs
- Use evidence-based readiness stages
- Bring one workflow and its exceptions
- Frequently asked questions
Part 01
Read the six-hour announcement as dated context
PIB’s 1 December 2025 release reports DoT directions issued on 28 November 2025 for specified app-based communication services using Indian mobile numbers. It describes periodic web-service logout no later than six hours, re-linking and a 90-day implementation requirement.
That historical announcement does not establish the behavior of every integration today, a timer starting at every QR scan, a universal exemption for Cloud API or a verified deadline for your account. This guide does not certify current enforcement or legal compliance. Check the current applicable provider and regulatory position before relying on a specific cutoff.
The practical migration question is narrower: does your current automation depend on a browser-linked session, how do you notice a disconnect, and what stops or recovers safely? Keep the observation separate from the rule’s legal scope.
Part 02
Inventory the existing connection and its failures
Some unofficial integrations imitate a web client; others may have different mechanisms. Record the actual software, connection method, account owner and support arrangement rather than asserting that all such APIs fail in the same way.
An interrupted session can leave payment reminders, invoice messages or support routing incomplete. It does not tell you whether every queued message failed, whether one was already delivered or whether a retry would duplicate it. Preserve business references and investigate actual status.
Do not plan a keep-alive workaround or an undocumented bypass as a business reliability strategy. Evaluate a permitted, supported path and an operator fallback. Equally, an official API label is not a promise of uninterrupted service or immunity from restrictions.
- List each ERP/CRM/send/support workflow and its connection dependency.
- Identify queued, accepted, delivered, failed and unknown records separately.
- Agree how operators learn about a disconnect and pause affected automation.
- Keep a recoverable export and a manual path for urgent work.
Part 03
Assess standard and eligible hybrid paths separately
Identify whether the number is on the Business App, already API-only or new. Assess coexistence and standard registration separately. Do not delete, deactivate, disconnect or re-register a working account based on this guide; agree a supported migration, backup and recovery plan first.
Coexistence is an option to assess for an existing Business App number. Confirm eligibility for that number, account, country, app/API version and rollout before planning a hybrid setup. This guide does not confirm availability for your account.
Confirm whether history and media import is offered, which records are included, consent, linked-device support and synchronization behavior. No fixed import period, device count or complete CRM history is guaranteed.
Standard and hybrid planning comparison
Scroll sideways to see every column →
| Aspect | Standard Cloud API | Hybrid Coexistence |
|---|---|---|
| Operating model | API integration with your chosen interface | Business App alongside API, subject to eligibility |
| Throughput and recipient limits | Check actual account limits | Check actual hybrid account limits |
| History, media and devices | Agree migration and retention scope | Confirm import, sync and linked-device scope |
| Calls, groups and app features | Confirm API/version/region support | Confirm each app/API feature separately |
| Region and onboarding | Check number/account/provider eligibility | Check country, app version and rollout |
| Billing | Effective category/rate; platform fees separate | Distinguish app and API traffic; confirm tariffs |
Further reading
Part 04
Plan the standard API interface and number transition
A standard path means your team needs an API application and a chosen inbox or integration. Document where staff will answer, which permissions they receive and how attachments, assignment and escalation will work. Do not assume a particular provider portal is the only possible interface.
Confirm the transition steps for an existing app or API number before unregistering anything. Display-name treatment, business verification and badge approval are separate questions; a demonstration of a branded profile does not prove your account will receive that display.
Choose a reversible sequence where the supported flow allows one. Agree how to stop the old automation, reconcile outstanding records and recover if registration or the new inbox is unavailable. Do not delete a working account based on this guide.
- Confirm current number state, ownership and supported registration path.
- Agree backup/retention and any supported import before a change.
- Prepare the new inbox, operator roles, templates and status handling.
- Reconcile and pause the old queue at the agreed cutover point.
- Validate the new path and document the recovery/escalation procedure.
Part 05
Check hybrid behavior without promising seamless history
A hybrid assessment is useful when staff need the Business App as well as API automation. Assess the exact number, country, app/API version and provider flow. Confirm how manual and automated replies are distinguished and how operators avoid duplicate answers.
Ask which records, attachments and devices carry over, which remain in the app and what the integration actually stores. A connected account is not proof that every historical chat became CRM data. Confirm permission and retention for the records you intend to copy.
Phone changes, inactivity, disconnects and app updates can affect operations. Obtain the supported connection and recovery instructions for your account; this page establishes no fixed inactivity period, automatic reconnection or permanent avoidance of re-authentication.
Further reading
Part 06
Provide genuine business information and a real website when requested
The Business Messaging Policy calls for accurate business identity and customer support contact information. Use details that describe the actual operator and the service customers receive. A name, brand affiliation or verification document must not be invented to obtain approval.
If the selected verification flow requests a website, use a functioning site that genuinely describes your business and check the requested ownership/details with the provider. Do not submit a dummy website or fabricated evidence to pass review. The detailed verification documentation could not be retrieved for this check, so this page does not assert a universal list of required documents or domains.
Business-profile contact options, business verification and the privacy duties relevant to your own operation are distinct. Whats91’s operator details and legal documents do not become universal customer website requirements. Confirm what applies to your business and onboarding flow.
Onboarding, verification, template review and integration timing depend on the account, provider, workflow and outstanding approvals. Confirm the scope and schedule with the team; no instant approval, fixed waiting period or go-live deadline is promised.
Part 07
Prepare templates, permission and a human fallback
A customer message opens or resets the 24-hour reply window. Outside it, an approved template is needed. Permission to use a message format does not determine its price; confirm the effective category, allowance and account conditions separately.
Inventory first-contact, follow-up and support messages separately. Record the intended purpose, recipient permission and template status for the actual flow. Approval of a template is not permission to send it to every stored contact.
Keep an operator route for invalid customer mappings, disputed balances, failed media or unresolved delivery. A change in connection model should not remove the customer’s way to get help. Review opt-outs before moving any contact list.
Part 08
Confirm migration and subscription costs
Effective 1 October 2026; original INR billing card, per delivered message. This schedule is not the price for messages delivered before 1 October 2026. Whats91 passes through Meta messaging charges without markup. Whats91 platform subscriptions, setup, integrations and applicable taxes are separate.
Meta’s public pricing page, checked 29 September 2026, describes charges for delivered messages by recipient market and category. Keep an API acknowledgement, delivery evidence and an invoice as separate records. A queued or accepted request is not a final charge; missing evidence leaves billing unresolved.
Whats91 platform subscriptions: Coexistence ₹699/month or ₹5,000/year; Standard ₹949/month or ₹7,000/year. Monthly billing has a one-time setup fee of ₹1,000 or ₹2,000 respectively; annual billing includes setup. These amounts exclude 18% GST, added on top. Meta message charges pass through separately without Whats91 markup. Add-ons, feature eligibility, trials, renewal, invoice treatment and activation need separate confirmation. No payment or activation is available on this website.
Separate number/onboarding work, ERP integration, inbox/subscription, message charges and invoice treatment. Confirm duration, renewal and cancellation in writing. There is no confirmed two-year or three-year saving, price lock or universal provider markup here.
Part 09
Use evidence-based readiness stages
Readiness is a sequence of checks, not a fixed go-live promise. Agree who can approve each stage and which failure prevents the next one. Preserve an operator-controlled pause so a broken mapping or uncertain delivery state does not trigger more sends.
Cutover decision map
Assess, rehearse and retain a recovery path
A browser-linked dependency needs an inventory and stop criteria before any separately authorized migration.

Assess
Record the current session dependency, number state and supported path.
Rehearse
Test synthetic failures and uncertain delivery without customer traffic.
Recover
Set an operator pause and rollback criteria before a pilot.
A synthetic rehearsal can exercise state handling and reconciliation without accessing customer accounts. A real pilot needs separate authority, confirmed recipients and a supported account. Do not treat a website contact enquiry as authorization to register a number or send messages.
Migration readiness and stop conditions
Scroll sideways to see every column →
| Stage | Evidence to gather | Stop if |
|---|---|---|
| Assess | Number state, access and supported path | Ownership or eligibility is unresolved |
| Prepare | Backups, interface, templates and mapping | Required records cannot be recovered |
| Rehearse | Synthetic failures, duplicates and escalation | Unknown states produce blind retries |
| Pilot | Separately authorized account/customer test | Delivery, billing or recovery is unresolved |
| Cut over | Queue reconciliation and named operators | Old and new systems can duplicate sends |
Part 10
Bring one workflow and its exceptions
Whats91 onboarding assistance, integrations, support channels and response commitments depend on your agreed service scope. Provider/account approval is separate from Whats91 assistance; no organization policy establishes universal Meta eligibility.
For a migration discussion, bring the connection method, number state, operator needs, history scope and outstanding queue. Ask for a written path, cost scope and recovery plan. A supported migration can be evaluated without promising that every old workflow, mobile feature or stored conversation will transfer.
Questions
Frequently asked questions
Does the December 2025 announcement prove my integration disconnects today?
No. The announcement is dated regulatory context. Confirm the current applicable rules and observe your actual integration; this guide does not establish account enforcement, a universal QR timer or a Cloud API exemption.
Can I keep the Business App when migrating?
Coexistence is an option to assess for an existing Business App number. Confirm eligibility for that number, account, country, app/API version and rollout before planning a hybrid setup. This guide does not confirm availability for your account. Identify whether the number is on the Business App, already API-only or new. Assess coexistence and standard registration separately. Do not delete, deactivate, disconnect or re-register a working account based on this guide; agree a supported migration, backup and recovery plan first.
Will my history and media all transfer?
Confirm whether history and media import is offered, which records are included, consent, linked-device support and synchronization behavior. No fixed import period, device count or complete CRM history is guaranteed.
Can I use a placeholder website to pass verification?
Use genuine business information and a real business website if the selected flow requests one. Do not fabricate evidence. Confirm the exact verification requirements for your portfolio/provider rather than assuming a universal website checklist.
Does migration guarantee a badge, uptime or a multi-year saving?
No. Confirm display-name/badge eligibility, connection/recovery behavior and commercial terms separately. An official API path does not establish a numerical SLA or a current discount.
Share this guide
If copying is unavailable, select the article link below.
Next reads
Continue reading
WhatsApp API
Meta's WhatsApp Business Tools MCP: a practical Cloud API setup checklist
Meta announced agent-assisted WhatsApp Business Platform setup in September 2026. See its rollout limits and a safe way to test onboarding, templates and webhooks.
Read guide →WhatsApp API
WhatsApp Cloud API Pricing India 2026: Budgeting and Billing Conditions
Separate message charges, platform fees, setup and taxes. Check effective rate scope, billing evidence and written buying conditions before committing a budget.
Read guide →WhatsApp API
WhatsApp Cloud API Restrictions and Coexistence: Diagnosis and Planning
Diagnose account restrictions, distinguish limits from pacing, and compare standard and hybrid setup with eligibility, history and recovery checks.
Read guide →WhatsApp API
WhatsApp Graph API v24 to v25: An Evidence-Based Migration Checklist
Plan a Graph API version migration with changelog checks, scoped identity mapping, token expiry and revocation checks, delivery reconciliation and rollback.
Read guide →