# Cloud API Calling | Developer Documentation

<div id="bkmrk-cloud-api-callingupd">## Cloud API Calling

<div><span>Updated: Mar 10, 2026</span></div><div id="bkmrk-overview"><div id="bkmrk-overview-1"><div>### Overview

</div></div></div><div>The WhatsApp Business Calling API enables you to initiate and receive calls with users on WhatsApp using Voice over Internet Protocol (VoIP).</div><div id="bkmrk-value-proposition-%28c"><div id="bkmrk-value-proposition-%28c-1"><div>### Value proposition (concise)

</div></div></div><div>**WhatsApp Business Calling: Trusted, Multi-Modal, Feature-Rich Global Connection.**</div><div><table><thead><tr><th><span>Value</span></th><th><span>Description</span></th></tr></thead><tbody><tr><td><div>**Unified Communication**</div></td><td><div>One Number. Message and call. Worldwide.</div></td></tr><tr><td><div>**Branding and Trust**</div></td><td><div>Branding that is built-in, trusted, and global.</div></td></tr><tr><td><div>**Customer Relationship**</div></td><td><div>Increase Stickiness. Deepen Personal Touch.</div></td></tr><tr><td><div>**Sales and Support**</div></td><td><div>Unify Marketing and Support. Unlock Upsell.</div></td></tr><tr><td><div>**Rich Features**</div></td><td><div>Video*, Screen Share*, and Full Call Customization.</div></td></tr><tr><td><div>**Call Deflection**</div></td><td><div>Call in WhatsApp. Improve deflection rates.</div></td></tr><tr><td><div>**Customer Convenience**</div></td><td><div>Free, Universal Access for your customers.</div></td></tr><tr><td><div>**Record Keeping**</div></td><td><div>One Thread. Centralized, Long-Term Record.</div></td></tr></tbody></table>

</div><div id="bkmrk-benefits-for-end-use"><div id="bkmrk-benefits-for-end-use-1"><div>#### Benefits for end-users

</div></div></div><div><table><thead><tr><th><span>Value</span></th><th><span>Description</span></th></tr></thead><tbody><tr><td><div>**Universal Access**</div></td><td><div>Simple, free, and familiar global connection.</div></td></tr><tr><td><div>**Enhanced Safety**</div></td><td><div>Safer due to built-in platform trust/verification.</div></td></tr><tr><td><div>**Centralized History**</div></td><td><div>One unified thread for all voice and text history.</div></td></tr><tr><td><div>**Voicemail Integrated**</div></td><td><div>A voicemail* playable within the chat context.</div></td></tr></tbody></table>

</div><div>Disclaimer: * Feature planned or in development. Reach out to your Meta or partner for more details</div><div id="bkmrk-value-proposition-%28d"><div id="bkmrk-value-proposition-%28d-1"><div>### Value proposition (detailed)

</div></div></div><div>The WhatsApp Business Calling API allows businesses to integrate voice and video* calling directly into their customer engagement strategy, offering a trusted, unified, and feature-rich communication channel.</div><div><table><thead><tr><th><span>Feature </span></th><th><span>Benefit for Your Business </span></th></tr></thead><tbody><tr><td><div><div>**Unified Communication**</div></div></td><td><div><div>**One Number. All Communication. Multi-modal.**Use a single, verified WhatsApp number for all messaging and calling (inbound and outbound), enabling a seamless flow between chat and call, and even chatting while on a call.</div></div></td></tr><tr><td><div><div>**Branding and Trust**</div></div></td><td><div><div>**Branding that is built-in, trusted, and global.**WhatsApp has native support for brand identity with security and verification, which provides instant trust globally, eliminating the need for region-specific third-party trust providers.</div></div></td></tr><tr><td><div><div>**Customer Relationship**</div></div></td><td><div><div>**Increase Stickiness. Deepen Personal Touch.**A single point of contact for both inbound and outbound communication enhances personal touch, increases customer stickiness, and ensures lasting customer loyalty.</div></div></td></tr><tr><td><div><div>**Sales and Support**</div></div></td><td><div><div>**Unify Marketing and Support. Unlock Upsell.**Centralize lead management by unifying support and marketing channels, which streamlines operations and unlocks opportunities for product upsell and cross-sell.</div></div></td></tr><tr><td><div><div>**Rich Features**</div></div></td><td><div><div>**More Than a Call. Get Video*, Screen Sharing*, and Advanced Control.**Beyond voice, businesses can engage customers with video calls and screen sharing for richer, more detailed support and service. Businesses also control the calling experience by configuring calling hours, managing call icon visibility, sending call buttons with expiry, using call deeplinks.</div></div></td></tr><tr><td><div><div>**Call Deflection**</div></div></td><td><div><div>**Call in WhatsApp. Improve deflection rates.**By moving calls to WhatsApp, businesses can seamlessly guide customers to a richer chat experience, leveraging interactive messaging templates to improve deflection and reduce voice-only support costs.</div></div></td></tr><tr><td><div><div>**Customer Convenience**</div></div></td><td><div><div>**Always Free, Always Universal Access.**Offer your customers a convenient and globally accessible communication method that is free for them to use.</div></div></td></tr><tr><td><div><div>**Record Keeping**</div></div></td><td><div><div>**One Thread. Centralized, Long-Term Record.**Maintain a single, persistent thread of all text and voice communications with the customer, serving as a centralized, long-term record for reference.</div></div></td></tr></tbody></table>

</div><div>Disclaimer: * Feature planned or in development. Reach out to your Meta or partner for more details</div><div id="bkmrk-architecture"><div id="bkmrk-architecture-1"><div>### Architecture

</div></div></div><div>![Image](https://support.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-6fucfh4a.jpeg)(*Right click image and choose “Open in new tab” for enlarged image*)</div><div id="bkmrk-signaling-and-media-"><div id="bkmrk-signaling-and-media--1"><div>#### Signaling and media possible configurations

</div></div></div><div><table><thead><tr><th></th><th><span>Default configuration after enabling calling </span></th><th><span>SIP with WebRTC </span></th><th><span>SIP with SDES media </span></th></tr></thead><tbody><tr><td><div><div>Signaling protocol</div></div></td><td><div><div>Graph APIs + Webhooks</div></div></td><td><div><div>SIP (needs explicit [enablement](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation))</div></div></td><td><div><div>SIP (needs explicit [enablement](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation))</div></div></td></tr><tr><td><div><div>Signaling transport</div></div></td><td><div><div>HTTPS</div></div></td><td><div><div>TLS</div></div></td><td><div><div>TLS</div></div></td></tr><tr><td><div><div>Media protocol</div></div></td><td><div><div>WebRTC (ICE + DTLS<sup>1</sup> + SRTP)</div></div></td><td><div><div>WebRTC (ICE + DTLS + SRTP)</div></div></td><td><div><div>[SDES<span>⁠</span>](https://l.facebook.com/l.php?u=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Frfc4568&h=AT4ICNy6ccJ6BY2qfVHlO1Ho3TprO7bBA7ECl0AhYSK2yu-kwaIrXcC7Sjdh_SynPr9uS_gqg_9hbQbVkvAtqRmgdxXZjVI7eqKNxWwt_UnyxFHle5EUNnVgNeVDsqNYTvHseEMfiHoQyfOnHF9rzA) SRTP (needs explicit [enablement](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation))</div></div></td></tr><tr><td><div><div>Audio codec<sup>2</sup></div></div></td><td><div><div>OPUS</div></div></td><td><div><div>OPUS</div></div></td><td><div><div>OPUS</div></div></td></tr></tbody></table>

</div><div>**Notes**</div>
<span>You can use SDES instead of ICE+DTLS with Graph API + Webhook signaling</span><span>Additional audio codecs supported: PCMA, PCMU</span><div id="bkmrk-get-started"><div id="bkmrk-get-started-1"><div>### Get started

</div></div></div><div id="bkmrk-step-1%3A-prerequisite"><div id="bkmrk-step-1%3A-prerequisite-1"><div>#### Step 1: Prerequisites

</div></div></div><div>Before you get started with the Calling API, ensure that:</div>
<span>[Your business number is in use with Cloud API](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation) (not the WhatsApp Business app)</span><span>Subscribe your app to the `calls` webhook field (unless you plan to use [SIP](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation))</span><span>The same app should also be [subscribed to the WhatsApp Business Account](/books/meta-whatsapp/page/create-a-webhook-endpoint-developer-documentation) of your business phone number.</span><span>This app should have messaging permissions (`whatsapp_business_messaging`) for the business number</span><span>The business must have a daily [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) of at least 2,000 unique recipients. More details on [scaling your account capabilities<span>⁠</span>](https://www.facebook.com/business/help/595597942906808).</span><span>[Enable Calling features on your business phone number](/books/meta-whatsapp/page/configure-call-settings-developer-documentation)</span><div id="bkmrk-step-2%3A-configure-op"><div id="bkmrk-step-2%3A-configure-op-1"><div>#### Step 2: Configure optional calling features

</div></div></div><div>The WhatsApp Business Calling API offers a number of features that affect when and how calling features appear to users on your WhatsApp profile</div>
<span>Inbound call control allows you to prevent users from placing calls from your business profile</span><span>Business call hours allows you to avoid missed calls and direct users to message when your call center is closed</span><span>Callback requests offer users the option to request a callback when you don’t pick up a call or if your call center is closed</span><div>[Learn more about call control settings](/books/meta-whatsapp/page/configure-call-settings-developer-documentation)</div><div id="bkmrk-step-3%3A-make-and-rec"><div id="bkmrk-step-3%3A-make-and-rec-1"><div>#### Step 3: Make and receive calls

</div></div></div><div><span></span><div>You can test your WhatsApp Calling integration using public test numbers and Sandbox WhatsApp Business Account.</div><div>[Learn more about testing your WhatsApp Calling API integration](/books/meta-whatsapp/page/cloud-api-calling-developer-documentation)</div></div><div>Cloud API Calling offers two call initiation paths:</div>
<span>**User-initiated calls:** Calls that are made from a WhatsApp user to your business</span><span>**Business-initiated calls:** Calls that are made from your business to a WhatsApp user</span><div id="bkmrk-testing-and-sandbox-"><div id="bkmrk-testing-and-sandbox--1"><div>### Testing and Sandbox accounts

</div></div></div><div><span></span><div>Sandbox accounts are only available to Tech Partners.</div></div><div>[Sandbox accounts](/books/meta-whatsapp/page/set-up-a-sandbox-account-for-calling-developer-documentation) and public test numbers enable you to test you WhatsApp Calling API integration with relaxed calling limitations. Specifically business initiated calling limits are relaxed for Sandbox accounts and public test numbers to help integration and testing efforts.</div><div id="bkmrk-limits-%28per-business"><div id="bkmrk-limits-%28per-business-1"><div>##### Limits (Per business + WhatsApp user pair)

</div></div></div>
<span>Sandbox accounts can send **25 call permissions per day** and **100 per week** (compared to 1 per day and 2 per week for production accounts)</span><span>When business-initiated calls go unanswered or are rejected </span>
<span>**5 consecutive unanswered calls** result in system message to reconsider an approved permission (compared to 2 consecutive unanswered calls for production accounts)</span><span>**10 consecutive unanswered calls** result in an approved permission being automatically revoked. (compared to 4 consecutive unanswered calls for production accounts)</span><div>You obtain a public test number after completing the [Get Started flow.](/books/meta-whatsapp/page/get-started-developer-documentation)</div><div>Your business is <u>not</u> required to have a daily [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) of 2,000 unique recipients to test Calling API features when using public test numbers and Sandbox accounts.</div><div>Calling is disabled by default on test numbers. You must [configure calling features in phone number call settings](/books/meta-whatsapp/page/configure-call-settings-developer-documentation) before using the Calling API on a test number.</div><div>[Learn more about Sandbox Accounts for Calling](/books/meta-whatsapp/page/embedded-signup-developer-documentation)</div><div id="bkmrk-availability"><div id="bkmrk-availability-1"><div>### Availability

</div></div></div><div id="bkmrk-user-initiated-calli"><div id="bkmrk-user-initiated-calli-1"><div>##### User-initiated calling

</div></div></div><div>User-initiated calling is available in [every location Cloud API is available](/books/meta-whatsapp/page/faqs-developer-documentation).</div><div id="bkmrk-business-initiated-c"><div id="bkmrk-business-initiated-c-1"><div>##### Business-initiated calling

</div></div></div><div>Business-initiated calling is currently available in [every location Cloud API is available](/books/meta-whatsapp/page/faqs-developer-documentation), **except the following countries:**</div>
<span>USA</span><span>Canada</span><span>Egypt</span><span>Vietnam</span><span>Nigeria</span><div>**Note:** The business phone number’s country code must be in this supported list. The consumer phone number can be from any [country where Cloud API is available.](/books/meta-whatsapp/page/faqs-developer-documentation)</div><div id="bkmrk-next-steps"><div id="bkmrk-next-steps-1"><div>### Next steps

</div></div></div><div>Use the guides below to integrate calling features in your application:</div>
<span>[Learn how to receive user-initiated calls](/books/meta-whatsapp/page/user-initiated-calls-developer-documentation)</span><span>[Learn how to place business-initiated calls](/books/meta-whatsapp/page/business-initiated-calls-developer-documentation)</span><span>[Learn how to drive consumer awareness of calling availability in your business](/books/meta-whatsapp/page/send-whatsapp-call-button-messages-and-deep-links-developer-documentation)</span><div id="bkmrk-changelog"><div id="bkmrk-changelog-1"><div>### Changelog

</div></div></div><div>Use this table as a centralized place to keep track of feature updates related to WhatsApp Business Calling APIs</div><div><table><thead><tr><th><span>Date </span></th><th><span>Title </span></th><th><span>Description </span></th></tr></thead><tbody><tr><td><div><div>March 23, 2026</div></div></td><td><div><div>Support for G.711 (PCMA, PCMU) audio codec</div></div></td><td><div><div>New section for G.711 (PCMA/PCMU) audio codec configuration in call settings, including guidelines on transcoding, audio quality, and bandwidth considerations. [Learn more about audio codec settings](/books/meta-whatsapp/page/configure-call-settings-developer-documentation).</div></div></td></tr><tr><td><div><div>January 27, 2026</div></div></td><td><div><div>Calling restrictions based on user feedback are now in effect</div></div></td><td><div><div>Learn more about [calling restrictions based on user feedback](/books/meta-whatsapp/page/configure-call-settings-developer-documentation).</div></div></td></tr><tr><td><div><div>December 19, 2025</div></div></td><td><div><div>Update in business initiated call limit</div></div></td><td><div><div>The number of business-initiated calls per user has been increased to 100 per day from 10 per day.</div><div>[Learn more about business-initiated call limits](/books/meta-whatsapp/page/obtain-user-call-permissions-developer-documentation)</div></div></td></tr><tr><td><div><div>December 10, 2025</div></div></td><td><div><div>Introduced `restrict_to_user_countries` for call icon settings</div></div></td><td><div><div>Now you can control in which countries the call icon should be visible. [Learn more about call icon country settings](/books/meta-whatsapp/page/configure-call-settings-developer-documentation).</div></div></td></tr><tr><td><div><div>October 13, 2025</div></div></td><td><div>
<span>Update in business initiated call limit</span><span>Added “Testing and Sandbox” section to documentation</span></div></td><td><div><div>The number of business-initiated calls per user has been increased to 10 per day from 5 per day.</div><div>[Learn more about business-initiated call limits](/books/meta-whatsapp/page/obtain-user-call-permissions-developer-documentation)</div><div>A [Testing and Sandbox accounts](/books/meta-whatsapp/page/cloud-api-calling-developer-documentation) has been added to the documentation</div></div></td></tr><tr><td><div><div>September 29, 2025</div></div></td><td><div><div>Asterisk integration guide</div></div></td><td><div><div>New guide to [integrate with Asterisk](/books/meta-whatsapp/page/integration-examples-developer-documentation)</div></div></td></tr><tr><td><div><div>September 24, 2025</div></div></td><td><div><div>Context propagation from call buttons and deep links</div></div></td><td><div><div>Specify an opaque string in call buttons or call deep links to help with tracking the origin of user-initiated calls. [Learn more](/books/meta-whatsapp/page/send-whatsapp-call-button-messages-and-deep-links-developer-documentation)</div></div></td></tr><tr><td><div><div>September 8, 2025</div></div></td><td><div><div>Health status API calling update</div></div></td><td><div><div>[Health Status API](/documentation/business-messaging/whatsapp/support/health-status) is now extended to include a new `can_receive_call_sip` field to help you self-diagnose issues related to [SIP](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation) setup</div></div></td></tr><tr><td><div><div>September 5, 2025</div></div></td><td><div><div>Introduced new low call pickup calling restrictions</div></div></td><td><div><div>Low call pickup rate restrictions are now in effect. Learn more at [Calling Restriction for Low Call Pickup Rates](/books/meta-whatsapp/page/configure-call-settings-developer-documentation)</div></div></td></tr><tr><td><div><div>July 21, 2025</div></div></td><td><div><div>Account settings update webhooks</div></div></td><td><div><div>Get webhooks when settings are updated. [Learn more](/books/meta-whatsapp/page/configure-call-settings-developer-documentation).</div></div></td></tr></tbody></table>

</div></div>