REST API
Whapi.Cloud Список изменений
Whapi.Cloud был разработан как расширяемый продукт для программистов. Мы предлагаем простой и высокопроизводительный API для автоматизации WhatsApp. Наша команда постоянно улучшает API WhatsApp на основе ваших отзывов.
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
Исправлено
- Приведены к стандарту ограничения количества вариантов ответов в Опросах