Skip to main content
POST
Fijar mensaje
Auth: TokenAccount o TokenInstanceRate-limit: Global (100/min) • Idempotente:

Descripción

Fija (pin: true) o desfija (pin: false) un mensaje dentro de un chat. El chat, el autor del mensaje y la dirección (fromMe) se resuelven automáticamente a partir del messageId, solo necesitas indicar el mensaje.
A diferencia de marcar como favorito (que es privado y silencioso), fijar un mensaje es una acción visible para todos los participantes de la conversación: WhatsApp muestra “fijó un mensaje”. El protocolo solo ofrece “fijar para todos”, no existe fijar solo para ti.
El mensaje debe existir en la base de datos de la instancia (haber sido recibido/enviado por ella). De lo contrario, la API devuelve message with ID ... not found.

Ejemplos

Fijar

Con pin: true, el mensaje se fija en la parte superior del chat durante el tiempo definido en duration.

Desfijar

Con pin: false, el mensaje se desfija. El campo duration se ignora.
cURL

Respuesta de éxito

chat_jid se resuelve a partir del messageId, pinned refleja el estado final y duration se devuelve solo al fijar. El message cambia según pin: "Message pinned successfully" o "Message unpinned successfully".
200 OK

Parámetros de ruta

string
requerido
Nombre de la instancia.

Headers

Request body

boolean
requerido
true fija, false desfija.
string
requerido
ID del mensaje a fijar/desfijar. El chat y el autor se resuelven automáticamente a partir de él.
string
predeterminado:"7d"
Cuánto tiempo permanece fijado el mensaje: "24h", "7d" o "30d". Solo se usa cuando pin: true; se ignora al desfijar.

Respuestas de error

Error 400

Relacionados

Fijar chat

POST /api/chat/pinChat/:instance

Favorito

POST /api/chat/favorite/:instance