Crear grupo

Crea un chat de grupo con un nombre y participantes, opcionalmente con una descripción y permisos de publicación.

API de WhatsApp y CRM

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

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

Crea un chat de grupo con un nombre y participantes, opcionalmente con una descripción y permisos de publicación.

Importante: la creación de grupos es un proceso potencialmente lento que puede fallar si no se cumplen ciertas condiciones de tu número, por ejemplo cuando tu número de WhatsApp ya tiene cientos de chats de grupo o miles de chats activos. Para minimizar posibles problemas, se recomienda crear un grupo solo con uno o dos participantes y, una vez creado correctamente, añadir después los participantes adicionales en lotes de 10 participantes por solicitud mediante el [endpoint de la API para añadir participantes](#operation/addGroupParticipants).

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	Sí	Nombre del grupo `minLength: 1` · `maxLength: 100`
`description`	string	No	Descripción del grupo de hasta 500 caracteres `minLength: 1` · `maxLength: 500`
`permissions`	object	No	Permisos de publicación y edición de mensajes del grupo para los participantes
`permissions.edit`	string	No	Permisos para editar los ajustes del grupo. Por defecto `all`. `enum: ['all', 'admins']` · `default: all`
`permissions.send`	string	No	Permisos de publicación de mensajes en el grupo. Por defecto `all`. `enum: ['all', 'admins']` · `default: all`
`permissions.invite`	string	No	Permisos para invitar a nuevos participantes al grupo. Por defecto `all`. `enum: ['all', 'admins']` · `default: all`
`permissions.inviteLink`	string	No	Quién puede compartir el enlace de invitación de este grupo. Por defecto `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 `admins`. `enum: ['all', 'admins']`
`permissions.approval`	boolean	No	Indica si los administradores deben aprobar a los nuevos participantes del grupo `default: False`
`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 `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 `false`
`ephemeral`	string	No	Activa los mensajes efímeros que se eliminan automáticamente. Desactivado por defecto. `enum: ['off', '24h', '7d', '90d']`
`participants`	array<object>	Sí	Participantes del grupo por número de teléfono. Se requiere al menos un participante.

Respuestas

Código	Descripción
`200`	Grupo creado
`400`	Datos de consulta o cuerpo de la solicitud no válidos
`401`	Acceso no autorizado por token de API no válido o caducado
`403`	Operación no admitida: se requiere actualizar el plan, 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`	Ya existe un grupo con el mismo nombre
`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

// Create new group
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/groups \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"Sample Group","participants":[{"phone":"+1234567890"}]}'

AnteriorCrear etiqueta SiguienteCrear número

¿Te sirvió esta página?