Send messages, media, templates, and interactive content via the WhatsApp Business Cloud API from any workflow.
What this node does: The WhatsApp node connects to the Meta WhatsApp Business Cloud API. It provides 34 operations across 5 resources — message, media, template, profile, and group. All phone numbers must be in E.164 format (e.g.
+14155552671). Authentication requires an AccessToken and PhoneNumberId from your Meta/WhatsApp Business API setup.
Authentication
| Credential | Description |
|---|---|
AccessToken | Meta/WhatsApp Business API access token. Generated in Meta Business Manager under System Users. Long-lived tokens are recommended for production. |
PhoneNumberId | The numeric phone number ID assigned to your WhatsApp Business phone number in Meta's API. Found in the WhatsApp Business Manager under Phone Numbers. |
Resources and Operations
message — 15 Operations
| Operation | Description |
|---|---|
message/sendText | Send a plain text message to a phone number. Supports PreviewUrl to unfurl links. |
message/sendImage | Send an image by URL or base64. Optional caption. |
message/sendVideo | Send a video by URL or base64. Optional caption. |
message/sendAudio | Send an audio file by URL or base64. |
message/sendDocument | Send a document (PDF, DOCX, etc.) by URL or base64. Optional filename and caption. |
message/sendSticker | Send a WebP sticker by URL. |
message/sendLocation | Send a map pin with latitude, longitude, and optional name/address. |
message/sendContacts | Send a vCard-style contact or contact list as a JSON array. |
message/sendInteractiveButtons | Send a message with up to 3 quick-reply buttons (each with id and title). Optional header and footer. |
message/sendInteractiveList | Send a scrollable list with sections and rows. Customer taps a button to open the list. |
message/sendReaction | React to a specific message with a unicode emoji. |
message/sendTemplate | Send a pre-approved Meta template with language code and optional component parameters. |
message/sendAndWait | Send a message and suspend the workflow until a reply is received (or timeout). Used for approval and response-collection flows. |
message/markAsRead | Mark a received message as read by its MessageId. |
message/sendTypingIndicator | Show a typing indicator to the recipient before sending a follow-up message. |
media — 4 Operations
| Operation | Description |
|---|---|
media/upload | Upload a base64-encoded file to WhatsApp media hosting. Returns a MediaId for use in send operations. |
media/download | Download media by MediaId. Returns base64 file data. |
media/delete | Delete an uploaded media file by MediaId. |
media/getInfo | Retrieve metadata for a media file: mimeType, fileSize, url, sha256. |
template — 3 Operations
| Operation | Description |
|---|---|
template/create | Create a new message template for Meta approval review. Requires BusinessAccountId. |
template/list | List all templates for a Business Account with optional pagination. |
template/get | Retrieve a specific template by TemplateId. |
profile — 2 Operations
| Operation | Description |
|---|---|
profile/getContact | Get the contact profile of the phone number: name, phone, profilePictureUrl. |
profile/getBusinessProfile | Get the business profile: description, address, email, websites, vertical. |
group — 10 Operations
| Operation | Description |
|---|---|
group/create | Create a new group with a subject and initial participants (array of phone numbers). |
group/get | Get group metadata by GroupId. |
group/delete | Delete a group by GroupId. |
group/getMembers | List all members of a group. |
group/addMember | Add a phone number to a group. |
group/removeMember | Remove a phone number from a group. |
group/promoteAdmin | Promote a group member to admin. |
group/demoteAdmin | Demote a group admin to regular member. |
group/getInviteLink | Get the shareable invite link for a group. |
group/sendMessage | Send a text message to a group by GroupId. |
WhatsApp Business Cloud API — Setup
Before using this node, complete these steps in Meta's developer portal:
- Create a Meta App at developers.facebook.com and add the WhatsApp product.
- In WhatsApp > Getting Started, note your Phone Number ID and generate a temporary access token (or create a System User for a permanent long-lived token).
- Add a real phone number or use the sandbox test number for development.
- Submit your phone number for business verification if sending templates to non-test numbers.
- Store the
AccessTokenandPhoneNumberIdin BizFirst Credentials Manager and reference them in the node.
Phone number format: All recipient fields (To, PhoneNumber) must be E.164 format — a plus sign followed by the country code and number with no spaces, dashes, or parentheses. Example:
+14155552671. Messages sent to incorrectly formatted numbers will fail at the API level.
In This Guide
Configuration
Full properties table for all 34 operations organised by resource.
Input & Output
Output schemas per operation, sendAndWait suspend/resume behaviour, and webhook output fields.
Examples
Five examples: product catalog with interactive list, sendAndWait order flow, media upload and share, group announcement, and template appointment reminder.