Solicitudes pendientes

GET

api

group

requests

:instance

Solicitudes pendientes

curl --request GET \
  --url https://api.example.com/api/group/requests/:instance \
  --header 'token: <token>'

const options = {method: 'GET', headers: {token: '<token>'}};

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

Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

Descripción

Lista las solicitudes de unión pendientes en un grupo que tiene requireAdminApproval=true. Solo los administradores del grupo pueden ver esta cola. Para aceptar o rechazar, usa POST /participants con action=approve o action=reject.

Ejemplos

Listar solicitudes

Devuelve la cola de solicitudes pendientes para el grupo 120363406289005073@g.us. Cada entrada lleva el LID y (cuando está disponible) el número de teléfono de quien pidió unirse.

curl -X GET "https://ryzeapi.cloud/api/group/requests/$Instance_Name?identifier=120363406289005073@g.us" \
  -H "token: $Token_Instance"

await fetch(`https://ryzeapi.cloud/api/group/requests/${process.env.Instance_Name}?identifier=120363406289005073@g.us`, {
  method: "GET",
  headers: {
    "token": process.env.Token_Instance
  }
});

import os, requests

requests.get(
    f"https://ryzeapi.cloud/api/group/requests/{os.environ['Instance_Name']}?identifier=120363406289005073@g.us",
    headers={
        "token": os.environ["Token_Instance"]
    }
)

package main

import (
    "net/http"
    "os"
)

func main() {
    req, _ := http.NewRequest("GET", "https://ryzeapi.cloud/api/group/requests/"+os.Getenv("Instance_Name")+"?identifier=120363406289005073@g.us", nil)
    req.Header.Set("token", os.Getenv("Token_Instance"))
    http.DefaultClient.Do(req)
}

Respuesta exitosa

Devuelve la cola de solicitudes pendientes bajo requests[], con meta.total reportando su tamaño. Cada entrada lleva el jid en formato LID (@lid, para preservar la privacidad del solicitante) y, cuando está disponible, el phoneNumber correspondiente. Usa estos identificadores en /participants con action=approve o action=reject para resolver cada solicitud.

200 OK

{
  "success": true,
  "message": "2 pending requests found",
  "groupJid": "120363406289005073@g.us",
  "requests": [
    {
      "jid": "199789077627112@lid",
      "phoneNumber": "5511999999999@s.whatsapp.net",
      "requestedAt": "2026-04-20T14:00:00Z"
    }
  ],
  "meta": { "total": 2 }
}

Parámetros de ruta

string

requerido

Nombre de la instancia.

Cabeceras

string

requerido

TokenAccount o TokenInstance.

Query

string

requerido

JID, código de invitación o enlace del grupo.

Notas

El jid devuelto viene en formato LID (@lid) para preservar la privacidad del solicitante, en algunos casos phoneNumber puede venir como null.
Para aprobar o rechazar en bloque, reenvía estos JIDs (o PNs) a /participants.

Errores

HTTP	Mensaje
400	`Identifier is required`
403	`Not authorized to view group requests (must be admin)`
404	`Group not found or you are not a member of this group`

Envoltorio:

{
  "success": false,
  "error": { "message": "Not authorized to view group requests (must be admin)" }
}

Aprobar / rechazar

Usa action=approve o action=reject en /api/group/participants.

Actualizar grupo

Habilita o deshabilita requireAdminApproval.

Introducción

Instancia

Eventos

Mensajes

Llamadas

Grupos

Comunidades

Newsletter

Perfil

Chat

Chatwoot

Typebot

Observabilidad

Solicitudes pendientes

Descripción

Ejemplos

Listar solicitudes

Respuesta exitosa

Parámetros de ruta

Cabeceras

Query

Notas

Errores

Siguiente

Aprobar / rechazar

Actualizar grupo

​Descripción

​Ejemplos

​Listar solicitudes

​Respuesta exitosa

​Parámetros de ruta

​Cabeceras

​Query

​Notas

​Errores

​Siguiente

Aprobar / rechazar

Actualizar grupo

Descripción

Ejemplos

Listar solicitudes

Respuesta exitosa

Parámetros de ruta

Cabeceras

Query

Notas

Errores

Siguiente