ZAPPIO Docs

Apariencia

Grupos ​

Una instancia conectada puede enviar mensajes a los grupos de WhatsApp de los que su número forma parte. Los grupos se identifican con un id público grp_...; ZAPPIO nunca expone el identificador interno de WhatsApp.

Listar los grupos de una instancia ​

Necesita el scope instances:read.

bash
curl "https://zappio.cloud/api/v1/instances/ins_.../groups" \
  -H "Authorization: Bearer $ZAPPIO_API_KEY"
json
{
  "data": [
    {
      "id": "grp_01EXAMPLE00000000000000001",
      "name": "Equipo Acme",
      "participants_count": 12,
      "synced_at": "2026-01-31T14:05:09+00:00"
    }
  ]
}

La instancia debe estar conectada. El listado devuelve todos los grupos, sin paginación.

Enviar un mensaje a un grupo ​

Usa el id del grupo como to. Funciona igual para texto y multimedia (Enviar mensajes, Multimedia):

bash
curl -X POST "https://zappio.cloud/api/v1/messages" \
  -H "Authorization: Bearer $ZAPPIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance": "ins_...",
    "to": "grp_...",
    "type": "text",
    "text": "Buen día, equipo"
  }'

Si el id no es un grupo de esa instancia, responde 404 GROUP_NOT_FOUND.

Recibir mensajes de grupo ​

Los mensajes entrantes de un grupo llegan por webhook como message.received con:

  • group_id: el id público del grupo (grp_...).
  • from: el número de quien escribió.

Ver message.received.

Los grupos no cuentan como instancias

Un grupo es un chat de la instancia; no ocupa una instancia adicional de tu plan.