Saltar al contenido principal
POST
/
api
/
community
/
unlink
/
:instance
Desvincular grupos
curl --request POST \
  --url https://api.example.com/api/community/unlink/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "communityJid": "<string>",
  "groupJid": [
    "<string>"
  ]
}
'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no

​
Descripción

Desvincula grupos de una comunidad. Los grupos no se eliminan, simplemente vuelven a ser independientes (sin linkedParentJid). Mismo body y respuesta que /link (DTO compartido).
El campo linked en la respuesta contiene los JIDs desvinculados con éxito (debido a la reutilización del DTO CommunityLinkResponse). El message ("Unlinked N of M ...") confirma la semántica.

​
Ejemplos

​
Desvincular grupos

Elimina 2 subgrupos de la comunidad 120363406289005073@g.us. Los grupos vuelven a ser independientes (sin linkedParentJid) pero siguen existiendo con sus miembros. 
curl -X POST "https://ryzeapi.cloud/api/community/unlink/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "communityJid": "120363406289005073@g.us",
    "groupJid": [
      "120363406289005074@g.us",
      "120363406289005075@g.us"
    ]
  }'

​
Respuesta exitosa

Confirma la desvinculación devolviendo el conteo en message (formato "Unlinked N of M groups from community"). Debido al DTO compartido con /link, el array linked aquí contiene los JIDs desvinculados con éxito, y failed contiene los que fallaron. success es true cuando se desvinculó al menos un grupo, incluso en éxito parcial, verifica siempre failed[] para detectar errores por grupo.
200 OK
{
  "success": true,
  "message": "Unlinked 2 of 2 groups from community",
  "linked": [
    "120363406289005074@g.us",
    "120363406289005075@g.us"
  ],
  "failed": []
}

​
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

​
communityJid
string
requerido
JID @g.us de la comunidad.
​
groupJid
string[]
requerido
JIDs de los grupos a desvincular. Al menos 1 elemento.

​
Notas

  • El Grupo de Anuncios de la comunidad no se puede desvincular, para eliminar el grupo de anuncios, debes eliminar la comunidad completa (no expuesto en esta API).
  • Los miembros de los grupos permanecen donde estaban, solo se elimina la relación padre-hijo.
  • Para mover un grupo entre comunidades, desvincúlalo aquí y usa /link en la nueva.

​
Errores

HTTPMensaje
400community jid is required
400group jid is required
400Instance is not connected to WhatsApp
500error parse community jid: <reason>
Envoltorio: 
{
  "success": false,
  "error": { "message": "community jid is required" }
}

​
Siguiente

Vincular grupos

Reconecta a otra comunidad.

Listar subgrupos

Confirma que el grupo fue eliminado.