Перейти к основному содержанию
GOWA называет каналы WhatsApp информационными письмами в своем API. Все запросы на этой странице используют базовую аутентификацию и подключенное устройство, выбранное 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.

Отслеживать или отписаться

Используйте такое же тело JSON с именем 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 при сбое обновления.
Удаление подписки прекращает продление. WhatsApp может продолжать предоставлять обновления до тех пор, пока не истечет срок действия подписки. Отмена не восстанавливается пересоединением или продлением рейса. Удаление канала без подписки возвращает ошибку подтверждения.
Подписки хранятся в памяти и не перезапускаются сервером. Пересоздайте их после перезапуска GOWA. Статус подписки принадлежит выбранному устройству.

Скачать канал

Конечная точка извлекает этот пост непосредственно из WhatsApp и сохраняет поддерживаемый медиа-файл в каталог на сервере. Его JSON results содержит server_id, message_id, status, media_type, mime_type, filename, file_path, file_url, и file_size. Обработчик REST предоставляет file_url в качестве публичного статического URL для сохраненного файла. Это не двоичный файл ответа. Отсутствует пост или пост без загрузки медиа-файла возвращает ошибку.