> ## Documentation Index > Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Enviar reação > Reaja a uma mensagem da conversa com um emoji. Aplica um emoji como reação a uma mensagem da conversa, do mesmo jeito que o cliente faz ao tocar e segurar uma mensagem no WhatsApp. > [!NOTE] > > O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário). ## Qual mensagem recebe a reação Informe em `reaction.message_id` o ID (`wamid`) da mensagem. Para uma mensagem enviada pelo cliente, ele chega no [webhook](https://developers.datafyapi.com.br/api-reference/whatsapp/webhooks/eventos/mensagens.md) em `messages[].id`. A reação não é aplicada quando a mensagem: * tem mais de **30 dias**; * não faz parte da conversa com esse cliente; * foi apagada; * é ela mesma uma reação. No **Testar**, o `message_id` vem com um ID de exemplo. Troque pelo `wamid` de uma mensagem real da conversa. ## Emoji Envie o emoji em `reaction.emoji` como caractere, como `👍`, ou como sequência Unicode, como `👍`. ## Status e erros A resposta **200** não garante que a reação foi aplicada. Se a mensagem não puder receber reação, a falha chega depois pelo webhook, com o erro `131009`. Uma reação gera apenas o webhook de status `sent`. Não há status `delivered` nem `read` para reações. ## Quando o cliente reage Quando o cliente reage a uma mensagem da sua empresa, chega um webhook do tipo `reaction`. O campo `reaction.message_id` aponta para a mensagem que recebeu a reação: ```json theme={null} { "object": "whatsapp_business_account", "entry": [ { "id": "234567890123456", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "5541999999999", "phone_number_id": "123456789012345" }, "contacts": [ { "profile": { "name": "Camila Souza" }, "wa_id": "5511999999999", "user_id": "BR.13491208655302741918" } ], "messages": [ { "from": "5511999999999", "from_user_id": "BR.13491208655302741918", "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjRDRDE=", "timestamp": "1757955900", "reaction": { "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=", "emoji": "❤️" }, "type": "reaction" } ] }, "field": "messages" } ] } ] } ``` Se o cliente **remover** a reação, chega um novo webhook igual, mas **sem o campo `emoji`** dentro de `reaction`. Veja mais detalhes na [documentação de mensagens de reação da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/reaction-messages). ## OpenAPI ````yaml api-reference/whatsapp/specs/reacao.json POST /v1/{phone_number_id}/messages openapi: 3.1.0 info: title: Datafy API — Enviar reação version: 1.0.0 servers: - url: https://cloud.datafyapi.com.br description: Produção security: - bearerAuth: [] paths: /v1/{phone_number_id}/messages: post: summary: Enviar reação operationId: enviarReacao parameters: - name: phone_number_id in: path required: true schema: type: string description: ID do número que envia a reação. Descubra com `GET /me`. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MensagemReacao' example: messaging_product: whatsapp recipient_type: individual to: '5511999999999' type: reaction reaction: message_id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE= emoji: 👍 responses: '200': description: Reação aceita pela Meta. Não confirma que foi aplicada. content: application/json: example: messaging_product: whatsapp contacts: - input: '5511999999999' wa_id: '5511999999999' messages: - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA= '400': description: Erro retornado pela Meta. content: application/json: example: error: message: (#100) Invalid parameter type: OAuthException code: 100 fbtrace_id: AbCdEfGhIjK '401': description: Token ausente ou inválido. content: application/json: example: statusCode: 401 message: Token inválido ou não encontrado. components: schemas: MensagemReacao: type: object required: - messaging_product - to - type - reaction properties: messaging_product: type: string enum: - whatsapp default: whatsapp example: whatsapp description: Sempre `whatsapp`. recipient_type: type: string enum: - individual default: individual example: individual description: Sempre `individual`. to: type: string example: '5511999999999' description: >- Número do destinatário com código do país e DDD, como `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo ID do usuário, deixe em branco. recipient: type: string description: >- ID do usuário no WhatsApp (BSUID), recebido nos webhooks em `from_user_id` e `contacts[].user_id`, como `BR.13491208655302741918`. Usado quando `to` não é informado. type: type: string enum: - reaction default: reaction example: reaction description: Sempre `reaction`. reaction: type: object required: - message_id - emoji description: Reação aplicada a uma mensagem da conversa. properties: message_id: type: string example: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE= description: >- ID (`wamid`) da mensagem que recebe a reação. A mensagem precisa ter no máximo 30 dias. emoji: type: string example: 👍 description: >- Emoji da reação, como caractere (`👍`) ou sequência Unicode (`\uD83D\uDC4D`). securitySchemes: bearerAuth: type: http scheme: bearer description: >- Token gerado no painel da Datafy ao criar o canal. Formato: `sk_live_xxx`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.