Send Notifications to WhatsApp

Send workflow notifications through a configured WhatsApp integration.

WhatsApp Cloud Send Message sends a text message through Meta’s WhatsApp Cloud API. The action requires a saved connection containing the access token, a Meta phone number ID, a recipient phone number, and message text. It does not implement a template-message editor in this action.

Prepare the WhatsApp connection

  • Obtain a suitable WhatsApp Cloud API access token and phone number ID from your Meta developer setup.
  • Open Agent Workflows → Connections → Add New.
  • Set Integration to whatsapp, enter a label, and choose API Key for the access token.
  • Enter the token in the API Key field and save the connection. The built-in verifier recognizes the whatsapp identifier and checks the token during creation.
  • Screenshot to add: WhatsApp API Key connection setup

    Configure WhatsApp Cloud Send Message

  • Add the WhatsApp Cloud Send Message action to your workflow.
  • Choose the saved connection in WhatsApp access token connection.
  • Enter Phone number ID (from Meta).
  • Enter the recipient in Recipient phone (digits, country code, no +). The action removes non-digit characters before sending.
  • Enter the message in Message (supports {{trigger.fields.*}} tokens). Trigger field tokens can be interpolated before the action runs.
  • Save the workflow and test with a recipient and message you are authorized to contact.
  • Screenshot to add: WhatsApp Cloud Send Message action fields

    Understand the result

    The action sends a JSON text-message request to Meta’s Graph API and returns a success or error result, including the HTTP status when available. A successful API response does not guarantee that a person read the message. Review the node result and the provider’s message status separately when diagnosing delivery issues.

    Use a controlled test and avoid including credentials or unnecessary personal data in message text. For credential masking and connection management, see Manage Workflow Connections.