Saltar al contenido principal
POST
/
api
/
chat
/
forward
/
:instance
Reenviar mensaje
curl --request POST \
  --url https://api.example.com/api/chat/forward/:instance \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "messageId": "<string>",
  "to": "<string>"
}
'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no Reenvía un mensaje a un destinatario. Para múltiples destinos, realiza varias llamadas. Soporta el reenvío de: texto, imagen, video, audio, documento, sticker, contacto, ubicación.
No soporta: reacciones, encuestas, botones.

​
Ejemplos

​
A un contacto

Reenvía el mensaje identificado por messageId a un contacto individual en to (número de teléfono o JID @s.whatsapp.net). El mensaje llega al destinatario con la marca “Reenviado”. 
curl -X POST "https://ryzeapi.cloud/api/chat/forward/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB08FCF27E532F1B0F5",
    "to": "5511987654321"
  }'

​
A un grupo

La misma operación, pero con to apuntando a un JID de grupo (@g.us). Útil para reenviar avisos o media recibidos en otro chat a un grupo entero de una vez. 
curl -X POST "https://ryzeapi.cloud/api/chat/forward/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "messageId": "3EB08FCF27E532F1B0F5",
    "to": "120363406289005073@g.us"
  }'

​
Respuesta exitosa

200 OK
{
  "success": true,
  "message": "Message forwarded successfully",
  "messageId": "3EB08FCF27E532F1B0F7",
  "originalId": "3EB08FCF27E532F1B0F5",
  "destinationJid": "5511987654321@s.whatsapp.net"
}
CampoDescripción
messageIdNuevo ID generado por el reenvío.
originalIdID del mensaje original.
destinationJidJID del destinatario.

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.

​
Cuerpo de la solicitud

​
messageId
string
requerido
ID del mensaje original (debe existir en la base de datos de la instancia).
​
to
string
requerido
Destino: número de teléfono (5511...), JID privado (...@s.whatsapp.net o ...@lid), JID de grupo (@g.us) o newsletter (@newsletter).

​
Notas

  • Los media muy antiguos (>14 días) pueden tener sus bytes encriptados expirados en los servidores de WhatsApp, en ese caso el reenvío falla.
  • La marca “Reenviado” aparece naturalmente para el destinatario.
  • El nuevo mensaje es ingerido por el pipeline de eventos y dispara message.exchange (saliente) en el webhook/WebSocket.

​
Respuestas de error

HTTPerror.messageCuándo
400Invalid request bodyJSON malformado.
400messageId is required o to is requiredCampo faltante.
401Invalid token,
404Instance not found o message not found,
500unsupported message type for forwarding: <type>Reacción, encuesta o interactivo.
503Instance is not connected to WhatsAppSin sesión activa.