Enviar uma mensagem de reação
Neste trecho de código, você aprenderá a enviar uma reação no WhatsApp usando a Messages API. O WhatsApp reaction O tipo de mensagem permite que você React, usando um emoji, a uma mensagem recebida.
Além do to e from Numbers, esse tipo de mensagem requer duas informações essenciais:
- O
message_uuidda mensagem à qual se deve responder. Esse texto estará presente no corpo da mensagem recebida. - O
emojiusado como reação. Pode ser o próprio emoji, por exemplo, 😀.
IMPORTANTE: Se um cliente não tiver enviado uma mensagem para você primeiro, na primeira vez que você enviar uma mensagem a um usuário, o WhatsApp exige que a mensagem contenha um modelo. Isso é explicado com mais detalhes no Tópico: Entendendo o WhatsApp.
Exemplo
Veja a seguir a descrição de todas as variáveis utilizadas em cada trecho de código:
| Chave | Descrição |
|---|---|
JWT | Used to authenticate your request. See |
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 |
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. |
MESSAGE_UUID | The UUID of the specific message. |
EMOJI | The emoji to send in the message. |
NOTA: Não use um espaço à esquerda + ou 00 Ao digitar um número de telefone, comece com o código do país; por exemplo, 447700900000.
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Escreva o código
Adicione o seguinte ao arquivo ` 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}'"
}
}'Execute seu código
Salve este arquivo no seu computador e execute-o:
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk-kotlin:2.1.1'Crie um arquivo chamado ` SendWhatsappReaction ` e adicione o código a seguir ao método ` main `:
val client = Vonage {
applicationId(VONAGE_APPLICATION_ID)
privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` SendWhatsappReaction `:
val messageId = client.messages.send(
whatsappReaction {
to(MESSAGES_TO_NUMBER)
from(WHATSAPP_SENDER_ID)
contextMessageId(MESSAGES_MESSAGE_ID)
reaction(MESSAGES_EMOJI)
}
)Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.kt.messages.whatsapp ` pelo pacote que contém ` SendWhatsappReaction`:
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk:9.3.1'Crie um arquivo chamado ` SendWhatsappReaction ` e adicione o código a seguir ao método ` main `:
VonageClient client = VonageClient.builder()
.applicationId(VONAGE_APPLICATION_ID)
.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
.build();Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` 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());Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.messages.whatsapp ` pelo pacote que contém ` SendWhatsappReaction`:
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
composer require vonage/clientCrie um arquivo chamado ` send-reaction.php ` e insira o seguinte código:
$keypair = new \Vonage\Client\Credentials\Keypair(
file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH),
VONAGE_APPLICATION_ID
);
$client = new \Vonage\Client($keypair);Escreva o código
Adicione o seguinte ao arquivo ` 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);Execute seu código
Salve este arquivo no seu computador e execute-o:
Experimente
Ao executar o código, uma mensagem de reação do WhatsApp é enviada para o número de destino.