WhatsApp Business Platform API

Use this Actor to build your own WhatsApp Business product — connect customers’ numbers, create templates, send messages — without applying as a Meta Tech Provider. Traffic goes through the Meta-approved watext.io Cloud API app.

You pay on Apify. There is no watext.io signup and no API key. Direct REST to watext.io is disabled. Meta tokens never appear in Actor input.

Each Apify user gets a workspace. Each WhatsApp number you connect belongs to that workspace.

Build your own panel

1. Run this Actor with createConnectSession and a returnUrl on your site
2. Open the returned watext.io URL in the browser — Facebook login runs there
3. Run createTemplate / syncTemplates / send

One-time setup

Rent this Actor on Apify. That is the whole setup. Do not paste a Meta token or a watext.io key.

Actions

action	What it does
getConfig	Meta appId + Embedded Signup config_id - only if you run FB.login on your own domain
createConnectSession	Returns a https://watext.io/connect/whatsapp?session=… URL. Open it in a popup or redirect
connectNumber	Finish connect from your own FB.login: code, wabaId, phoneNumberId
listNumbers	Numbers in your workspace (no tokens)
disconnectNumber	Drop Cloud API access for a number (id)
getTemplateOptions	Languages, categories, formats, header types, buttons - same as the New template screen
createTemplate	Full template builder submit (language, format, header type/media, buttons, catalog/carousel/LTO)
saveTemplate	Save as draft without submitting to Meta
syncTemplates	Refresh template approval status from Meta
listTemplates	Templates, statuses, and builder fields
send	Send an approved template or a 24-hour session text

Connect WhatsApp (hosted Facebook login)

Do not run FB.login on your SaaS domain. Apify cannot open Facebook popups. Your backend asks for a session, then the browser opens watext.io:

{
  "action": "createConnectSession",
  "returnUrl": "https://your-saas.com/settings/whatsapp"
}

Open url from the result (https://watext.io/connect/whatsapp?session=…). Listen for postMessage from https://watext.io (watext-whatsapp-connected) or handle returnUrl?whatsapp=connected&id=….

connectNumber is only for the rare case where your domain is already on the Meta app allowlist and you run Embedded Signup yourself.

Create a template

Same as the watext New template screen - including Add button → Copy offer code (coupon). Every builder button type is valid: URL, phone, WhatsApp call, quick reply, copy code.

{
  "action": "createTemplate",
  "name": "spring_sale_2026",
  "language": "en",
  "category": "MARKETING",
  "format": "standard",
  "headerType": "image",
  "headerMedia": "https://cdn.example.com/hero.jpg",
  "body": "Hello {{1}}, use code SAVE20 at checkout.",
  "footer": "Powered by Watext.io",
  "buttons": [
    { "type": "URL", "text": "Shop", "url": "https://example.com" },
    { "type": "PHONE_NUMBER", "text": "Call", "phone_number": "+905321234567" },
    { "type": "VOICE_CALL", "text": "WhatsApp", "ttl_minutes": 10080 },
    { "type": "QUICK_REPLY", "text": "Help" },
    { "type": "COPY_CODE", "text": "Copy code", "example": "SAVE20" }
  ]
}

COPY_CODE is the coupon / offer-code button from the builder (example = “Offer code example”). Shorthand: "copyCode": "SAVE20" (or couponCode) adds that button if you omit it from buttons.

Limited-time offer (builder LTO: offer text, expiration, copy code, URL):

{
  "action": "createTemplate",
  "name": "flash_sale_lto",
  "language": "en",
  "category": "MARKETING",
  "format": "limited_time_offer",
  "body": "Offer ends soon.",
  "ltoText": "Expiring offer!",
  "ltoHasExpiration": true,
  "ltoCopyCodeExample": "OFFER25",
  "ltoUrlButtonText": "Shop now",
  "ltoUrl": "https://example.com/offer?code={{1}}",
  "ltoUrlExample": "https://example.com/offer?ref=abc",
  "ltoHeaderFormat": "IMAGE",
  "ltoHeaderMedia": "https://cdn.example.com/lto.jpg"
}

Catalog uses catalogId. Carousel uses carouselCards. saveAsDraft: true is Save as draft. GET /api/v1/templates/options is the same options list the New template screen loads.

Send

{
  "action": "send",
  "to": "+905321234567",
  "templateName": "welcome_message",
  "languageCode": "en",
  "parameters": ["Ahmet"]
}

Input fields

Field	Required	Description
action	Yes	Prefer setting it explicitly (createConnectSession, createTemplate, send, …)
code, wabaId, phoneNumberId	connectNumber	From Embedded Signup if you run Facebook login yourself
returnUrl	createConnectSession	Required https URL on your site. After connect we redirect here with ?whatsapp=connected&id=
id	disconnectNumber	Number id from listNumbers
name, language, category, format, headerType, body	createTemplate	Same as the New template form
headerMedia	image/video/pdf/gif	data URL or https URL; or draft.headerMediaHandle after /templates/media
buttons	No	URL, PHONE_NUMBER, VOICE_CALL, QUICK_REPLY, COPY_CODE (coupon; example is the code)
copyCode / couponCode	No	Adds the Copy offer code button (SAVE20) if it is not already in buttons
catalogId, carouselCards, ltoCopyCodeExample, draft	catalog/carousel/LTO	Same fields as the builder
saveAsDraft	No	true = Save as draft
to, templateName or text	send	Recipient + approved template or session text
from	No	Number id when the workspace has more than one line

Direct REST to watext.io is disabled (402). Call this Actor from your backend. See ../README.md in the repo.

Pricing

On Apify, a successful send may be charged as message-sent. Connect/template calls are not that event. Meta conversation fees are billed by Meta on the WhatsApp Business Account you connected.

Policy

• Recipients must be valid international WhatsApp numbers
• Templates must be approved before send
• Session text only works inside the 24-hour window
• Do not use this for spam or anything that violates WhatsApp Business Policy

Troubleshooting

Error	What to do
API keys from watext.io are disabled	Do not send apiKey. Run the Actor on Apify.
This Actor must run on Apify	Use Apify Console / API, not a local script without APIFY_USER_ID
No connected WhatsApp number	createConnectSession, open the returned URL, then retry
Approved template … was not found	createTemplate + syncTemplates, wait for APPROVED
HTML 502 / Cloudflare	watext.io API blocked or down - retry later
input_schema.json is not json file	Rebuild from latest main. Schema on 0.2.2+ is valid JSON