Enviar un mensaje de reacción

En este fragmento de código aprenderá a enviar un mensaje de reacción de WhatsApp utilizando Messages API. Los mensajes de WhatsApp reaction El tipo de mensaje te permite React, mediante un emoji, a un mensaje que hayas recibido.

Además de la to y from En cuanto a los Numbers, este tipo de mensaje requiere dos datos fundamentales:

  • El message_uuid del mensaje al que se desea reaccionar. Estará presente en el cuerpo del mensaje entrante recibido.
  • El emoji utilizado como reacción. Puede ser el propio carácter emoji, por ejemplo 😀.

IMPORTANTE: Si un cliente no le ha enviado un mensaje antes, la primera vez que envíe un mensaje a un usuario, WhatsApp exigirá que el mensaje contenga una plantilla. Esto se explica con más detalle en la Tema: Cómo funciona WhatsApp.

Ejemplo

A continuación encontrará la descripción de todas las variables utilizadas en cada fragmento de código:

ClaveDescripción
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.

NOTA: No utilice un + o 00 Al introducir un número de teléfono, empieza por el código de país; por ejemplo, 447700900000.

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Escriba el código

Añada lo siguiente a send-reaction.sh:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${WHATSAPP_SENDER_ID}'",
    "channel": "whatsapp",
    "message_type": "reaction",
    "reaction": {
      "action": "react",
      "emoji": "'${MESSAGES_EMOJI}'"
    },
    "context": {
        "message_uuid": "'${MESSAGES_MESSAGE_ID}'"
    }
  }'

Ver fuente completa

Ejecute su código

Guarde este archivo en su máquina y ejecútelo:

bash send-reaction.sh

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Añada lo siguiente a build.gradle:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Crea un archivo llamado SendWhatsappReaction y añade el siguiente código al método main:

val client = Vonage {
    applicationId(VONAGE_APPLICATION_ID)
    privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}

Ver fuente completa

Escriba el código

Añada lo siguiente al método main del archivo SendWhatsappReaction:

val messageId = client.messages.send(
    whatsappReaction {
        to(MESSAGES_TO_NUMBER)
        from(WHATSAPP_SENDER_ID)
        contextMessageId(MESSAGES_MESSAGE_ID)
        reaction(MESSAGES_EMOJI)
    }
)

Ver fuente completa

Ejecute su código

Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.kt.messages.whatsapp por el paquete que contiene SendWhatsappReaction:

gradle run -Pmain=com.vonage.quickstart.kt.messages.whatsapp.SendWhatsappReaction

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Añada lo siguiente a build.gradle:

implementation 'com.vonage:server-sdk:9.3.1'

Crea un archivo llamado SendWhatsappReaction y añade el siguiente código al método main:

VonageClient client = VonageClient.builder()
		.applicationId(VONAGE_APPLICATION_ID)
		.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
		.build();

Ver fuente completa

Escriba el código

Añada lo siguiente al método main del archivo SendWhatsappReaction:

var response = client.getMessagesClient().sendMessage(
	WhatsappReactionRequest.builder()
		.from(WHATSAPP_SENDER_ID).to(MESSAGES_TO_NUMBER)
		.contextMessageId(MESSAGES_MESSAGE_ID)
		.reaction(MESSAGES_EMOJI).build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());

Ver fuente completa

Ejecute su código

Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.messages.whatsapp por el paquete que contiene SendWhatsappReaction:

gradle run -Pmain=com.vonage.quickstart.messages.whatsapp.SendWhatsappReaction

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

composer require vonage/client

Crea un archivo llamado send-reaction.php y añade el siguiente código:

$keypair = new \Vonage\Client\Credentials\Keypair(
    file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH),
    VONAGE_APPLICATION_ID
);

$client = new \Vonage\Client($keypair);

Ver fuente completa

Escriba el código

Añada lo siguiente a send-reaction.php:

$custom = [
    "message_type" => "reaction",
    "reaction" => [
        "action" => "react",
        "emoji" => EMOJI
    ],
    "context" => [
        "message_uuid" => MESSAGE_UUID
    ],
    "to" => TO_NUMBER,
    "from" => WHATSAPP_NUMBER,
    "channel" => "whatsapp"
];

$whatsApp = new \Vonage\Messages\Channel\WhatsApp\WhatsAppCustom(
    TO_NUMBER,
    FROM_NUMBER,
    $custom
);

$client->messages()->send($whatsApp);

Ver fuente completa

Ejecute su código

Guarde este archivo en su máquina y ejecútelo:

php send-reaction.php

Pruébalo

Al ejecutar el código, se envía un mensaje de reacción de WhatsApp al número de destino.