vértice
Produto Preços Painel
Compatibilidade

Alias Z-API para reação

Alias Z-API para reagir a uma mensagem.

API key Escopo write
Exemplo de requisição
curl -X POST "https://seu-dominio/instances/:id/token/:token/send-reaction" \
  -H "x-api-key: $VERTICE_API_KEY" \
  -H "content-type: application/json" \
  -d '{"phone":"5511999999999","messageId":"ABC","reaction":"👍"}'
POST /instances/{id}/token/{token}/send-reaction
API key
Entenda

Conceituação

Alias Z-API para reagir a uma mensagem.

O token na URL é a API key do workspace ou a chave mestra. Por aparecer em logs de acesso, use HTTPS e migre para as rotas nativas quando possível.

Corpo JSON. Os campos abaixo são exemplos; campos marcados como obrigatórios precisam ser enviados.
Contrato

Atributos

Header

x-api-key string obrigatório

API key do workspace (vtc_live_...). Também aceita Authorization: Bearer.

content-type string obrigatório

application/json.

Client-Token string opcional

Opcional. Quando enviado, precisa pertencer ao mesmo workspace.

Path

id string obrigatório

ID da instância.

token string obrigatório

API key do workspace ou chave mestra.

Body

phone string obrigatório

Telefone com DDI e DDD, apenas dígitos ou no formato exibido.

messageId string obrigatório

ID da mensagem retornado pelo WhatsApp.

reaction string obrigatório

Emoji da reação.

Payload

Request Body

{
  "phone": "5511999999999",
  "messageId": "ABC",
  "reaction": "👍"
}
Contrato

Resposta

200
{
  "data": {
    "ok": true
  }
}

Respostas de sucesso são envelopadas em data.

Erros comuns

400 Corpo, query ou parâmetro inválido. A resposta traz error.code e error.message.
401 Credencial ausente, inválida ou sessão expirada.
403 Escopo insuficiente, IP não autorizado ou workspace suspenso.
404 Recurso não encontrado ou pertence a outro workspace.