curl --request POST \
  --url https://api.wppfy.com/message/pin \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "id": "3A12345678901234567890123456789012",
  "pin": true,
  "duration": 7
}
'

{
  "id": "5511999999999:3A12345678901234567890123456789012",
  "messageid": "3A12345678901234567890123456789012",
  "chatid": "120363123456789012@g.us",
  "sender": "5511999999999@s.whatsapp.net",
  "senderName": "Mi Instancia",
  "isGroup": true,
  "fromMe": true,
  "content": {},
  "messageType": "PinInChatMessage",
  "source": "web",
  "messageTimestamp": 1704067200000,
  "status": "Pending",
  "text": "Mensaje fijado",
  "quoted": "",
  "edited": "",
  "reaction": "",
  "convertOptions": "",
  "owner": "5511999999999",
  "targetMessageID": "3EB0538DA65A59F6D8A251",
  "pinned": true
}

{
  "error": "message pinning is not supported for newsletters"
}

{
  "error": "No session"
}

{
  "error": "Mensaje no encontrado"
}

{
  "error": "error pinning message: ..."
}

Acciones en el mensaje y Búsqueda

Fija o desfija un mensaje

Fija o desfija un mensaje específico usando la funcionalidad nativa de WhatsApp.

Use esta operación para destacar un mensaje importante en una conversación individual o grupo. La respuesta registra la acción y esta también aparece en los eventos configurados.

Importante:

El ID puede proporcionarse en el formato completo devuelto por la API o solo como messageid
En conversaciones 1:1, la acción se admite normalmente
En grupos, el permiso depende de la configuración de WhatsApp del grupo (apenas admins o qualquer membro)
En grupos, el permiso final depende de la configuración del propio grupo
Los newsletters/canales no se admiten en este endpoint
Si no se envía pin, el valor predeterminado es true
Al fijar un mensaje, duration acepta días (1, 7 o 30)
Si no se envía duration o llega con cualquier otro valor, la API usa 30 días
Al desfijar (pin: false), duration se ignora

POST

message

curl --request POST \
  --url https://api.wppfy.com/message/pin \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "id": "3A12345678901234567890123456789012",
  "pin": true,
  "duration": 7
}
'

{
  "id": "5511999999999:3A12345678901234567890123456789012",
  "messageid": "3A12345678901234567890123456789012",
  "chatid": "120363123456789012@g.us",
  "sender": "5511999999999@s.whatsapp.net",
  "senderName": "Mi Instancia",
  "isGroup": true,
  "fromMe": true,
  "content": {},
  "messageType": "PinInChatMessage",
  "source": "web",
  "messageTimestamp": 1704067200000,
  "status": "Pending",
  "text": "Mensaje fijado",
  "quoted": "",
  "edited": "",
  "reaction": "",
  "convertOptions": "",
  "owner": "5511999999999",
  "targetMessageID": "3EB0538DA65A59F6D8A251",
  "pinned": true
}

{
  "error": "message pinning is not supported for newsletters"
}

{
  "error": "No session"
}

{
  "error": "Mensaje no encontrado"
}

{
  "error": "error pinning message: ..."
}

Autorizaciones

token

string

header

requerido

Cuerpo

application/json

string

requerido

ID completo devuelto por la API o solo el messageid

Ejemplo:

"3A12345678901234567890123456789012"

boolean

predeterminado:true

Define si el mensaje debe fijarse (true) o desfijarse (false)

Ejemplo:

true

duration

integer

predeterminado:30

Duración del pin en días. Valores aceptados: 1, 7 o 30. Cualquier otro valor pasa a 30.

Ejemplo:

7

Respuesta

Acción de fijar/desfijar mensaje enviada con éxito

string

ID único del mensaje generado para el evento de pin/unpin

Ejemplo:

"5511999999999:3A12345678901234567890123456789012"

messageid

string

ID del mensaje del evento en WhatsApp

Ejemplo:

"3A12345678901234567890123456789012"

chatid

string

Chat donde ocurrió la acción

Ejemplo:

"120363123456789012@g.us"

sender

string

JID del remitente de la acción

Ejemplo:

"5511999999999@s.whatsapp.net"

senderName

string

Nombre del perfil de la instancia

Ejemplo:

"Mi Instancia"

isGroup

boolean

Indica si el chat es un grupo

Ejemplo:

true

fromMe

boolean

Indica si la acción fue enviada por la propia instancia

Ejemplo:

true

content

object

Payload interno de PinInChatMessage

messageType

string

Tipo del mensaje devuelto

Ejemplo:

"PinInChatMessage"

source

string

Origen estimado del mensaje

Ejemplo:

"web"

messageTimestamp

integer

Timestamp del mensaje en milisegundos

Ejemplo:

1704067200000

status

string

Estado actual de la acción

Ejemplo:

"Pending"

text

string

Texto amigable derivado de la acción

Ejemplo:

"Mensaje fijado"

quoted

string

ID del mensaje citado, cuando corresponda

Ejemplo:

""

edited

string

ID del mensaje editado, cuando corresponda

Ejemplo:

""

reaction

string

Emoji de reacción, cuando aplique

Ejemplo:

""

convertOptions

string

Opciones convertidas para mensajes interactivos, cuando corresponda

Ejemplo:

""

owner

string

Propietario de la instancia

Ejemplo:

"5511999999999"

targetMessageID

string

ID del mensaje objetivo que se fijó o desfijó

Ejemplo:

"3EB0538DA65A59F6D8A251"

pinned

boolean

Estado final solicitado para el mensaje objetivo

Ejemplo:

true

Instancia

CRM

Proxy

Perfil

Enviar Mensaje

Mensaje Async

Acciones en el mensaje y Búsqueda

Grupos y Comunidades

Newsletters y Canales

Server-Sent Events (SSE)

Bloqueos

Etiquetas

Chats

Contactos

Llamadas

Integración con Chatwoot

Business

Respuestas Rápidas

Fija o desfija un mensaje

Autorizaciones

Cuerpo

Respuesta