Actualizar grupo

Actualiza el nombre del grupo, la descripción y/o los permisos de publicación y edición para los participantes existentes.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

PATCH https://api.getincloud.ai/v1/devices/{deviceId}/groups/{groupId}

Actualiza el nombre del grupo, la descripción y/o los permisos de publicación y edición para los participantes existentes. Debes pasar el ID del grupo de WhatsApp en la ruta de la URL (p. ej.: 1234567890-1500000000@g.us o 120000000000000000@g.us).

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`name`	string	No	Nuevo nombre del grupo `minLength: 1` · `maxLength: 100`
`description`	string	No	Nueva descripción del grupo `minLength: 1` · `maxLength: 500`
`permissions`	object	No	Permisos de publicación de mensajes y de edición del grupo para los participantes del grupo
`permissions.edit`	string	No	Permisos para cambiar la configuración del grupo. `enum: ['all', 'admins']`
`permissions.send`	string	No	Permisos para publicar mensajes en el grupo. `enum: ['all', 'admins']`
`permissions.invite`	string	No	Permisos para invitar nuevos participantes al grupo. Por defecto es `all`. `enum: ['all', 'admins']`
`permissions.inviteLink`	string	No	Quién puede compartir el enlace de invitación a este grupo. Por defecto es `all`. `enum: ['all', 'admins']`
`permissions.history`	string	No	Quién puede enviar mensajes anteriores del grupo a los miembros recién añadidos. Por defecto es `admins`. `enum: ['all', 'admins']`
`permissions.approval`	boolean	No	Requiere que los administradores aprueben a los nuevos participantes del grupo
`permissions.inviteSharing`	boolean	No	Activa la Privacidad avanzada del chat de WhatsApp, que limita compartir el contenido de este grupo fuera del chat. Por defecto es `false`. Esto NO controla el enlace de invitación, consulta `inviteLink`.
`permissions.subgroups`	boolean	No	Permite que los participantes que no son administradores creen subgrupos dentro del grupo. Por defecto es `false`
`ephemeral`	string	No	Activa los mensajes efímeros que se eliminan automáticamente. Desactivado por defecto. `enum: ['off', '24h', '7d', '90d']`

Respuestas

Código	Descripción
`200`	Grupo actualizado
`400`	Datos de consulta o de cuerpo de la solicitud no válidos
`401`	Acceso no autorizado debido a un token de API no válido o caducado
`403`	Faltan los permisos de grupo necesarios, o la operación fue rechazada por una restricción temporal de la cuenta de WhatsApp (`errorCode: account:restricted`, consulta `meta.reason` y `meta.expiresAt`)
`404`	Número no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Operación o sesión de WhatsApp no disponible: inténtalo de nuevo

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Update group information/permissions
curl --request PATCH \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/groups/{groupId} \
  --header 'Token: <api token goes here>'

AnteriorActualizar etiqueta SiguienteActualizar imagen de perfil

¿Te sirvió esta página?