Send a Reaction Message

In this code snippet you learn how to send a WhatsApp reaction message using the Messages API. The WhatsApp reaction message type lets you react, using an emoji, to an inbound message that you have received.

AS well as the to and from numbers, this message type requires two key pieces of information:

  • The message_uuid of the message to be reacted to. This will be present in the body of the inbound message received.
  • The emoji used as the reaction. This can be the emoji character itself, for example 😀.

IMPORTANT: If a customer has not messaged you first, then the first time you send a message to a user, WhatsApp requires that the message contains a template. This is explained in more detail in the Understanding WhatsApp topic.

Example

Find the description for all variables used in each code snippet below:

KeyDescription
JWT

Used to authenticate your request. See Authentication for more information, including how to generate a JWT.

VONAGE_APPLICATION_ID

The Vonage Application ID.

VONAGE_PRIVATE_KEY_PATH

Private key path.

MESSAGES_API_URL

There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was https://api.nexmo.com/v0.1/messages, the new one is https://api.nexmo.com/v1/messages. For sandbox testing the Messages API endpoint is https://messages-sandbox.nexmo.com/v0.1/messages or https://messages-sandbox.nexmo.com/v1/messages, depending on which version you have set in the sandbox dashboard.

WHATSAPP_NUMBER

The WhatsApp number that has been allocated to you by Vonage. For sandbox testing the number is 14157386102.

TO_NUMBER

Replace with the number you are sending to. E.g. 447700900001

MESSAGE_UUID

The UUID of the specific message.

EMOJI

The emoji to send in the message.

NOTE: Don't use a leading + or 00 when entering a phone number, start with the country code, for example, 447700900000.

Prerequisites

If you do not have an application you can create one. Make sure you also configure your webhooks.

Write the code

Add the following to send-reaction.sh:

View full source

Run your code

Save this file to your machine and run it:

bash send-reaction.sh

Try it out

When you run the code a WhatsApp reaction message is sent to the destination number.