# Enviar reação

> Reaja a uma mensagem com um emoji, ou remova a reação, com POST /v1/messages no WhatsApp, no Instagram e no Messenger.

`POST /v1/messages` com `type: "reaction"` coloca um emoji numa mensagem que já existe na conversa. Funciona no WhatsApp, no Instagram e no Messenger. Os campos que valem para todos os envios estão em [Campos comuns](/send/text/#campos-comuns).

## Antes de começar

- Uma chave de API com a permissão `send` (veja [Autenticação](/api/authentication/)).
- Uma conexão **Ativa** do canal.
- Reação segue a janela de atendimento: fora das 24 horas ([janelas](/api/limits/#janelas)) o envio é recusado.

## Reagir a uma mensagem

**cURL**

```bash
curl https://api.messajo.com/v1/messages \
  -H "Authorization: Bearer $MESSAJO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
      "connection_id": "conn_...",
      "to": "5511999999999",
      "type": "reaction",
      "reaction": {
        "message_id": "msg_...",
        "emoji": "👍"
      }
    }'
```

**TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

const sent = await messajo.messages.send({
  "connection_id": "conn_...",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "msg_...",
    "emoji": "👍"
  }
});
```

**n8n**

n8n HTTP Request: POST https://api.messajo.com/v1/messages

```json
{
  "connection_id": "conn_...",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "msg_...",
    "emoji": "👍"
  }
}
```

## Remover a reação

Para tirar a reação, envie o mesmo corpo com `emoji` vazio.

**cURL**

```bash
curl https://api.messajo.com/v1/messages \
  -H "Authorization: Bearer $MESSAJO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
      "connection_id": "conn_...",
      "to": "5511999999999",
      "type": "reaction",
      "reaction": {
        "message_id": "msg_...",
        "emoji": ""
      }
    }'
```

**TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

const sent = await messajo.messages.send({
  "connection_id": "conn_...",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "msg_...",
    "emoji": ""
  }
});
```

**n8n**

n8n HTTP Request: POST https://api.messajo.com/v1/messages

```json
{
  "connection_id": "conn_...",
  "to": "5511999999999",
  "type": "reaction",
  "reaction": {
    "message_id": "msg_...",
    "emoji": ""
  }
}
```

## Campos

| Campo | Regra |
|---|---|
| `reaction.message_id` | A mensagem alvo: o id do Messajo (`msg_…`) ou o id da Meta. O Messajo troca o `msg_…` pelo id da Meta antes de enviar. De 1 a 256 caracteres. |
| `reaction.emoji` | Até 16 caracteres. Texto vazio (`""`) remove a reação. |

## Curtida no Instagram

No Instagram, `type: "like"` envia o coração, sem corpo. Só existe no Instagram.

## Erros comuns

- [`not_found`](/errors#not_found) (404): o `msg_…` informado em `message_id` não existe.
- [`outside_service_window`](/errors#outside_service_window) (422): fora das 24 horas. O fim da janela vem em `details[0].message`.
- [`validation_failed`](/errors#validation_failed) (400): `emoji` com mais de 16 caracteres ou campo desconhecido.
