Enviar reação

curl --request POST \
  --url https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=",
    "emoji": "👍"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    recipient_type: 'individual',
    to: '5511999999999',
    type: 'reaction',
    reaction: {message_id: 'wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=', emoji: '👍'}
  })
};

fetch('https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages"

payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5511999999999",
    "type": "reaction",
    "reaction": {
        "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=",
        "emoji": "👍"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "5511999999999",
      "wa_id": "5511999999999"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA="
    }
  ]
}

{
  "error": {
    "message": "(#100) Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "AbCdEfGhIjK"
  }
}

{
  "statusCode": 401,
  "message": "Token inválido ou não encontrado."
}

POST

{phone_number_id}

messages

Enviar reação

curl --request POST \
  --url https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=",
    "emoji": "👍"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    recipient_type: 'individual',
    to: '5511999999999',
    type: 'reaction',
    reaction: {message_id: 'wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=', emoji: '👍'}
  })
};

fetch('https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://cloud.datafyapi.com.br/v1/{phone_number_id}/messages"

payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5511999999999",
    "type": "reaction",
    "reaction": {
        "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=",
        "emoji": "👍"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "5511999999999",
      "wa_id": "5511999999999"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA="
    }
  ]
}

{
  "error": {
    "message": "(#100) Invalid parameter",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "AbCdEfGhIjK"
  }
}

{
  "statusCode": 401,
  "message": "Token inválido ou não encontrado."
}

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.

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.

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 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:

{
  "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.

Autorizações

Authorization

string

header

obrigatório

Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.

Parâmetros de caminho

phone_number_id

string

obrigatório

ID do número que envia a reação. Descubra com GET /me.

Corpo

application/json

messaging_product

enum<string>

padrão:whatsapp

obrigatório

Sempre whatsapp.

Opções disponíveis:

whatsapp

Exemplo:

"whatsapp"

string

obrigatório

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.

Exemplo:

"5511999999999"

type

enum<string>

padrão:reaction

obrigatório

Sempre reaction.

Opções disponíveis:

reaction

Exemplo:

"reaction"

reaction

object

obrigatório

Reação aplicada a uma mensagem da conversa.

Show child attributes

recipient_type

enum<string>

padrão:individual

Sempre individual.

Opções disponíveis:

individual

Exemplo:

"individual"

recipient

string

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.

Resposta

Reação aceita pela Meta. Não confirma que foi aplicada.

Começar

Administração

Mensagens

Recursos de mensagens

Mídias

Templates

Conta e número

Endpoints Datafy

Webhooks

Enviar reação

Qual mensagem recebe a reação

Emoji

Status e erros

Quando o cliente reage

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Qual mensagem recebe a reação

​Emoji

​Status e erros

​Quando o cliente reage

Autorizações

Parâmetros de caminho

Corpo

Resposta

Qual mensagem recebe a reação

Emoji

Status e erros

Quando o cliente reage