WhatsApp API calling is a common topic when businesses structure their support channels. Through the Calling API, Meta’s official API supports voice calls started by customers and, with prior permission, by the business, alongside messages, media, and documents.
Calls do not replace text automation, which already transforms customer service. Businesses use AI agents to qualify leads and resolve requests 24 hours a day, and voice comes in where a direct conversation helps, such as complex support or closing a sale.
Key Takeaways
- The Calling API allows voice calls started by the user and by the business.
- For the business to call, it must request and obtain the user’s permission in advance.
- Calls started by customers are free, while calls started by the business are charged by duration.
- Voice interactions renew the 24-hour customer service window.
- The business number cannot be connected through coexistence with the WhatsApp Business app.
What Is the WhatsApp Business Calling API?
The Calling API is a feature of the official WhatsApp API that enables voice communication between businesses and customers directly in WhatsApp. It turns the business number into a two-way, internet-based phone support channel integrated with company systems.
Calls Started by the User and by the Business
Meta’s official documentation describes two paths in the Calling API: from the customer to the business and from the business to the customer. User-initiated calls are available globally wherever the Cloud API operates, so customers can call the brand with no extra phone charges.
Business-initiated calls have some geographic restrictions. They are available in most countries, except when the business number is from the United States, Canada, Egypt, Vietnam, and Nigeria. The customer’s number can be from any country where the Cloud API works, as long as the business number’s country code is not on that list.
Opening the Customer Service Window
Like text messages, voice interactions directly affect the WhatsApp Business 24-hour window. Voice calls keep the channel open for support and sales without the need to send new paid templates.
According to Meta, a call made by the customer (answered or not), or a call the customer accepts, renews this customer service window. That gives the business a new 24-hour period to send free-form messages, which makes it easy to share links and documents and follow up after the call.
Technical Requirements for WhatsApp API Calling
To use voice calls, the business’s infrastructure must meet specific criteria set by Meta. Access depends on the number’s configuration, the account’s usage history, and settings in communication protocols.
Number Configuration and Limits
The first requirement concerns where the business phone number runs. According to Meta, the business number must be set up only on the official cloud infrastructure and cannot be used in the mobile app at the same time. Coexistence setups, where the number stays in the WhatsApp Business app, do not support calling features.
Beyond a dedicated connection, the business account needs an established sending history. Meta’s requirement is a messaging limit of at least 2,000 unique daily recipients. Businesses on WhatsApp need to scale their sending capacity before they can access advanced voice tools.
Webhooks and Media Protocols
The technical integration requires changes to the permissions of the app connected to the business platform. The system must subscribe to the webhook field called calls (except when using SIP) and have the whatsapp_business_messaging permission active. These settings make sure call start and end events flow correctly between the business and the customer.
The communication infrastructure offers flexibility for different IT architectures and follows specific audio and signaling standards:
- Standard call signaling runs through the Graph API with WebRTC media.
- For traditional telephony operations, there are options for SIP with WebRTC and SIP with SDES/SRTP media.
- Using SIP requires explicit enablement on Meta’s technical platform.
- Audio processing uses the OPUS codec, with additional support for PCMA and PCMU.
Already using the WhatsApp Business app?
With coexistence, the same number stays on the phone and also runs on the official API, with the ConverZAP AI agent for WhatsApp and a team inbox.
See how coexistence worksPermission Rules for Business-Initiated Calls
Meta sets strict opt-in guidelines to protect the customer experience and requires prior permission before a business can start voice calls through the official API. This control keeps operations compliant and lowers the risk of the number being blocked, since calls only go to people who showed real interest in support or consultative sales.
How to Request Call Permission
The business must obtain the customer’s explicit agreement before starting any call. According to Meta’s documentation, permission can be requested in three main ways: by sending a permission request (as a free-form message within the customer service window or through an approved template), through callback permission when the user calls the business, or directly from the WhatsApp Business profile. A well-structured AI knowledge base helps guide the text conversation to the right moment to ask for this permission.
There are strict limits on these requests to prevent spam. The platform allows at most one request every 24 hours and two requests within seven days per user. These counters reset as soon as a call connects successfully. When the operation uses vertical AI agents specialized in qualification, the system can be set to follow these rules automatically and send the permission template only when there is a safe margin.
Permission Types and Revocation
Once granted, permission for WhatsApp API calling falls into two categories: temporary and permanent. Temporary permissions last seven calendar days (168 hours), during which the business can make up to 100 connected calls every 24 hours to that specific contact. Since November 3, 2025, WhatsApp also offers permanent permission, which the customer can manage directly from the business profile. Being clear about these options builds user trust.
Final control always stays with the user, who can revoke access at any time. Beyond manual action, there are automatic safeguards: after two consecutive unanswered calls, WhatsApp shows a system message suggesting the customer reconsider the permission. If the number of consecutive ignored calls reaches four, the platform revokes the approval automatically, and a new opt-in is required to resume voice communication.
How to Promote Your Voice Channel
Making the call option easy to reach increases engagement and improves the support experience. For customers to use calling, businesses need to signal clearly that it is available at everyday touchpoints.
Call Buttons in Messages
According to Meta, the business can promote its voice channel by sending an interactive message with a call button within the customer service window, or through a template with a voice_call button. The button text allows up to 20 characters, which calls for direct calls to action such as “Talk to an agent”. Using WhatsApp interactive buttons speeds up the move from text to voice in complex support cases.
The technical setup lets the business define a specific validity period for the button. The accepted range is 1 minute to 43,200 minutes (30 days), which helps control customer service flow and keeps customers from calling about offers or campaigns that have already ended.
Using Deep Links
Beyond in-app interactions, promotion can include direct links, known as deep links. These links can be embedded in company websites, external apps, and even video descriptions, sending audiences from third-party platforms straight to the WhatsApp call screen.
When the link is tapped, the user’s device opens WhatsApp and prepares the voice call to the business’s official number automatically. This tactic reduces friction and works well for consultative sales campaigns, where customers want immediate help without having to save the contact on their phone.
Voice Call Costs and Billing
The Calling API pricing model differs significantly from regular text messaging on the platform. Instead of focusing only on 24-hour windows, Meta bases call costs on who started the contact and on the exact duration of the voice interaction.
Free Calls vs. Paid Calls
All user-initiated calls are free for the business. When a customer decides to call the business’s official number, receiving that call generates no voice charges from the platform. This model encourages businesses to offer phone support through WhatsApp as an accessible support channel.
Calls made by the business, on the other hand, are charged. According to Meta, outbound calls are billed by duration, counted strictly in six-second increments. This precision aligns costs with actual support time, which matters when planning a WhatsApp virtual assistant focused on qualification or advanced support.
What Affects the Price
The final cost of an outbound call varies with the country code of the number called and the account’s monthly call volume tier. To project these costs and assess the financial viability of voice operations, managers can use the API cost calculator to simulate the rates for the destination market. Note that the official documentation requires a Cloud API-only number to enable calls, so numbers connected through WhatsApp coexistence (using the app and the API at the same time) do not support voice.
Beyond call time, businesses need to budget for call permission requests. Because the brand needs prior permission to call the customer, sending that request, whether by template or free-form message, is charged separately under Meta’s standard message pricing, which is per delivered message, by category and by the recipient’s country (see the official pricing page). Planning these requests well optimizes the budget and avoids sending too many notifications.
Use Cases for WhatsApp API Calling
Voice integration expands customer service options, making WhatsApp API calling a good fit for situations that need direct conversation. The feature lets businesses build flows where the move from text to voice is seamless, handling requests that depend on speed and clarity.
Technical Support and Complex Issues
Problems that need detailed explanations are resolved faster by voice. When a customer runs into a software setup failure or a fault in physical equipment, a text exchange drags out response time. Switching to a call lets agents guide the user in real time and confirm each step instantly.
This approach reduces customer frustration in urgent cases or ones that are hard to explain in text. Situations such as locked bank accounts, lost access, or insurance claims cause anxiety, and direct contact conveys confidence. The support team can quickly understand the context, adapt its approach to calm the situation, and speed up resolution.
Consultative Sales and Negotiations
A voice channel allows a more human touch in high-value sales. Complex products and services, such as real estate, industrial equipment, or B2B software packages, rarely close through automated conversations alone. Sales reps use calls to build relationships, understand the prospect’s specific pain points, and present tailored proposals.
The feature also makes it easier to clear up final questions before a contract is signed. Instead of relying on long emails or asynchronous voice notes, the sales executive calls to review clauses, align delivery dates, and discuss payment terms. This speed helps overcome last-minute objections, raising conversion rates and shortening the sales cycle.
Best Practices for Implementing Calls
Following solid usage guidelines helps maintain voice channel quality and avoid penalties. When implementing WhatsApp API calling, following Meta’s rules and focusing on the customer experience lowers the risk of blocks and improves the acceptance rate of business calls.
Clear Opt-In and Opt-Out
Prior consent is the foundation for using a business voice channel safely. Under the Business Messaging Policy, according to Meta, best practice is to obtain a separate opt-in specifically for calls. This extra step confirms the customer really wants voice contact and separates call permission from the standard permission to receive text messages.
Beyond requesting initial permission, the business must give clear instructions so people can easily stop receiving calls. The opt-out process should be simple and transparent, letting users change their contact preference at any time. Making it easy to leave reduces customer frustration and lowers the chance of reports against the business number.
Managing Unanswered Calls
Excessive persistence hurts brand reputation and triggers the platform’s strict protection mechanisms. The Calling API documentation states that after two consecutive unanswered calls, the system sends the user an automatic message to reconsider the permission. After four failed attempts in a row, the previously approved permission is revoked automatically.
When customers are unavailable, the best operational strategy is to alternate communication formats. Instead of calling again and again, the support team should use text messages to follow up on missed calls. Sending a note about the missed call helps find a better time for the next attempt, keeps the permission active, and maintains a healthy relationship.
Common Questions About WhatsApp API Calling
To clarify the main technical and commercial points of WhatsApp API calling, here are the questions managers and customer service teams ask most. The answers help structure voice operations safely and in line with Meta’s requirements.
Can the Business Call Any Customer?
No. Starting a voice call requires the customer to grant explicit permission in advance. According to Meta’s official documentation, this permission can be temporary, valid for seven calendar days, or permanent.
The request happens right in the conversation, through free-form messages within the customer service window or specific templates. When a customer accumulates four consecutive unanswered calls, the system automatically revokes the permission granted earlier.
Does a Coexistence Number Support Calls?
Numbers connected through coexistence, which run on both the platform and the mobile app, cannot enable voice features. Meta’s infrastructure requires Cloud API-only use to unlock calling.
Among the technical prerequisites, the number must be fully migrated to the cloud environment. The business account must also have a daily messaging limit of at least 2,000 unique recipients to use calling features.
How Are Business-Initiated Calls Billed?
Calls started by the brand are billed by duration, measured in six-second increments. The final price also varies with the country code of the destination number and the monthly volume tier the account reaches.
Messages sent to request call permission follow the standard pricing for templates or free-form messages. To estimate the exact costs of the operation, use the cost calculator for the official API.
Does the Customer Pay to Call the Business?
For the customer, it works like any other WhatsApp voice call, using only mobile data or Wi-Fi. For the business, all user-initiated calls are free, with no per-minute charge.
An extra benefit of receiving calls is that they renew messaging sessions. Every time a customer calls the brand, even if the call is not answered, the system automatically opens a new 24-hour customer service window.
Frequently Asked Questions
Webhooks notify your system in real time about call events, such as when a voice call starts, is answered, or ends. This lets you log the call history and trigger follow-up automations in your CRM.
Recording depends on the infrastructure and the integration system connected to the API, and the business must follow applicable law and inform the user in advance. The platform handles media transmission, but storage and legal compliance are the business’s responsibility.
In the typical setup, yes: voice calls on the WhatsApp API are routed to human agents on your customer service or support team. Unlike chat, artificial intelligence handles qualification and triage beforehand, and the call itself connects the customer to a real person.
Because the channel uses data-based VoIP protocols, a stable, low-latency internet connection is essential to avoid audio dropouts. Wired networks or robust business Wi-Fi are recommended on agents’ devices.
Yes. Integrated platforms log voice call events directly in the customer service panel alongside the message history. Any agent on the team can see whether there was a call attempt, missed calls, or earlier voice conversations.
Conclusion
Adding voice through Meta’s official API transforms business communication, letting automation and human customer service work side by side on WhatsApp. With the right structure, a business optimizes its operation, cuts response times, and scales results securely.
To put this into practice with AI agents and the official WhatsApp API, take a look at ConverZAP.
Combine AI agents with your WhatsApp support
ConverZAP, a Tech Provider verified by Meta, runs AI agents and a team inbox on the official WhatsApp API, so people step in when a conversation needs them.
Start your free trialSee AI customer support
