Chat
Fijar mensaje
Fija (pin) o desfija un mensaje dentro de un chat
POST
Fijar mensaje
Auth:
TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí
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.
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
Conpin: true, el mensaje se fija en la parte superior del chat durante el tiempo definido en duration.
Desfijar
Conpin: 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/:instanceFavorito
POST /api/chat/favorite/:instance