Saltar al contenido principal
POST
/
api
/
group
/
resetLink
/
:instance
Restablecer enlace de invitación
curl --request POST \
  --url https://api.example.com/api/group/resetLink/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "identifier": "<string>"
}
'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no (cada llamada genera un código diferente)

​
Descripción

Revoca el enlace de invitación actual del grupo y genera uno nuevo. Solo los administradores pueden llamar. Úsalo cada vez que sospeches que el enlace se filtró o después de eliminar a un miembro al que no quieres de vuelta.

​
Ejemplos

​
Restablecer enlace

Revoca el enlace de invitación actual del grupo 120363406289005073@g.us y genera un nuevo código. El enlace antiguo deja de funcionar inmediatamente. 
curl -X POST "https://ryzeapi.cloud/api/group/resetLink/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "120363406289005073@g.us"
  }'

​
Respuesta exitosa

Devuelve el nuevo inviteCode y inviteLink, ambos ya activos. El enlace antiguo deja de funcionar inmediatamente, reemplaza cualquier copia en flujos de onboarding, materiales de marketing o códigos QR impresos.
200 OK
{
  "success": true,
  "message": "Group invite link reset successfully",
  "groupJid": "120363406289005073@g.us",
  "inviteCode": "NEW123XYZ",
  "inviteLink": "https://chat.whatsapp.com/NEW123XYZ"
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.
​
Content-Type
string
requerido
application/json

​
Cuerpo de la solicitud

​
identifier
string
requerido
JID, código de invitación o enlace del grupo.

​
Notas

  • El enlace antiguo deja de funcionar inmediatamente, quien aún no se haya unido recibe Invite link has been revoked or expired.
  • Para solamente consultar el enlace actual sin revocarlo, usa GET /info y lee group.inviteLink.
  • Para escenarios de compromiso más severos (administrador comprometido), también revoca el rol de admin a quien no debería tenerlo mediante /participants con action=demote.

​
Errores

HTTPMensaje
400Identifier is required
403Not authorized to reset group invite link (must be admin)
404Group not found or you are not a member of this group
Envoltorio: 
{
  "success": false,
  "error": { "message": "Not authorized to reset group invite link (must be admin)" }
}