API de WhatsApp y CRM
PATCH/devices/{deviceId}/groups/{groupId}/participants

Promover/degradar participantes

Promueve o degrada participantes como administradores o miembros en un grupo específico mediante el ID de WhatsApp.

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}/participants

Promueve o degrada participantes como administradores o miembros en un grupo específico mediante el ID de WhatsApp.

Para evitar problemas de procesamiento, no se recomienda actualizar más de 10 participantes a la vez por solicitud a la API.


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

CampoTipoObligatorioDescripción
participantsarray<object>SíParticipantes del grupo por número de teléfono.

Respuestas

CódigoDescripción
200Permisos de los participantes actualizados
400Datos de consulta o de cuerpo de la solicitud no válidos
401Acceso no autorizado por token de API no válido o caducado
403Faltan los permisos de grupo requeridos, la función no es compatible con el plan actual, 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)
404Grupo o dispositivo no encontrado
409Conflicto
429Demasiadas solicitudes: inténtalo de nuevo más tarde
500Error inesperado
501No implementado
503Operació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

// Promote and demote participants
curl --request PATCH \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/groups/{groupId}/participants \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"participants":[{"phone":"+1234567890","admin":false},{"phone":"+1234567890","admin":true}]}'
AnteriorPDF de la facturaSiguienteRechazar miembro del grupo
¿Te sirvió esta página?