REST API
Whapi.Cloud Список изменений
Whapi.Cloud был разработан как расширяемый продукт для программистов. Мы предлагаем простой и высокопроизводительный API для автоматизации WhatsApp. Наша команда постоянно улучшает API WhatsApp на основе ваших отзывов.
11 октября 2024
Новое
- Теперь сторисы (Статусы) можно отправлять большими партиями, до 10 000 контактов. Тесты показывают, что это работает и для 15-20 тысяч. Мы работаем над устранением этих ограничений и имеем подтвержденную гипотезу решения;
- Интеграция с n8n;
- Два новых эндпоинта: Получение и изменение данных профиля в версии WhatsApp Business;
- Добавлен параметр “linkedParent” в группу “анонсов”, который показывает ID связанной с сообществом группы;
Исправлено
- Исправлена проблема с обновлением изображений профиля/канала/группы;
- Адаптирован вебхук PATCH Chats: отображается только актуальная информация;
26 сентября 2024
Новое
- Кнопки в сообщениях теперь отображаются в приложении и в веб-версии. Подробнее о том, как отправлять различные типы кнопок читайте здесь:Отправляем кнопки в WhatsApp;
- Реализован эндпоинт для назначения администратора в сообществе;
- Реализован эндпоинт для понижения статуса администратора в сообществе до обычного участника;
- Модернизирован эндпоинт для полного управления настройками приватности в группе;
- Добавлены эндпоинты для Деактивации сообществ и Получения списка групп из коммьюнити;
- Разработан эндпоинт GET https://manager.whapi.cloud/partners для Partner API, позволяющий получить сведения о балансе партнера;
Исправлено
- Восстановили работу эндпоинта обновления иконок в группах;
- Добавлена дополнительная информация в респонс на добавление участника в сообщество;
- Поправлены коллбэки на исходящие сообщения с кнопками.
12 сентября 2024
Новое
- Добавлены кнопки! Новая функция, которая позволяет отправлять сообщения с кнопками быстрого ответа, кнопкой обратного вызова, кнопкой копирования OTP, кнопкой сторонней ссылки и кнопкой списка опций;
- Добавлена возможность отслеживать результаты голосования в Каналах (ньюслеттер). Более подробная информация о том, как работать с этой функцией, описана в нашей Базе знаний: Получение голосов из опросов в канале;
- Подготовлен новый конечный пункт, который позволит симулировать тестовый callback на любую ссылку. Это позволит быстро проверить ваш вебхук и получить форматы любых событий.;
- Добавлен тип сообщения "Событие", доступный в Сообществе;
Исправлено
- Исправлен Callback при изменении сообщения в каналах (ньюслеттер);
30 августа 2024
Новое
- Добавлен вебхук для получения информации о новом запросе на присоединение к группе. Позволяет получить мгновенный callback с полными деталями запроса;
- Теперь в "Получить информацию о группе по коду приглашения" можно получить информацию о количестве участников в группе;
- Добавлен новый эндпоинт (POST /stories/send/audio) для отправки голосовых сообщений в Историях (Статусах);
- Предусмотрена автоматическая компрессия слишком большого изображения при создании продукта;
Исправлено
- Исправлено поведение канала, которое отображало некорректный статус при неудачной телефонной связи. Теперь, когда сеанс не удается подключить к каналу, авторизация автоматически сбрасывается;
- Новые названия групп корректно отображаются в "Get Chats";
- Завершен ответ на запрос создания группы. Теперь отображается массив номеров, которые не удалось добавить в группу. Причины и решение описаны в нашей Базе знаний;
- Решены проблемы с перезаписью исходных ID сообщений на системные сообщения;
13 августа 2024
Новое
- Добавление нескольких номеров в группу теперь выполняется с помощью одного запроса, который группирует контакты в одно системное сообщение;
- Новый метод Subscribe to newsletter by invite code позволяет подписаться на канал, используя только invite_code;
- Аналогично, вы можете выйти из канала, используя метод Unsubscribe from newsletter by invite code;
- На странице истории выставления счетов на панели управления отображается кнопка для загрузки счета из Stripe;
Исправлено
- Восстановлен метод для обновления продукта;
- Восстановлен Webhook для изменения имени группы и изменения изображения профиля группы;
- Исправлена корректная работа архивации чатов;
- Правильный вывод изображений профилей каналов (newsletter): если изображения нет, параметр не отображается;
3 августа 2024
Новое
- Добавлен новый параметр no_encode в конечные точки отправки медиафайлов. Этот параметр предотвращает преобразование файлов с нашей стороны, решая проблемы с тайм-аутами во время длительных преобразований медиафайлов. Если вы уверены в своих кодеках, вы можете установить no_encode = true, чтобы отправить видео в его оригинальном формате. Обратите внимание, что это может повлиять на отображение видео в веб/телефонных версиях;
- Ответ Получить рассылки теперь отображает роль подключенного устройства (администратор, создатель, подписчик и т.д.);
- Добавлен параметр с ID рассылки и InviteCode в сообщение типа "Приглашение в канал" для упрощения автоматизации подписок на канал;
- Добавлена возможность загрузки по ссылке / через base64 / файл в POST /media;
Исправлено
- Исправлена отправка GIF-файлов;
- Исправлено получение изображений профиля из каналов (рассылок);
29 июля 2024
Исправлено
- Исправлена функция Отключения Номера. Выход из системы теперь работает быстро и правильно, отображая статус "Вышел из системы" в приложении;
- Стабилизировано подключение номеров к каналу для обеспечения правильного получения данных из приложения;
- Исправлена ситуация, когда системное сообщение появлялось вместо обычного сообщения с тем же ID;
- Каналы не выпадают из модуля Прогрева в случае перезагрузки;
- Оптимизирована базовая операция;
18 июля 2024 года
Новое
- Сообщества: Создать сообщество. Мы описали больше о том, как работает сообщество, в нашей базе знаний здесь. Из-за некоторых особенностей эта функция находится в стадии бета-тестирования. Пожалуйста, свяжитесь с командой поддержки, чтобы узнать больше деталей;
- Сообщества: Получить список всех сообществ на вашем номере. Есть также способ получить информацию о конкретном сообществе: Получить информацию о конкретном сообществе. Из-за некоторых особенностей эта функция находится в стадии бета-тестирования. Пожалуйста, свяжитесь с командой поддержки, чтобы узнать больше деталей;
- Сообщества: Привязать группу к сообществу и Отвязать группу от сообщества;
- Реализована отправка статусов (сторис) всем контактам в вашей телефонной книге, если не указаны конкретные номера;
- Оптимизирован процесс отправки статусов, позволяющий отправлять в 4-8 раз больше сторис за один раз (примерно 20 000);
- Новый метод Получить список запросов на присоединение к группе: возвращает список запросов на присоединение к группе;
- Новый метод Принять запросы на присоединение к группе для указанных пользователей. Позволяет одобрить запрос на присоединение к группе. Возвращает список с результатом операции для каждого пользователя;
- Новый метод Отклонить запросы на присоединение к группе для указанных пользователей. Позволяет отклонить запросы на присоединение к группе. Возвращает список с результатом операции для каждого пользователя;
- Отправить ссылку приглашения в канал: Реализован метод отправки приглашения в канал;
- Получить информацию о канале по коду приглашения: Новый метод для получения информации о канале. Полезно, если у вас есть ссылка на канал;
- Изменить канал: Реализован метод изменения данных канала (имя, изображение, описание, доступные реакции);
- Введены новые параметры “After” и “Before” в эндпоинте "Получить сообщения рассылки", которые позволяют получать количественно отфильтрованные сообщения;
- В формат коллбэка добавили название группы при входящем сообщении оттуда;
- Дополнительные настройки были добавлены в исходный код чекера на github, чтобы изменить паузу между проверками и количество номеров, проверяемых за раз;
- Новые полезные инструменты были добавлены на панель управления: Кодировщик Base64 и Создатель Vcard;
Исправлено
- Исправлена ошибка получения голосов в опросах в личных сообщениях;
- Исправлена ошибка получения фотографий профиля пользователей;
- Исправлена ситуация, когда эмодзи реакции на сообщение возвращал модифицированный ID оригинального сообщения;
- Получение /newsletters не ломается, если ранее удаленный канал включен в выборку (WhatsApp также предоставляет информацию о удаленных каналах);
- Восстановлена скорость обработки предпросмотра ссылок;
- Восстановлен триггер в формате коллбэка опроса;
- Исправлена ситуация в получении сообщений, когда статусы сообщений иногда отображались как pending, несмотря на то, что были доставлены;
- Исправлена ситуация, когда статус (сторис) изменяет ID после реакции;
25 июня 2024
Новое
- Бесплатный автоматический инструмент прогрева номеров;
- Партнерский API: Конечная точка для остановки канала с возвратом неиспользованных дней на баланс;
- Возможность отправки присутствия для групп (например, "печатает");
- Обработка и конвертация изображений .webp на лету;
- Производительность текущих функций улучшена;
Исправлено
- Исправлена настройка webhook для Group Patch;
22 апреля 2024 года (Посмотреть детали)
Новое
- Производительность канала оптимизирована для предотвращения частых переподключений, что обеспечивает стабильную работу;
- Автоматические видео и аудио конвертеры. Эта функция автоматически конвертирует медиафайлы в форматы и кодеки, совместимые с WhatsApp, устраняя проблемы с совместимостью медиа;
- Новый эндпоинт: Отправить приглашение администратору канала. В этом методе вы можете отправлять сообщения с приглашениями стать администраторами вашего WhatsApp канала в WhatsApp;
- Новый эндпоинт: Принять приглашение администратора канала. Этот метод отвечает за принятие приглашения стать администратором канала WhatsApp. Это приглашение — это сообщение, которое вы можете как отправить, так и получить через вебхук входящих сообщений;
- Новый эндпоинт: Отозвать приглашение администратора канала. Этот метод отвечает за аннулирование приглашения администратора канала WhatsApp;
- Новый эндпоинт: Удалить администратора канала. Этот метод отвечает за удаление пользователя из администрации канала WhatsApp;
- Введен новый тип сообщения admin_invite и формат входящего вебхука;
- Добавлены детали товара в вебхук входящих сообщений типа «продукт»;
- Добавлены детали группы в вебхук входящих сообщений типа «приглашение в группу»;
- Новый эндпоинт: Получить информацию о группе по коду приглашения. Этот метод возвращает метаданные группы со всей информацией о группе и ее участниках;
- Обработка входящих сообщений WhatsApp, начатых с платных реклам других социальных сетей;
- В эндпоинте «Получить медиафайлы» теперь можно сортировать файлы по дате добавления;
Исправлено
- Исправлен эффект пробела в имени файла при использовании ссылки из облака;
- Исправлено отображение предпросмотра ссылки, когда в тексте сообщения есть другие ссылки;
- Восстановлен вебхук Удаление пользователей: позволяет получать детали о сессии, отключенной от канала;
- Улучшено обнаружение бизнес-версии приложения для обмена сообщениями;
9 апреля 2024 года (Посмотреть детали)
Новое
- Синхронизация новых чатов. Если вам пишет новый контакт, этот диалог будет немедленно отображаться при использовании API вызова "Получить чаты";
- Настройка пользовательского заголовка в webhook. Реализован новый параметр "headers" (массив объектов) /settings, который позволяет передавать пользовательские заголовки в callback;
- В API вызове "Установить иконку группы" добавлена возможность использования файла по ссылке и MediaID для удобной интеграции с Make.com;
- В API вызове получения сообщений появился новый параметр "sort", который отвечает за сортировку выдаваемых сообщений. Где, sort=desc - по умолчанию, как это сейчас выводится от свежих к старым и sort=asc - обратная сортировка;
- В получении опросов появились два новых параметра: vote_limit - количество вариантов ответов, которые может выбрать пользователь, и total - считает сумму голосов за все варианты ответов;
- База знаний How-To для партнеров: пошаговый рабочий процесс, подробная документация и т. д.;
Исправлено
- Автономное стабилизирование проблемы каналов, зависающих в статусе запуска;
- Исправлено удаление файлов в облаке через 30 дней;
- Исправление для возврата дней партнерам на баланс при удалении канала по подписке;
1 апреля 2024 года (Посмотреть детали)
Новое
- Отправка кастомной ссылки приглашения в группу: "POST /groups/link/{InviteCode}". Метод для отправки ссылки-приглашения в группу WhatsApp, который позволяет настраивать предпросмотры ссылки и сообщения;
- Отправка каталога по ID контакта (номер телефона): "POST /business/catalogs/{ContactID}". Метод позволяет отправить ссылку на каталог. Разрешена настройка предпросмотра сообщения;
- Получение медиафайлов: "GET /media". Метод для получения всех файлов, сохраненных на облаке с вашего канала. Напоминаем, что теперь все файлы на облаке хранятся 30 дней;
- Webhook по событиям "контакты" для нового контакта, созданного в телефоне;
Исправлено
- ID опроса теперь не изменяется после голосования;
- ID сообщения теперь не изменяется после цитирования;
- Удаление MediaID теперь удаляет сам файл из облака;
- Исправлен порядок статусов доставлено и прочитано, когда чат открыт на телефоне.
15 марта 2024 года (Посмотреть детали)
Новое
- Значительное обновление бэкенда повышает производительность нашего API. Улучшена стабильность для работы с большим количеством чатов и большими группами, скорость обработки запросов увеличена в 4-8 раз;
- Отправка коротких видеосообщений: "POST /messages/short" позволяет отправлять новый тип видеосообщений, круглые короткие видео;
- Бета-тестирование: Получение смс-кода для регистрации номера через API без телефона."POST /users/login/mobile" позволяет регистрировать и подключать номера WhatsApp без телефона;
- Информация о просмотрах сторис (статусов) и сообщений в группе: "GET /statuses/{MessageID}" позволяет получать информацию о том, кто просмотрел ваш статус ("сторис") или сообщение в группе;
- Событие просмотра статуса (сторис) добавлен в вебхуки;
- Решена проблема отправки медиафайлов без расширения;
- Добавлены параметры Announcements и Restricted в деталях группы;
- Реализованы автоматические повторные попытки загрузки файлов в облако в случае ошибок;
- Добавлены новые настройки канала whapi (инстансов): Автоматическая загрузка изображений профиля всех контактов при авторизации номера, Режим оффлайн для вашего номера (влияет на уведомления iPhone), Загрузка старых/новых сообщений;
- Исходный код и руководство по API Google Sheets для рассылки через таблицы;
- Исходный код распределителя запросов между каналами для массовых рассылок и проверок номеров;
Исправлено
- Исправлена ошибка получения товаров;
- Исправлена ошибка расчета значения параметра Unread при получении чатов;
- Исправлена ошибка подсчета значения параметра Total при получении групп;
- Исправлена ошибка получения сообщений из WhatsApp каналов;
- Более точно определяется бизнес-версия номера;
16 января 2024
Новое
- Релиз интеграции с make.com;
- GET /users/{ContactID}/profile позволяет получить сведения о профиле (описание, картинку профиля) по номеру телефона, даже если он не находится в списке ваших контактов;
- "GET /business/{ContactID}/products" позволяет получить каталог и товары по номеру телефона, даже если он не находится в списке ваших контактов;
- Залит исходный код скрипта-рассыльщика по Google Таблице на ГитХаб;
Исправлено
- WhatsApp Каналы: обработка файлов и превью ссылок;
30 декабря 2023 (Посмотреть детали)
Новое
- "POST /messages/image" метод адаптирован для отправки медиасообщения в Канал;
- "Подписаться на рассылку" метод для присоединения к Каналу;
- "GET /newsletters/find" метод для поиска Каналов по критериям;
- "Получить сообщения рассылки" метод для получения списка публикаций из Канала;
- Проверка интеграции DialogFlow успешно завершена;
- GET /health позволяет получить IP-адрес канала для добавления в белый список;
- "POST /business/products" для создания товаров через API;
- "PATCH /business/products/{ProductID}" для модификации существующих продуктов через API;
- "GET /business/{ContactID}/products" получение списка продуктов по номеру телефона (не требует, чтобы этот номер был в вашем списке контактов. Владелец номера об этом не узнает);
- "GET /users/{ContactID}/profile" получение фотографии профиля и описания по номеру телефона (не требует, чтобы этот номер был в вашем списке контактов. Владелец номера об этом не узнает);
- Добавлен параметр "no_link_preview" к POST /messages/text для возможности отправки ссылки без предпросмотра;
Исправлено
- Исправлен подсчет реакций на сообщения в Каналах;
- Исправлен метод отправки нескольких визитных карточек (POST /messages/contact_list);
- Исправлено отображение различных MIME-типов;
- Исправлено появление новых чатов в GET /chats;
15 декабря 2023 года (Посмотреть детали)
Новое
- "GET /newsletters" метод для получения списка ваших Каналов WhatsApp;
- "POST /newsletters" метод для создания нового Канала;
- "POST /messages/text" метод, адаптированный для отправки сообщения в Канал;
- Интеграция DialogFlow (Бета-тестирование);
- Получение полноразмерных фотографий профиля контактов/чатов/групп;
Исправлено
- Исправлена проблема с исчезающими сообщениями;
- Исправлена обработка видео/аудио кодеков при отправке файла по ссылке;
- Отправка медиа по ID, полученному от устройства, когда авто-загрузка отключена;
- Унифицированный идентификатор сообщения в цитатах в группе;
28 Нояб, 2023 (Посмотреть детали)
Новое
- Авторизация по номеру телефона: Метод /users/login/{PhoneNumber};
- Регистрация нового WhatsApp аккаунта с помощью СМС или звонка: Метод /users/login/mobile;
- Система новых платформ (Позволяет определить или выбрать из готовых специализированных платформ устройств для подключения вашего номера. Снижает риск блокировки);
- Новая система логгов (Мы сможем отслеживать больше информации о канале в случае возникновения каких-либо проблем);
- WhatsApp Каналы (Alpha тестирование);
- Новые действия и триггеры в Zapier (Полная поддержка групп, медиасообщений и проверки номера на WhatsApp);
- Исходный код WhatsApp Checker на GitHub;
- Метод "GET /stories" для получения списка статусов (сторис) ваших контактов;
- Метод "POST /stories" для создания и публикации статусов (Whatsapp-версия сторисов);
Исправлено
- Обработка вебхуков при таймауте;
- Повторные попытки добавить файл в хранилище при неудаче;
- Влияние аватарок на получение чатов;
14 Нояб, 2023 (Посмотреть детали)
Новое
- Добавление контактов в адресную книгу WhatsApp через API (позволит добавлять в группы любые номера);
- Гарантированные хуки (продолжает отправлять уведомления, если есть какие-то проблемы на вашей стороне);
- Метод "Get order items" и вебхук на получение нового заказа (корзины);
- Возможность подключения ваших прокси через API в "Update channel settings";
- Стабильная работа канала при работе через мобильные прокси (повышается защита от блокировки на ~30%);
- Получение изображения профиля клиента, с которым есть диалог;
- Уведомления об изменениях аватарок профилей и групп;
- /health позволяет не только проверять статус канала, но и автономно запускать его в случае проблем;
- Добавлен лимит на Sandbox-каналы в 10000 запросов в месяц;
- При авторизации телефона подключение происходит через разные браузеры (снижение риска блокировок);
Исправлено
- Создание группы теперь возвращает полные данные группы, а не только её идентификатор;
- Некорректные ссылки при отправке Медиа будут отдавать 400 ошибку, а не 500;
- Параметр edit при отправке сообщений методом /linkPreview;
- Поправлен исходный код в ботах на GitHub;
25 Окт, 2023 (Посмотреть детали)
Новое
- Параметр EDIT в функции отправки сообщения (любого типа). Позволяет редактировать отправленные сообщения;
- GET /labels - Получить список меток (20 всего);
- GET /labels/{labelID} - Получить список ассоциаций меток;
- POST /labels/{labelID}/{itemID} - Присвоить ассоциацию метке (сообщение/диалог);
- DELETE /labels/{labelID}/{itemID} - Удалить ассоциацию;
- Webhooks: labels.post и labels.delete - новые метки и удаление меток;
- Webhooks: groups.put - изменения в участниках группы;
- Webhooks: groups.post - новые группы;
- Webhooks: groups.patch - обновление данных группы;
- Webhooks: contacts.patch - обновление контактов;
- messages.patch и chats.patch отправляют события, если метки сообщений и диалогов изменились;
Исправлено
- QR-код обновляется вовремя;
- Системные хуки не отправляются при загрузке;
- Обозначения всех subtype в ответе на запрос расшифрованы;
16 Окт, 2023 (Посмотреть детали)
Новое
- Добавлены вебхуки на различные события: Сообщения (новые/офлайн, редактирование, удаление), Статусы (сообщений), Чаты (получение, обновление, удаление), Статус номера (активность), Звонки (входящие, пропущенные, принятые, отклоненные), Пользователи (Логин/Логаут), Канал (изменение статуса канала, обновление QR)
- Добавлен параметр source, для определения источника сообщения (API / Web WhatsApp / Приложение)
- В настройках auto_download добавлены Стикеры
- Добавлены методы управления профилем юзера (имя / аватар / описание)
- Добавлены методы управления блокировками (добавить в черный список / удалить)
- Увеличили лимит base64 по длине запроса до 200мб
- Добавили и увеличили количество проксей на каналы (ставятся автоматически на новые каналы)
Исправлено
- Исправлен параметр lastMessage при получении чатов
- Исправлено получение аватарок в новых группах
- Внедрен корректный target в вебхуке при реакции на сообщение
25 Сен, 2023
Новое
- Добавлен метод "Get presence". Позволяет получать статусы номеров и, например, разработать Last Seen Checker
- Добавлена возможность отображать статусы "печатает" или "записывает аудио" в методе /presences
Исправлено
- Исправлены методы "Получить иконку группы" и "Удалить иконку группы"
- Исправлено отображение статуса "прослушано" для аудиосообщений
Сентябрь 21, 2023
Новое
- Добавлена фильтрация по автору в /messages/list
- Добавлен параметр typing_time для отображения состояния набора в /messages/text
- Добавлен параметр recording_time для отображения состояния записи в /messages/voice
- Добавлен параметр ephemeral для включения исчезающих сообщений
- Добавлен параметр link_preview для отображения превью ссылки в /messages/text
Исправлено
- Значение общего количества сообщений в методе /messages/list отображается корректно
- ID одного и того же сообщения в хуках 'Message' и 'Ack' привели к единому формату
Сентябрь 15, 2023
Новое
- Добавлен метод для добавление участников в группу
- Внедрена платежная система Stripe
Исправлено
- Приведены к стандарту ограничения количества вариантов ответов в Опросах