WhatsApp Calling
Connect your WhatsApp Business number to Vomyra and your assistant can take and make WhatsApp voice calls. Customers call your number in WhatsApp and the assistant answers. You can also have the assistant call customers who have allowed it, one at a time, as a campaign, from a Google Sheet, or from your CRM through the API.
What you can do
Before you start
Connect a WhatsApp number
Connecting is enough for inbound calls: once an assistant is assigned, customers can call your number in WhatsApp and the assistant answers.
Connect and assign
Sign in with Meta and pick the assistant that answers
- 1Open WhatsApp - Click WhatsApp in the dashboard sidebar and stay on the WhatsApp numbers tab.
- 2Connect WhatsApp - Click Connect WhatsApp, sign in with Meta, and choose the business and the WhatsApp Business number to connect.
- 3Enter the two-step PIN if asked - If the number already has a two-step verification PIN, Vomyra asks for it once to activate the number. Find it in WhatsApp Manager under Account tools → Two-step verification. Leave two-step verification switched on.
- 4Assign an assistant - In the Agent column, pick the assistant that answers calls to this number. Until you do, calls are not answered.
- 5Check the number - Status should read Active, Events should read Subscribed, and Calling should read Enabled. If Calling reads Not enabled, switch calling on for the number at Meta and connect it again.
Number status
ActiveConnected with an assistant assigned. Ready to take calls.
Needs an agentConnected, but no assistant is assigned, so nothing answers yet.
Reconnect neededWhatsApp withdrew access. Connect the number again.
DisconnectedRemoved from Vomyra. Connect it again to use it.
Call customers on WhatsApp
A business can only call people who have allowed it. Vomyra checks with WhatsApp before every call: if the person has allowed calls, the assistant rings them straight away. If not, they are sent your call permission request, and you can call once they accept.
Set up outgoing calls
Choose a permission template, then test it
- 1Create the template in WhatsApp Manager - Create a Marketing or Utility template and add a Call permission request component. Templates are made at Meta, not in Vomyra. Wait for Meta to approve it.
- 2Choose it for your number - On the WhatsApp numbers tab, open the ⋮ menu on the number, go to Permission template, select the approved template, and click Save. The Calling column then shows Outgoing ready.
- 3Place a test call - In the same dialog, open Test call and enter a WhatsApp number with its country code. Place test call rings them if they have already allowed calls, and sends the permission request if they have not. Ask permission only sends the request without trying to call.
Inbound and outbound are set up separately. The Calling column shows Enabled for inbound, and Outgoing ready once a permission template is chosen.
Run a WhatsApp campaign
A campaign sends your permission request to everyone on a list, then calls each person who accepts, inside your calling hours.
Start a campaign
From the Campaigns tab on the WhatsApp page
- 1Open Campaigns - On the WhatsApp page, open the Campaigns tab and click Start Campaign.
- 2Name the campaign and choose the number - The name is only for your reference. Pick the connected WhatsApp number to call from.
- 3Choose the template and assistant - Select the call permission request template to send, and the assistant that speaks on the calls.
- 4Upload your list - Upload a CSV or Excel file with a whatsapp_user_id column holding each person's full international number. Download Sample file to see the format. Other columns are passed to the assistant.
- 5Set concurrency and start time - Choose how many calls run at once, then Start now or Schedule for later.
- 6Set calling hours - Choose the calling window and timezone (09:00 to 21:00 by default). Calls only happen inside the window. Permission requests go out straight away, so answers are ready when the window opens.
Manage a running campaign
Pause, resume, or cancel a campaign from its row, and download the results as a CSV. Progress shows how many people are awaiting permission, waiting to be called, called, failed, or cancelled.
Campaign limits
One WhatsApp campaign runs at a time per account. By default a campaign holds up to 100 rows, and a person who does not accept within 6 hours is not called. Concurrency above the platform limit is capped automatically.
Google Sheets follow-ups over WhatsApp
A Google Sheet connected to an assistant can place its scheduled follow-ups over WhatsApp. In the assistant's Google Sheets integration, set the call type to WhatsApp and choose the WhatsApp number. The number needs a call permission template.
Vomyra tracks each row in its own columns — whatsappCallStatus, whatsappRequestedAt, whatsappLastCheckedAt, and whatsappError — so you can see where every follow-up stands. The status column moves through:
New to sheet follow-ups? See the Google Sheets integration guide.
Call from your CRM
Place a WhatsApp call from your own system with your Vomyra API key. The request takes the same fields as the phone Initiate Call API, plus the WhatsApp number to call from. The customer's name and additionalData reach the assistant for the call.
curl -X POST "https://api.vomyra.com/v1/whatsapp/calls" \
-H "x-api-key: <api-key>" \
-H "Content-Type: application/json" \
-d '{
"customer_number": "9876543210",
"customer_country_code": "+91",
"customer_name": "Ravi",
"whatsapp_number": "+91 80000 12345",
"additional_data": { "order_id": "A-1029", "plan": "Pro" }
}'What the response tells you
initiatedHTTP 201The customer's WhatsApp is ringing and the assistant speaks when they answer.
permission_requestedHTTP 202The customer had not allowed calls, so your permission template was sent. Call again once they accept.
request_limit_reachedHTTP 409Returned as error.details.outcome: WhatsApp will not accept another permission request for this person yet.
WhatsApp rules to know
Permission comes first
WhatsApp only lets a business call people who have allowed it. Anyone who has not is sent your call permission template, and can accept or decline in WhatsApp.
Permission requests are limited
You can send one permission request per person per day, and two per week.
Permission can lapse
Permission a customer grants for a single conversation lapses after 7 days unless they made it permanent. After that, ask again.
Ringing is not answering
WhatsApp rings for a short while. If nobody picks up, the call ends on its own.
Troubleshooting
Calling shows Not enabled
Calling is not switched on for the number at Meta. Switch it on, then connect the number again.
Outgoing not set up
No call permission template is chosen. Pick an approved one under ⋮ → Permission template.
Start Campaign is greyed out
None of your connected numbers has calling switched on. Check the Calling column on the WhatsApp numbers tab.
Status shows Reconnect needed
WhatsApp withdrew access to the number. Click Connect WhatsApp and connect the same number again.
A call is refused with “has not granted permission”
The customer has not allowed calls, or their permission lapsed. Send a permission request and call once they accept.
WhatsApp page says it is turned off
WhatsApp calling is not enabled for your account. Contact your Vomyra administrator.
Related pages
Create Your First Assistant
Build and test the assistant that will speak on your WhatsApp calls.
Outbound Campaigns
Batch calling over phone lines, with Google Sheets or file upload.
Google Sheets Integration
Connect a sheet to an assistant for scheduled follow-ups.
Call Lifecycle
Call statuses and ended reasons, for WhatsApp and phone calls alike.