Reenviar mensaje

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>"
}
'

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({messageId: '<string>', to: '<string>'})
};

fetch('https://api.example.com/api/chat/forward/:instance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/api/chat/forward/:instance"

payload = {
    "messageId": "<string>",
    "to": "<string>"
}
headers = {
    "token": "<token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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"
  }'

await fetch(`https://ryzeapi.cloud/api/chat/forward/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    messageId: "3EB08FCF27E532F1B0F5",
    to:        "5511987654321"
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/chat/forward/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "messageId": "3EB08FCF27E532F1B0F5",
        "to":        "5511987654321"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "messageId": "3EB08FCF27E532F1B0F5",
        "to": "5511987654321"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/chat/forward/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

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"
  }'

await fetch(`https://ryzeapi.cloud/api/chat/forward/${process.env.Instance_Name}`, {
  method: "POST",
  headers: {
    "token":        process.env.Token_Instance,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    messageId: "3EB08FCF27E532F1B0F5",
    to:        "120363406289005073@g.us"
  })
});

import os, requests

requests.post(
    f"https://ryzeapi.cloud/api/chat/forward/{os.environ['Instance_Name']}",
    headers={
        "token":        os.environ["Token_Instance"],
        "Content-Type": "application/json"
    },
    json={
        "messageId": "3EB08FCF27E532F1B0F5",
        "to":        "120363406289005073@g.us"
    }
)

package main

import (
    "net/http"
    "os"
    "strings"
)

func main() {
    body := strings.NewReader(`{
        "messageId": "3EB08FCF27E532F1B0F5",
        "to": "120363406289005073@g.us"
    }`)
    req, _ := http.NewRequest("POST", "https://ryzeapi.cloud/api/chat/forward/"+os.Getenv("Instance_Name"), body)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    req.Header.Set("Content-Type", "application/json")
    http.DefaultClient.Do(req)
}

Respuesta exitosa

200 OK

{
  "success": true,
  "message": "Message forwarded successfully",
  "messageId": "3EB08FCF27E532F1B0F7",
  "originalId": "3EB08FCF27E532F1B0F5",
  "destinationJid": "5511987654321@s.whatsapp.net"
}

Campo	Descripción
`messageId`	Nuevo ID generado por el reenvío.
`originalId`	ID del mensaje original.
`destinationJid`	JID del destinatario.

Parámetros de ruta

string

requerido

Nombre de la instancia.

Cabeceras

string

requerido

TokenAccount o TokenInstance.

Cuerpo de la solicitud

string

requerido

ID del mensaje original (debe existir en la base de datos de la instancia).

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

HTTP	`error.message`	Cuándo
400	`Invalid request body`	JSON malformado.
400	`messageId is required` o `to is required`	Campo faltante.
401	`Invalid token`	,
404	`Instance not found` o `message not found`	,
500	`unsupported message type for forwarding: <type>`	Reacción, encuesta o interactivo.
503	`Instance is not connected to WhatsApp`	Sin sesión activa.

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Reenviar mensaje

Ejemplos

A un contacto

A un grupo

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error

​Ejemplos

​A un contacto

​A un grupo

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Cuerpo de la solicitud

​Notas

​Respuestas de error

Ejemplos

A un contacto

A un grupo

Respuesta exitosa

Parámetros de ruta

Cabeceras

Cuerpo de la solicitud

Notas

Respuestas de error