Calling is available on WhatsApp Business accounts connected to OTPIQ. If you have not connected an account yet, follow How to connect WhatsApp API.
What is WhatsApp Business Calling?
WhatsApp Business Calling is Meta’s voice feature for the WhatsApp Business Platform. In OTPIQ, agents answer and place calls from the WhatsApp inbox in the browser using WebRTC (your microphone and speakers). There are two call directions:| Direction | Who starts the call | Permission required? | Typical use |
|---|---|---|---|
| User-initiated | The customer calls your business number | No extra permission from you | Support, sales follow-up after the customer taps Call |
| Business-initiated | Your team calls the customer from the inbox | Yes — the customer must grant call permission first | Proactive support, order help, scheduled callbacks |
What you need
Before you can use WhatsApp calling in OTPIQ, confirm the following:Connected WhatsApp account
A WhatsApp Business account and phone number linked to your project via embedded signup.
Calling enabled
Voice calling must be enabled on the business phone number. OTPIQ configures this for connected accounts; contact support if the call button never appears.
Browser and microphone
Use a modern desktop browser and allow microphone access. Outbound calls cannot start without a working mic.
Project credit (outbound)
Business-initiated calls are billed per minute. Prepaid projects need enough balance to cover at least one minute before dialing.
- An approved call permission request template
- The customer’s Accept response (temporary or permanent)
- Permission that is still valid when you dial (temporary grants expire)
Call permission explained
WhatsApp does not let businesses cold-call customers. For outbound WhatsApp calls, the recipient must explicitly allow your business to call them.How customers grant permission
- You send a call permission request template from OTPIQ.
- WhatsApp shows the customer Accept and Decline actions automatically (you do not add buttons yourself).
- If they Accept, they can choose:
- Temporary — usually valid for about 7 days
- Permanent — until they revoke it in WhatsApp settings
- The reply appears in the inbox conversation (granted, declined, and expiry when temporary).
- After Accept, use the Call button in that chat to place the call.
Call permission request templates
A call permission request is a special WhatsApp template type. Meta rules for this template:| Rule | Detail |
|---|---|
| Category | Must be Utility (fixed by Meta) |
| Body | Required — explain why you want to call |
| Header / footer | Optional text only (no media header) |
| Buttons | Not allowed — WhatsApp adds Accept / Decline for you |
| Variables | You can use {{1}}, {{2}}, … in header or body (for example order ID or name) |
| Approval | Must be Approved by Meta before you can send it |
Set up business-initiated calling
Connect WhatsApp to OTPIQ
Complete embedded signup so your WABA and phone number appear in the project.
Create a call permission template
In the dashboard, open your WhatsApp templates and create a new template with type Call permission.
- Category is locked to Utility
- Write a clear body (and optional header/footer)
- Submit for Meta review
Wait until the template status is Approved before sending it to customers.
Send the request to a contact
Open the conversation in the WhatsApp inbox and send the approved call permission template.If you press Call without permission, OTPIQ opens a dialog where you can select an approved template and send it immediately.
Wait for Accept
When the contact taps Allow, the conversation shows that call permission was granted (temporary with an expiry, or permanent).
Receiving customer calls
When a customer calls your WhatsApp business number:- An incoming call notification appears in the OTPIQ inbox.
- An agent accepts or rejects the call.
- On accept, the browser sets up the voice session (microphone required).
- Either side can end the call; the conversation timeline records the call event.
User-initiated calls do not require a call permission template. Permission is only for when your business starts the call.
Pricing and billing
Business-initiated WhatsApp calls are charged per minute, based on the destination market of the number you call.- Billing starts when the call is answered and connected.
- Duration is rounded up to whole minutes (a short answered call still bills at least one minute).
- Prepaid projects must have enough credit for at least the first minute before dialing; if balance runs out during a call, the call may be ended automatically.
- Rates depend on the callee’s country/market — check the rate shown in the inbox when you start an outbound call.
Incoming (user-initiated) call handling in the inbox does not use the same outbound per-minute charge model. Focus outbound budget planning on business-initiated calls.
Common issues
“Call permission required” when I try to call
“Call permission required” when I try to call
The contact has not granted permission yet, or temporary permission expired. Send an approved call permission request template and wait for Accept, then call again.
I have no call permission template to send
I have no call permission template to send
Create a Call permission template under WhatsApp templates, submit it, and wait for Meta to mark it Approved. Pending or rejected templates cannot be sent for calling consent.
Microphone or network errors
Microphone or network errors
Allow microphone access in the browser. Use a stable network. Corporate firewalls that block WebRTC/STUN can prevent call setup — try another network or contact OTPIQ support if calls never connect.
Insufficient credit
Insufficient credit
Top up your project balance. Outbound calls need enough prepaid credit for at least one minute at the destination rate before dialing.
Customer declined permission
Customer declined permission
You cannot place a business-initiated call until they Accept a new request. Send another permission template only when it is appropriate (for example after they ask for a callback).
Related guides
Connect WhatsApp API
Link your WhatsApp Business account to OTPIQ with embedded signup.
WhatsApp messaging limits
Understand quality ratings and daily messaging tiers for your number.
Connection errors
Fix currency, payment method, and WABA errors during signup.
What is WhatsApp Business API?
Overview of templates, categories, and how the platform works.