X-Device-Id. ID канала заканчивается в @newsletter; номер контакта или группы JID не является идентификатором канала.
Установите URL сервера и учетные данные перед запуском примера curl. Используйте публичный URL-адрес HTTPS для удаленного сервера и включите APP_BASE_PATH при настройке.
Найти канал
Посмотрите метаданные канала по ссылкеnewsletter_id или invite. Посылайте ровно один. Приглашение может быть полным https://whatsapp.com/channel/... или его кодом.
results содержит метаданные канала, включая его ID, метаданные потока и метаданные просмотра. Поиск приглашений поддерживает публичные метаданные без следования за каналом. Поиск JID зависит от доступа выбранного аккаунта к каналу. viewer_metadata может быть null, если WhatsApp предоставляет только публичные метаданные.
Для просмотра каталога укажите по крайней мере один код страны. Для поиска по имени используйте search_text.
Ответы каталога помещают каналы в
results.data. Каталог использует недокументированные запросы WhatsApp и может меняться независимо от GOWA.
Отслеживать или отписаться
POST /newsletter/unfollow, чтобы отписаться. GET /user/my/newsletters отображает рассылку с последующим выбранным аккаунтом.
После канала и подписка на онлайн вовлечение - отдельная операция. Управляйте прямыми подписками через /newsletter/live-updates.
Читать сообщения и счетчики
GET /newsletter/messages читает публикации напрямую из WhatsApp без необходимости подписываться. Доступная история определяется WhatsApp. GOWA не гарантирует определённый срок хранения или полный архив. По умолчанию count равен 50 и принимает значения от 1 до 100. Чтобы загрузить более старые публикации, передайте server_id самой старой из полученных публикаций в качестве before.
results.data содержит записи server_id, message_id, type, timestamp, text, views_count, forwards_count, и необязательный reaction_counts. Содержимое полей может отсутствовать. WhatsApp отчеты просматривают администраторы каналов; другие аккаунты могут видеть views_count: 0.
Используйте числовые server_id, а не message_id, для пагинации и загрузки медиафайлов.
GET /newsletter/message-updates обновляет счетчики без получения содержимого сообщения. after является обязательным и должен быть идентификатором положительного сервера. count по умолчанию 50, максимум 100. Необязательная since - это неотрицательная отметка времени Unix в секундах. Результаты используют те же results.data, без полей содержимого, когда WhatsApp не возвращает их.
Получать обновления в реальном времени
Настройте webhook, затем подпишите каждое устройство на нужные ему каналы.results содержится newsletter_id, duration_seconds, expires_at, renewed_at, и необязательный last_error. WhatsApp предоставляет короткую подписку, наблюдаемую примерно за 90 секунд. GOWA обновляет ее до истечения срока действия и после переподключения. Счетчик событий поступает в виде вебхуков newsletter.message.
Список подписок с GET /newsletter/live-updates. Его results.data включает в себя те же поля состояния. Проверять last_error при сбое обновления.
Подписки хранятся в памяти и не перезапускаются сервером. Пересоздайте их после перезапуска GOWA. Статус подписки принадлежит выбранному устройству.
Скачать канал
results содержит server_id, message_id, status, media_type, mime_type, filename, file_path, file_url, и file_size. Обработчик REST предоставляет file_url в качестве публичного статического URL для сохраненного файла. Это не двоичный файл ответа. Отсутствует пост или пост без загрузки медиа-файла возвращает ошибку.