Integration
WhatsApp Cloud API (Meta) voice AI integration
The WhatsApp Cloud API (Meta) integration connects your AI voice and chat agents to WhatsApp Cloud API (Meta), so they can read whatsapp messages on a live call. It's a messaging connector that runs as a tool the agent calls mid-conversation — you connect with an api key, attach it to an agent, and it acts in real time without a human in the loop.
Last updated 2026-09-16
What your agent can do with WhatsApp Cloud API (Meta)
Read the most recent WhatsApp messages exchanged with a contact — each with its sender and timestamp. Use during a call to recall what the user has sent you over WhatsApp.
Inputs
| Field | Type | Description |
|---|---|---|
| limit | integer | How many recent messages to return (default 10, max 50). |
| to | string | Contact phone number with country code, e.g. +919876543210. Omit to use the current caller. |
List approved WhatsApp message templates and their variables.
Send an approved WhatsApp template message (works outside the 24-hour window). Fill the template variables in order.
Inputs
| Field | Type | Description |
|---|---|---|
| button_copy_code | string | Only for a template with a COPY_CODE (offer / coupon) button — this is the code the recipient taps to copy, e.g. SAVE20. Leave empty for a URL button, a quick-reply button, or no buttons. |
| button_copy_code_index | string | Which button the code belongs to, counting from 0, when the template has more than one. Leave empty if the copy-code button is the first one. |
| button_index | string | Leave empty unless the template has more than one button. WhatsApp numbers buttons from 0 in the order they appear on the template, and the value above fills the one you name here — naming the wrong one sends a working link on the wrong button. |
| button_url_suffix | string | Only for a template whose URL button ends in a placeholder — this is the part appended to the button's URL. Leave empty for a static button, a quick-reply button, or no buttons. |
| header_media | string | Public URL of the file shown in the template header. Only for templates whose header is an IMAGE, VIDEO or DOCUMENT. WhatsApp fetches it at send time, so it must be reachable without a login. |
| header_media_type | string | Usually left empty — it is worked out from the URL. Set it when the link has no file extension (a signed CDN URL), because WhatsApp needs the right type or it rejects the send. |
| header_text | string | Only for a template whose header is TEXT and contains a placeholder — e.g. a header reading "Hi {{1}}". This is the value that fills it. Leave empty for a media header, a static header, or no header. |
| language | string | Language code, e.g. en or en_US |
| template* | string | Approved template name |
| to* | string | Recipient phone with country code, e.g. +919876543210 |
| variables | array | Body variable values in order ({{1}},{{2}},…) |
Send a WhatsApp message to a phone number. Use for confirmations, payment links, addresses, or any details the caller should have in writing.
Inputs
| Field | Type | Description |
|---|---|---|
| message* | string | The exact message text to send |
| to* | string | Recipient phone number with country code, e.g. +919876543210 |
What you'll need to connect WhatsApp Cloud API (Meta)
Connect with an API key. In Telenow, open Integrations → WhatsApp Cloud API (Meta) and provide:
- Permanent access token
- Phone number ID
- WhatsApp Business Account ID — From Meta Business Manager → WhatsApp Accounts. Enables fetching + sending message templates.
- Meta App ID (optional) — From developers.facebook.com → your app → Settings → Basic. Only needed to create templates with an image, video or document header — those upload their sample file to the app that owns the number.
Agent templates that use WhatsApp Cloud API (Meta)
Other Messaging integrations
Frequently asked questions
What can an AI voice agent do with WhatsApp Cloud API (Meta)?+
During a live call or chat, a Telenow agent can read whatsapp messages, list whatsapp templates, send whatsapp template, and send whatsapp message — each runs as a tool the agent calls mid-conversation, so it acts on WhatsApp Cloud API (Meta) in real time without a human.
How do you connect WhatsApp Cloud API (Meta) to Telenow?+
In Telenow, open Integrations, pick WhatsApp Cloud API (Meta), and you paste a WhatsApp Cloud API (Meta) API key into the connection, then bind it to your agent. Then add its messaging tool to your agent (or install a template that already includes it) and you're live.
Which AI agent templates use WhatsApp Cloud API (Meta)?+
Real-estate site-visit booker, Abandoned-cart win-back, Salon & spa booking, Payment-reminder collections, Delivery scheduling & reschedule, Courier pickup booking, Restaurant feedback & loyalty, Event RSVP & registration, Hotel reservation desk, Appointment reminder & confirmation, Prescription refill line, Clinic no-show win-back, Restaurant table reservation, Food ordering & takeaway, Auto service scheduler, Auto service reminder, COD order confirmation, Return & refund intake, Failed delivery resolution (NDR), Insurance renewal reminder, Gym membership win-back, Class & session booking, Travel enquiry & booking, Flight change & rebook, Telecom plan renewal & upgrade, Rent payment reminder, School fee reminder, Clinic appointment booking (India), and Utility bill reminder (India) all use WhatsApp Cloud API (Meta). You can install any of them and connect your WhatsApp Cloud API (Meta) account in a couple of clicks.
Does WhatsApp Cloud API (Meta) work on phone calls and WhatsApp?+
Yes. Telenow agents run on phone, web, chat and WhatsApp, and WhatsApp Cloud API (Meta) works the same across every channel — the agent calls it whenever the conversation needs it.
How much does the WhatsApp Cloud API (Meta) integration cost?+
Connecting WhatsApp Cloud API (Meta) is included — you only pay Telenow's transparent per-minute and per-component usage, and new accounts get free signup credit to try it.
Connect WhatsApp Cloud API (Meta) to your AI voice agent
Sign up free and get $0.99 in credit — no card required. Connect your number, pick a template, and go live in minutes.