> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Canales de WhatsApp

> Busca, sigue y lee boletines, descarga los medios de comunicación y recibe actualizaciones de compromiso en vivo.

GOWA llama a los canales de WhatsApp **boletines de noticias** en su API. Todas las peticiones de esta página usan Auth Básica y un dispositivo de inicio de sesión seleccionado por `X-Device-Id`. Un ID de canal termina en `@newsletter`; un número de contacto o grupo JID no es un ID de canal.

Establezca la URL del servidor y las credenciales antes de ejecutar los ejemplos de curl. Utilice la URL pública HTTPS para un servidor remoto e incluya `APP_BASE_PATH` cuando esté configurado.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Buscar un canal

Busca metadatos de canal en `newsletter_id` o `invite`. Suministra exactamente uno. Una invitación puede ser un enlace completo `https://whatsapp.com/channel/...` o su código.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'invite=https://whatsapp.com/channel/0029Va4K0PZ5a245NkngBA2M' \
  "$GOWA_URL/newsletter/info"
```

`results` contiene los metadatos del canal, incluyendo su ID, los metadatos del hilo, y los metadatos del visor. Invitar búsquedas soporta metadatos públicos sin seguir el canal. La búsqueda de JID depende del acceso de la cuenta seleccionada al canal. `viewer_metadata` puede ser `null` cuando WhatsApp sólo suministra metadatos públicos.

Para navegar por el directorio, proporcione al menos un código de país. Para buscar por nombre, utilice `search_text`.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'country_codes=ID' --data-urlencode 'view=TRENDING' \
  --data-urlencode 'limit=20' "$GOWA_URL/newsletter/directory"

curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'search_text=news' "$GOWA_URL/newsletter/directory"
```

| Consulta | Comportamiento |
| - | - |
| `view` | `RECOMMENDED` por defecto. También acepta `TRENDING`, `POPULAR`, `NEW`, y `FEATURED`. Los nombres de las búsquedas ignoran esta selección. |
| `country_codes` | ISO códigos de dos letras, repetidos o separados por comas. Necesario para navegar. Las búsquedas de nombres no soportan el filtrado de países. |
| `categories` | Valores repetidos o separados por comas de `BUSINESS`, `ENTERTAINMENT`, `LIFESTYLE`, `NEWS`, `ORGANIZATIONS`, `PEOPLE`, y `SPORTS`. |
| `limit` | Default `20`, range `1`–`50`. |
| `cursor` | Usa los `results.next_cursor` de la respuesta precedente mientras que `results.has_more` es `true`. |

Las respuestas de directorio ponen canales en `results.data`. El directorio utiliza consultas WhatsApp indocumentadas y puede cambiar independientemente de GOWA.

## Seguir o dejar de seguir

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/follow" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

Utiliza el mismo cuerpo JSON con `POST /newsletter/unfollow` para dejar de seguir. `GET /user/my/newsletters` muestra los boletines seguidos por la cuenta seleccionada.

Seguir un canal y suscribirse a las actualizaciones de participación en vivo son operaciones separadas. Gestionar las suscripciones en vivo a través de `/newsletter/live-updates`.

## Leer mensajes y contadores

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'count=50' "$GOWA_URL/newsletter/messages"
```

`GET /newsletter/messages` lee publicaciones directamente desde WhatsApp sin necesidad de seguirlas. El historial disponible está controlado por WhatsApp. GOWA no garantiza una ventana de retención o archivo completo. `count` por defecto es `50` y acepta `1`–`100`. Para cargar mensajes antiguos, pase el más antiguo `server_id` devuelto como `before`.

`results.data` contiene publicaciones con `server_id`, `message_id`, `type`, `timestamp`, `text`, `views_count`, `forwards_count`, y opcional `reaction_counts`. Los campos de contenido pueden ser escasos. WhatsApp reporta vistas a los administradores del canal; otras cuentas pueden ver `views_count: 0`.

Usa el `server_id` numérico, en lugar de `message_id`, para paginación y descargas de medios.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  --data-urlencode 'after=123' --data-urlencode 'count=50' \
  "$GOWA_URL/newsletter/message-updates"
```

`GET /newsletter/message-updates` actualiza los contadores sin obtener el contenido de los mensajes. `after` es obligatorio y debe ser un ID de servidor positivo. `count` tiene un valor predeterminado de `50`, con un máximo de `100`. El parámetro opcional `since` es una marca de tiempo Unix no negativa en segundos. Los resultados usan el mismo formato de lista `results.data`, y los campos de contenido se omiten cuando WhatsApp no los devuelve.

## Recibir actualizaciones en vivo

Configura un [webhook](https://gowa-docs.mintlify.site/es/concepts/webhooks.md), luego suscribe cada dispositivo a los canales que necesita.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H "X-Device-Id: $DEVICE_ID" -H 'Content-Type: application/json' \
  "$GOWA_URL/newsletter/live-updates" \
  --data '{"newsletter_id":"120363024512399999@newsletter"}'
```

Los `results` de la respuesta contienen `newsletter_id`, `duration_seconds`, `expires_at`, `renewed_at`, y opcional `last_error`. WhatsApp otorga una suscripción corta, observada en unos 90 segundos. GOWA la renueva antes de la expiración y después de reconectos. Los eventos contadores llegan como webhooks `newsletter.message`.

Lista de suscripciones con `GET /newsletter/live-updates`. Su `results.data` incluye los mismos campos de estado. Inspecciona `last_error` cuando la renovación falla.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" -X DELETE --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/live-updates"
```

La eliminación de una suscripción detiene la renovación. WhatsApp puede continuar enviando actualizaciones hasta que la subvención existente caduque. Una cancelación no se reaviva mediante una reconexión o una renovación en el vuelo. Eliminar un canal sin suscripción devuelve un error de validación.

> [!NOTE]
>
> Las suscripciones se mantienen en memoria y no sobreviven a un reinicio del servidor. Re-crearlas después de reiniciar GOWA. El estado de suscripción pertenece al dispositivo seleccionado.

## Descargar medios del canal

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" --get \
  -H "X-Device-Id: $DEVICE_ID" \
  --data-urlencode 'newsletter_id=120363024512399999@newsletter' \
  "$GOWA_URL/newsletter/messages/123/download"
```

El endpoint obtiene que publica directamente desde WhatsApp y guarda los medios soportados en el directorio de medios del servidor. Su JSON `results` contiene `server_id`, `message_id`, `status`, `media_type`, `mime_type`, `filename`, `file_path`, `file_url`, y `file_size`. El manejador REST proporciona `file_url` como una URL estática pública para el archivo guardado. Esta no es una respuesta de archivo binario. Una entrada faltante o una entrada sin un medio descargable devuelve un error.


## Related topics

- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/es/index.md)
- [Comprobar si el usuario está en WhatsApp](https://gowa-docs.mintlify.site/es/api-reference/user/comprobar-si-el-usuario-está-en-whatsapp.md)
- [Referencia de configuración](https://gowa-docs.mintlify.site/es/configuration.md)
- [Límites de envío](https://gowa-docs.mintlify.site/es/advanced/rate-limiting.md)
- [Autenticación](https://gowa-docs.mintlify.site/es/authentication.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.