Skip to main content

WhatsApp Connector

The WhatsApp Connector is an outbound Connector that allows you to send messages to users from your BPMN process.

Prerequisites​

To start using the WhatsApp Connector, you must have an approved Meta WhatsApp application; follow the official guide to obtain one.

note

WhatsApp webhooks are currently not supported by Camunda.

Create a WhatsApp Connector task​

To use the WhatsApp Connector in your process, either change the type of existing task by clicking on it and using the wrench-shaped Change type context menu icon, or create a new Connector task by using the Append Connector context menu. Follow our guide to using Connectors to learn more.

Authentication​

The WhatsApp Connector supports authentication through Meta access tokens. Take a look at this blog post to learn more on how to obtain one for yourself.

Once the token is obtained, put it in the Access token field of the Authentication section.

note

Use Camunda secrets to avoid exposing your WhatsApp access token credentials as plain text. See our documentation on managing secrets to learn more.

Sender and recipient​

Your WhatsApp application can have multiple phone numbers registered. Set your phone number ID in the Sender phone number ID field of the Payload section. You can find the phone number ID at the Meta developer portal.

In the Recipient phone number field, enter a phone number you wish to send message to.

Select operation to execute​

You can select one of the following operations from the Message type dropdown.

Plain text​

When this option is selected, write any arbitrary text in the Message text field. This message will be sent to the target recipient.

Message template​

When this option is selected, it is implied that you already have an approved WhatsApp message template. Read more bout message templates at the official page.

  1. In the field Template name, set the name of your WhatsApp template. For example, my_delivery_scheduled_template.
  2. In the field Template language code, specify the language code of your template. For example, en_US.
  3. In the field Header variables, set the values for your variables only if the header has any. For example, {"type": "text","text": "My header param"}.
  4. In the field Body variables, set the values for your variables only if the body has any. For example, {"type": "text","text": "My body param"}.

See the official Meta guide for more information and examples.

Handle Connector response​

The WhatsApp Connector is a protocol Connector, meaning it is built on top of the HTTP REST Connector. Therefore, handling response is still applicable as described.