;}%20.st6{fill:url(%23SVGID_00000021089067129159788970000008246765442136188072_);}%20.st7{fill:url(%23SVGID_00000117639240116366130650000015074833605515028638_);}%20.st8{opacity:0.4;fill:url(%23SVGID_00000101781798616409025840000016567063639337360777_);}%20.st9{opacity:0.4;fill:url(%23SVGID_00000052086836598721292040000002033117744178971046_);}%20.st10{opacity:0.4;fill:url(%23SVGID_00000159460939004760751800000002448009281983951536_);}%20.st11{opacity:0.4;fill:url(%23SVGID_00000013177830667419993080000017721442101626521532_);}%20.st12{opacity:0.4;fill:url(%23SVGID_00000152235521444854938490000006526001119318383285_);}%20.st13{opacity:0.4;fill:url(%23SVGID_00000119823135212293698520000012774889010992664993_);}%20%3c/style%3e%3cg%3e%3cpolygon%20class='st2'%20points='134.78,14.22%20114.31,48.21%20101.33,69.75%20158.22,69.75%20177.97,36.95%20191.67,14.22%20'/%3e%3cpolygon%20class='st3'%20points='227.55,69.75%20186.61,69.75%20101.33,69.75%20129.78,119.02%20158.16,119.02%20228.61,119.02%20256,119.02%20'/%3e%3cpolygon%20class='st3'%20points='136.93,132.47%20116.46,167.93%2073.82,241.78%20130.71,241.78%20144.9,217.2%20180.13,156.18%20193.82,132.46%20'/%3e%3cpolygon%20class='st3'%20points='121.7,131.95%20101.23,96.49%2058.59,22.63%2030.15,71.91%2044.34,96.49%2079.57,157.5%2093.26,181.22%20'/%3e%3cpolygon%20class='st2'%20points='64.81,131.95%2025.15,131.21%200,130.74%2028.44,180.01%2066.73,180.72%2093.26,181.21%20'/%3e%3cpolygon%20class='st2'%20points='165.38,181.74%20184.58,216.46%20196.75,238.47%20225.19,189.2%20206.66,155.69%20193.83,132.46%20'/%3e%3c/g%3e%3c/svg%3e)
Windmill HubWhatsApp Business
Communication Meta access tokenSend WhatsApp messages and templates, and manage phone numbers, through the WhatsApp Business Cloud API from any Windmill script, flow or app.
Set up in 3 steps
Set up a Meta app
In the Meta developer console, add the WhatsApp product to an app. Its setup page shows the phone number id, the business account id and a temporary token — generate a permanent one from a system user for anything scheduled.
Add the resource in Windmill
Open Resources, add a resource of type whatsapp_business, and fill token, phone_number_id and business_account_id. api_version pins the Graph API version.
Run your first script
Fork any script below and read before writing anything.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Upload Media
Update Business Profile
Send Text Message
Send Template Message
Send Reaction
Send Media Message
Send Location Message
Send Interactive Message
Mark Message as Read
List Phone Numbers
List Message Templates
Get Media URL
Get Business Profile
Download Media
Delete Message Template
Delete Media
Create Message Template
Resource type
whatsapp_business — the shape of the credential every script on this page expects.
| Field | Type | Required | What it is |
|---|---|---|---|
| api_version | string | No | Graph API version to use, e.g. 'v25.0' (optional, defaults to v25.0) |
| business_account_id | string | Yes | WhatsApp Business Account (WABA) ID, used for template and phone number management. Found in the app dashboard under WhatsApp > API Setup |
| phone_number_id | string | Yes | ID of the WhatsApp business phone number used to send messages (not the phone number itself). Found in the app dashboard under WhatsApp > API Setup |
| token | string | Yes | Permanent access token of a Meta Business System User with whatsapp_business_messaging and whatsapp_business_management permissions. Create it in Meta Business Settings > Users > System Users (https://business.facebook.com/settings/system-users), or use a temporary token from the app dashboard (https://developers.facebook.com/apps > WhatsApp > API Setup) for testing |
Questions
The token expires after 24 hours
The one the setup page shows does. Create a system user in Business Settings and generate a permanent token for it instead.
A message to a new contact is not delivered
Outside a 24-hour customer service window, WhatsApp only accepts approved message templates — free-form text is rejected.
Is my token stored on the hub?
Never. It lives only in your own Windmill workspace, encrypted at rest.