Ações na mensagem e Buscar
Fixa ou desafixa uma mensagem
POST
/message/pinAutenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Fixa ou desafixa uma mensagem específica usando a funcionalidade nativa do WhatsApp.
O endpoint realiza:
- Busca a mensagem original no banco de dados usando o ID fornecido
- Envia a ação de fixar ou desafixar a mensagem no WhatsApp
- Funciona em conversas individuais e grupos
- Gera um novo ID para o evento de pin/unpin
- Retorna objeto de mensagem completo seguindo o padrão da API
- Dispara eventos SSE/Webhook automaticamente
Importante:
- O ID pode ser fornecido no formato completo (
owner:messageid) ou apenasmessageid - Em conversas
1:1, a ação é suportada normalmente - Em grupos, a permissão depende da configuração do WhatsApp do grupo (
apenas adminsouqualquer membro) - O backend não valida localmente se a instância é admin do grupo; a decisão final é do WhatsApp
- Newsletters/canais não são suportados neste endpoint
- Se
pinnão for enviado, o valor padrão étrue - Ao fixar mensagem,
durationaceita dias (1,7ou30) - Se
durationnão for enviado ou vier com qualquer outro valor, o backend usa30dias - Ao desafixar (
pin: false),durationé ignorado
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| id* | string | ID único da mensagem alvo (formato Exemplo: 3A12345678901234567890123456789012 |
| pin | boolean | Define se a mensagem deve ser fixada ( Exemplo: true |
| duration | integer | Duração do pin em dias. Valores aceitos: Exemplo: 7 |
* obrigatório
Exemplos de corpo
Fixar mensagem
{
"id": "3A12345678901234567890123456789012",
"pin": true,
"duration": 7
}Fixar mensagem com fallback para 30 dias
{
"id": "3A12345678901234567890123456789012",
"pin": true,
"duration": 99
}Desafixar mensagem
{
"id": "3A12345678901234567890123456789012",
"pin": false
}Respostas
- 200Ação de fixar/desafixar mensagem enviada com sucesso
- 400Dados inválidos na requisição ou operação não suportada
- 401Sem sessão ativa ou token inválido
- 404Mensagem não encontrada
- 500Erro interno do servidor ou erro retornado pelo WhatsApp
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.