Send WhatsApp Message
Description
Sends a message to a WhatsApp recipient using the WhatsApp Business Platform.
The activity supports multiple message types including text, image, video, audio, document, and sticker messages. Media content can be sent using either previously uploaded WhatsApp media identifiers or publicly accessible media URLs.
Common settings
Use Process Data to bind supported inputs to workflow values or upstream outputs. See Common Activity Features for shared execution, error-handling, and output-persistence settings. Availability depends on the activity.
Design-Time Configuration
Connection Name
Specifies the WhatsApp connection used for authentication and API communication.
To
Specifies the recipient WhatsApp phone number including the country code.
Example:
+14155552671
Message Type
Specifies the type of WhatsApp message to send.
Supported values include:
TextImageVideoAudioDocumentSticker
The selected message type determines which additional configuration fields are applicable.
Message Body
Specifies the text content of the message.
This field is primarily used when the message type is set to Text.
Media ID
Specifies the WhatsApp media identifier of previously uploaded media.
This field is used for media-based message types such as image, video, audio, document, and sticker messages.
Media can be uploaded beforehand using the Upload WhatsApp Media activity.
Media URL
Specifies a publicly accessible URL for the media file to be sent.
If both Media ID and Media URL are provided, the Media ID value takes precedence.
Caption
Specifies optional caption text for supported media message types such as image, video, and document messages.
Filename
Specifies the filename displayed for document messages.
Voice
Indicates whether an audio message should be treated as a WhatsApp voice message.
Preview URL
Enables or disables URL preview generation for text messages containing links.
Default value: false
Execution settings
Configure Wait All Incoming when execution paths converge, and On Error for failure handling. Select Inherit where available to use the workflow-level error policy.
Fields by message type
| Message Type | Content to provide | Additional options |
|---|---|---|
| Text | Message Body | Preview URL |
| Image or Video | Media ID or public Media URL | Caption |
| Audio | Media ID or public Media URL | Voice |
| Document | Media ID or public Media URL | Caption, Filename |
| Sticker | Media ID or public Media URL | — |
Select the WhatsApp connection associated with the sending business number. To send uploaded content, bind Upload WhatsApp Media → Media ID. To process media received from a customer, use Download WhatsApp Media → File with a file-consuming activity.
Example: Send a text update
Select Text, supply the recipient in To, and set Message Body to a short update. Enable Preview URL only when the text contains a link for which a preview is wanted. Inspect Message ID after sending; subsequent delivery/read events are reported by WhatsApp Trigger.
Outputs
Raw JSON Response
Contains the complete JSON response returned by the WhatsApp API.
Messaging Product
Represents the messaging platform used for the operation.
Typical value:
whatsapp
Contact Input
Represents the recipient phone number supplied as input.
Contact WhatsApp ID
Represents the unique WhatsApp identifier associated with the recipient.
Message ID
Represents the unique identifier generated for the sent WhatsApp message.
Notes
- The recipient phone number must be registered with WhatsApp.
- Media URLs must be publicly accessible by the WhatsApp platform.
- Certain media types and file sizes may be restricted by WhatsApp Business Platform limitations.
- URL previews are supported only for eligible text messages containing valid URLs.