# Configure Call Settings | Developer Documentation

<div id="bkmrk-configure-call-setti">## Configure Call Settings

<div><span>Updated: Mar 23, 2026</span></div><div><div>**Calling is not enabled by default on a business phone number**</div><div>Use the endpoint to enable Calling API features on a business phone number.</div></div><div><div>**Calling Eligibility**</div><div>To qualify for Calling API features, your business must have a messaging limit of at least 2000 business-initiated conversations in a rolling 24-hour period.</div><div>[Learn more about Quality Ratings and Messaging Limits](/books/meta-whatsapp/page/messaging-limits-developer-documentation)</div></div><div><div>When you test your WhatsApp Calling integration using public test numbers (PTNs) and sandbox accounts, Calling API restrictions are relaxed.</div><div>[Learn more about testing your WhatsApp Calling API integration](/books/meta-whatsapp/page/cloud-api-calling-developer-documentation)</div></div><div id="bkmrk-overview"><div id="bkmrk-overview-1"><div>### Overview

</div></div></div><div>Use these endpoints to view and configure call settings for the WhatsApp Business Calling API.</div><div>You can also [configure session initiation protocol (SIP)](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation) for call signaling instead of using Graph API endpoint calls and webhooks.</div><div id="bkmrk-configure%2Fupdate-bus"><div id="bkmrk-configure%2Fupdate-bus-1"><div>### Configure/Update business phone number calling settings

</div></div></div><div>Use this endpoint to update call settings configuration for an individual business phone number.</div><div><div>**WhatsApp clients reflecting latest calling config**</div><div>After you update call configuration, WhatsApp users may take up to 7 days to reflect those changes. Most users refresh much sooner. You can force an immediate refresh in WhatsApp by entering the chat window with business and open the chat info page. Regardless of WhatsApp client behavior, the semantics of settings are still honored on the server side.</div></div><div id="bkmrk-endpoint-parameters"><div id="bkmrk-endpoint-parameters-1"><div>#### Endpoint parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<PHONE_NUMBER_ID>`</div><div>*Integer*</div></div></td><td><div><div>**Required**</div><div>  
ID of the business phone number for which you are updating Calling API settings.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-calling-status"><div id="bkmrk-calling-status-1"><div>#### Calling status

</div></div></div><div>When the `status` parameter is set to `“ENABLED”`, calling features are enabled for the business phone number. WhatsApp client applications will render the call button icon in both the business chat and business chat profile.</div><div>When the `status` parameter is set to `“DISABLED”`, calling features are **disabled**, and both the business chat and business chat profile **do not display the call button icon.**</div><div>Updates to `status` will update the call button icon in existing business chats in near real-time when the business phone number is in the WhatsApp user’s contacts.</div><div>Otherwise, updates are real-time for a limited number of users in conversation with the business, and are eventual for the rest of the conversations.</div><div id="bkmrk-call-button-icon-vis"><div id="bkmrk-call-button-icon-vis-1"><div>##### Call button icon visibility

</div></div></div><div>When Calling API features are enabled for a business number, you can still choose whether to show the call button icon or not by using the `call_icon_visibility` parameter. Note: Disabling call button icon visibility **does not** disable a WhatsApp user’s ability to make unsolicited calls to your business.</div><div>The behavior for supported options is as follows:</div><div>`DEFAULT`</div><div>The Call button icon will be displayed in the chat menu bar and the business info page, allowing for unsolicited calls to the business by WhatsApp users.</div><div>![Screenshot showing call button icon displayed in WhatsApp chat](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-vsrvmbcw.jpeg)</div><div>`DISABLE_ALL`</div><div>The call button icon is hidden in the chat menu bar and the business info page, and all other entry points external to the chat are also disabled. Consumers cannot make unsolicited calls to the business.</div><div>Your business can still [send interactive messages](/books/meta-whatsapp/page/send-whatsapp-call-button-messages-and-deep-links-developer-documentation) or [template messages](/books/meta-whatsapp/page/send-whatsapp-call-button-messages-and-deep-links-developer-documentation) with a Calling API CTA button.</div><div>![Screenshot showing hidden call button icon in WhatsApp chat](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-ubnhuyaf.jpeg)</div><div id="bkmrk-callback-permissions"><div id="bkmrk-callback-permissions-1"><div>#### Callback permissions

</div></div></div><div>Calling a WhatsApp user requires explicit permission from the user. One way to obtain calling permissions is to request permission when a WhatsApp user calls your business.</div><div>You can configure the call permission UI to automatically show in the WhatsApp user’s client app when they call your business number. The user may change their permission selection at any time.</div><div>![Diagram showing callback permissions flow in WhatsApp](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-rc9iee4d.jpeg)</div><div id="bkmrk-call-icons"><div id="bkmrk-call-icons-1"><div>#### Call icons

</div></div></div><div>With the `call_icons` setting, you can specify the countries where these icons should show up.</div><div><div id="bkmrk-audio-codec"><div id="bkmrk-audio-codec-1"><div>#### Audio codec

</div></div></div><div>Opus is the default audio codec for all WhatsApp calls. You can enable G.711 (PCMA/PCMU) codecs for interoperability with legacy telephony systems or PSTN gateways.</div><div id="bkmrk-guidelines-and-consi"><div id="bkmrk-guidelines-and-consi-1"><div>##### Guidelines and considerations

</div></div></div><span>**Opus is the recommended codec.** Opus delivers higher audio quality with lower bandwidth usage and is the default for all WhatsApp calls. Use Opus unless you have a specific requirement for G.711.</span><span>**G.711 requires transcoding.** When a G.711 codec is negotiated, audio is transcoded between Opus (on the WhatsApp user side) and G.711 (on the business side), which can add latency to the call.</span><span>**G.711 has lower audio quality.** G.711 encodes audio at a fixed 64 kbps without advanced compression, resulting in lower fidelity compared to Opus.</span><span>**G.711 uses more bandwidth.** G.711 requires approximately 64 kbps per direction, while Opus achieves comparable or better quality at significantly lower bitrates.</span><span>**Use G.711 only when necessary.** The primary use case is interoperability with legacy telephony infrastructure and PSTN gateways that do not support Opus.</span> </div><div id="bkmrk-error-response"><div id="bkmrk-error-response-1"><div>#### Error response

</div></div></div><div>Possible errors that can occur:</div><span>Permissions/Authorization errors</span><span>Invalid status</span><span>Invalid schedule for `call_hours`</span><span>Holiday given in `call_hours` is a past date</span><span>Timezone is invalid in `call_hours`</span><span>`weekly_operating_hours` in `call_hours` cannot be empty</span><span>Date format in `holiday_schedule` for call\_hours is invalid</span><span>More than 2 entries not allowed in `weekly_operating_hours` schedule in `call_hours`</span><span>Overlapping schedule in `call_hours` is not allowed</span><div>[View Calling API Error Codes and Troubleshooting for more information](/books/meta-whatsapp/page/troubleshoot-whatsapp-calling-errors-reference-guide-developer-documentation)</div><div>[View general Cloud API Error Codes here](/documentation/business-messaging/whatsapp/support/error-codes)</div><div id="bkmrk-get-phone-number-cal"><div id="bkmrk-get-phone-number-cal-1"><div>### Get phone number calling settings

</div></div></div><div>Use this endpoint to check the configuration of your Calling API feature settings.</div><div>This endpoint can return information for other Cloud API feature settings.</div><div id="bkmrk-endpoint-parameters-3"><div id="bkmrk-endpoint-parameters-4"><div>#### Endpoint parameters

</div></div></div><div><table><thead><tr><th><span>Parameter </span></th><th><span>Description </span></th><th><span>Sample Value </span></th></tr></thead><tbody><tr><td><div><div>`<PHONE_NUMBER_ID>`</div><div>*Integer*</div></div></td><td><div><div>**Required**</div><div>  
ID of the business phone number for which you are getting Calling API settings.</div></div></td><td><div><div>`106540352242922`</div></div></td></tr></tbody></table>

</div><div id="bkmrk-app-permission-requi"><div id="bkmrk-app-permission-requi-1"><div>#### App permission required

</div></div></div><div>`whatsapp_business_management`: Advanced access is required to use the API for end business clients</div><div id="bkmrk-error-response-3"><div id="bkmrk-error-response-4"><div>#### Error response

</div></div></div><div>Possible errors that can occur:</div><span>Permissions/Authorization errors</span><div>[View Calling API Error Codes and Troubleshooting for more information](/books/meta-whatsapp/page/troubleshoot-whatsapp-calling-errors-reference-guide-developer-documentation)</div><div>[View general Cloud API Error Codes here](/documentation/business-messaging/whatsapp/support/error-codes)</div><div id="bkmrk-call-settings-in-wha"><div id="bkmrk-call-settings-in-wha-1"><div>### Call settings in WhatsApp Manager

</div></div></div><div>You can also control your call settings via [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/).</div><div>To access calling controls in WhatsApp Manager:</div><span>Click on **Account tools** &gt; **Phone numbers** panel</span><span>Click the gear icon next to the phone number you are using for calling</span><span>Click the **Calls** tab</span><div>![Screenshot of WhatsApp Manager call settings interface](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-dc5f62ho.jpeg)</div><div id="bkmrk-configure-and-use-ca"><div id="bkmrk-configure-and-use-ca-1"><div>### Configure and use call signaling via session initiation protocol (SIP)

</div></div></div><div>Session Initiation Protocol (SIP) is a signaling protocol used for initiating, maintaining, modifying, and terminating real-time communication sessions between two or more endpoints. You can send and receive call signals using SIP instead of Graph API endpoints.</div><div>[Learn more about how to use and configure SIP](/books/meta-whatsapp/page/sip-configuration-guide-whatsapp-business-calling-developer-documentation)</div><div id="bkmrk-calling-restrictions"><div id="bkmrk-calling-restrictions-1"><div>### Calling restrictions for user feedback

</div></div></div><div>If your calls receive a high negative user feedback, such as blocks and reports, business initiated calling, user initiated calling, or both functionalities on your phone number can be restricted.</div><div id="bkmrk-early-warning"><div id="bkmrk-early-warning-1"><div>#### Early warning

</div></div></div><div>You will be notified when the business phone number is close to being paused as an early warning. The early warning notifications will be communicated via below channels</div><div id="bkmrk-email"><div id="bkmrk-email-1"><div>##### Email

</div></div></div><div>Enforcement emails are sent to the email addresses of all users and admins associated with the business. If you did not receive an email, confirm which email you have designated as the contact email for your app and make sure that it is active, can receive new email, and does not flag the email as junk or spam mail.</div><div id="bkmrk-pause-in-calling-fun"><div id="bkmrk-pause-in-calling-fun-1"><div>#### Pause in calling functionality

</div></div></div><div>Once the negative user feedback reaches a threshold, Cloud API will automatically restrict calling functionality on your phone number for a period of 7 days. While paused the calling phone number will be unable to</div><span>*Make business initiated calls to users*</span><span>*Send call permissions requests*</span><div>Once your phone number has been paused, notifications will be communicated via below channels.</div><div>Note: Any call permissions approved or declined by the users while paused, will still be valid.</div><div id="bkmrk-email-3"><div id="bkmrk-email-4"><div>##### Email

</div></div></div><div>Enforcement emails are sent to the email addresses of all users and admins associated with the business. If you did not receive an email, confirm which email you have designated as the contact email for your app and make sure that it is active, can receive new email, and does not flag the email as junk or spam mail.</div><div id="bkmrk-pause-in-user-initia"><div id="bkmrk-pause-in-user-initia-1"><div>#### Pause in user initiated calling functionality

</div></div></div><div>Once the negative user feedback reaches a threshold, Cloud API will automatically restrict user initiated calling functionality on your phone number for a period of 7 days. While paused the calling phone number will be unable to</div><span>*Receive calls from users*</span><span>*Have call icon visible*</span><div>Once your phone number has been paused, notifications will be communicated via below channels.</div><div id="bkmrk-email-6"><div id="bkmrk-email-7"><div>##### Email

</div></div></div><div>Enforcement emails are sent to the email addresses of all users and admins associated with the business. If you did not receive an email, confirm which email you have designated as the contact email for your app and make sure that it is active, can receive new email, and does not flag the email as junk or spam mail.</div><div id="bkmrk-calling-restrictions-3"><div id="bkmrk-calling-restrictions-4"><div>### Calling restrictions for low call pickup rates

</div></div></div><div>When calling is enabled on your business phone number, you are expected to pick up calls that users place to you.</div><div>If a significant number of calls placed to your calling-enabled business phone number are not picked up, you will be notified and expected to make a change.</div><div id="bkmrk-what-happens-if-you-"><div id="bkmrk-what-happens-if-you--1"><div>#### What happens if you do not pick up calls

</div></div></div><span>**Warning via Email:** You receive an email notification with options to change how you handle incoming calls.</span><span>**Calling becomes restricted on the business phone number:** The calling button will be hidden from users.</span><div id="bkmrk-how-to-mitigate-the-"><div id="bkmrk-how-to-mitigate-the--1"><div>#### How to mitigate the situation

</div></div></div><div id="bkmrk-if-you-receive-a-war"><div id="bkmrk-if-you-receive-a-war-1"><div>##### *If you receive a warning*  


</div></div></div><span>**Continue allowing users to call:**</span> <span>Please identify and address the cause of calls not being picked up and make sure you are properly resourced to handle expected call volumes.</span><span>**Hide call buttons for user-initiated calls:**</span> <span>You can do so either by working with your partner or going to [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/overview/) &gt; Account tools &gt; Phone numbers &gt; select Phone number \[WA phone number\] &gt; Calls &gt; toggle off Display call buttons.</span><span>**Turn off calling altogether:**</span> <span>You can do so either by working with your partner or going to [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/overview/) &gt; Account tools &gt; Phone numbers &gt; select Phone number \[WA phone number\] &gt; Calls &gt; toggle off Allow voice calls.</span><div id="bkmrk-if-the-call-button-i"><div id="bkmrk-if-the-call-button-i-1"><div>##### *If the call button is hidden for the business phone number*  


</div></div></div><span>**Re-display calling buttons:**</span> <span>Please identify and address the cause of calls not being picked up and make sure you are properly resourced to handle expected call volumes.</span><span>Next, display the calling buttons by either working with your partner or going to [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/overview/) &gt; Account tools &gt; Phone numbers &gt; select Phone number \[WA phone number\] &gt; Calls &gt; toggle on Display call buttons.</span><span>**Turn off calling altogether:**</span> <span>You can do so either by working with your partner or going to [WhatsApp Manager<span>⁠</span>](https://business.facebook.com/latest/whatsapp_manager/overview/) &gt; Account tools &gt; Phone numbers &gt; select Phone number \[WA phone number\] &gt; Calls &gt; toggle off Allow voice calls.</span></div>