Saltar al contenido principal
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.

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.
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.
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

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

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.
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, luego suscribe cada dispositivo a los canales que necesita.
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.
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.
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

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.