Skip to main content
Version: Current

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 Capabilities​

Process Data Support​

info

This activity supports dynamic configuration using values from the Process Data drawer.

You can bind values from Model Data, Form Data, System Data, Enterprise Variables, and activity outputs.

Learn more → Using Process Data

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:

  • Text
  • Image
  • Video
  • Audio
  • Document
  • Sticker

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

Wait All Incoming​

Execution Control

Controls how the activity behaves when multiple incoming execution paths converge.

Determines whether the activity executes when:

  • any incoming execution path completes, or
  • all relevant execution paths complete before execution

Learn more → Execution Control

On Error​

Error Handling Strategy

Defines how the workflow behaves if this activity encounters a runtime error.

Supported strategies include:

  • Fault
  • Continue
  • Suspend
  • Retry

Learn more → Error Handling

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​

note
  • 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.