Send customer messages through a connected Meta business phone number.
Explore 13 workflow actions for WhatsApp Business Cloud, including account permissions and operation limits.
3 read actions10 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Delete media
Write
Delete an uploaded WhatsApp media object belonging to the connected sender.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
Media deletion is irreversible. A lost response remains uncertain and is not automatically retried.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Download media
Read
Save one accessible WhatsApp media object into protected workflow storage.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
Files are limited to 16 MB. Only an authenticated Meta lookaside attachment URL is accepted.
Get business phone number
Read
Read the verified display number for the connected WhatsApp sender.
Permissions and limits
Account permissions
whatsapp_business_management
Get media metadata
Read
Read the type and size of a WhatsApp media object without exposing its temporary download URL.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
This reads metadata only. Use Download media to save bytes in protected workflow storage.
Mark message read
Write
Acknowledge one inbound WhatsApp message as read.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The ID must identify an inbound message for the connected number.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send approved template
Write
Send an approved WhatsApp template, with optional text substitutions in its body.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
Only body text substitutions are supported. Header media, named parameters, buttons, and authentication-template extras are not supported.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send audio
Write
Send an existing WhatsApp audio media ID to one opted-in recipient.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The media must already be accessible to the connected WhatsApp business account. This action does not upload it.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send document
Write
Send an existing WhatsApp document media ID to one opted-in recipient.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The media must already be accessible to the connected WhatsApp business account. This action does not upload it.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send image
Write
Send an existing WhatsApp image media ID to one opted-in recipient.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The media must already be accessible to the connected WhatsApp business account. This action does not upload it.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send message and wait for response
Write
Send a WhatsApp message with a signed NodeHub response-page link, then wait for approval, free text, or a custom form.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The recipient follows a signed link to NodeHub to answer. Replies typed directly in WhatsApp do not resume this wait. NodeHub must have a public HTTPS origin.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send text message
Write
Send one text message from the connected WhatsApp business number.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send video
Write
Send an existing WhatsApp video media ID to one opted-in recipient.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The media must already be accessible to the connected WhatsApp business account. This action does not upload it.
Meta accepts the request but delivery is confirmed separately through WhatsApp webhooks. A lost response remains uncertain and is never automatically resent.
Sending requires recipient opt-in and either an open customer-service window or an approved message template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Upload media
Write
Upload one protected image, audio, video, document or sticker file to the connected WhatsApp sender.
Permissions and limits
Account permissions
whatsapp_business_messaging
Operation limits
The protected-file limit is 16 MB, image limit 5 MB, sticker limit 100 KB. OGG audio needs codec inspection and is not accepted. Meta may reject unsupported video codecs.
A lost response remains uncertain and is never automatically resent.
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in WhatsApp Business Cloud. A saved workflow is not a completed provider action.
Messaging · CONNECTION
