Новости и обновления
16.01.2024
-
Во все вебхуки на входящие сообщения, исходящие сообщения с телефона, исходящие сообщения по апи добавлено новое поле chat_type. Возможные значения - dialog или group.
-
В Webhook на статус профиля (authorization_status) добавлено новое поле с причиной разавторизации reason. Возможные значения - logout from device, logout from api, ban.
26.12.2023
-
В API добавлен новый метод "Архивировать чат". Теперь вы можете использовать URL api/sync/chat/archive, чтобы отправить чат в архив.
-
В API добавлен новый метод "Получить код авторизации". Теперь вы можете использовать URL api/sync/auth/code, чтобы получить код для авторизации в Whatsapp по номеру телефона. Позволяет получить код для авторизации с неавторизованного профиля. Код действителен 3 минуты.
-
В API добавлен новый метод "Разархивировать чат". Теперь вы можете использовать URL api/sync/chat/unarchive, чтобы вернуть чат из архива.
-
В API добавлен новый метод "Удалить чат". Теперь вы можете использовать URL api/sync/chat/delete, чтобы удалить чат (безвозвратно).
-
В API метод "Получить список чатов" в ответ к каждому чату добавлены два новых поля. Поле isDeleted показывает удален чат или нет. Поле isArchived показывает заархивирован чат или нет.
03.12.2023
-
В Webhook на входящий контакт добавлено новое поле contact, в котором будут отображаться данные пересылаемого контакта.
-
В API метод "Результат рассылки" в ответ добавлены новые поля. Поле id, в котором будет отображаться id каждого сообщения. Поле task_id, в котором будет отображаться id задачи.
-
В API метод "Получить список отправленных сообщений API" в ответ добавлено новое поле id, в котором отображается id каждого сообщения.
-
В API методы "Получить сообщение из чата", "Получить сообщение по ID", "Получить все сообщения профиля" в ответ добавлено новое поле delivery_status, в котором отображается статус доставки сообщения (может быть pending или delivered).
-
В Webhook на статус отправленного сообщения добавлено новое поле task_id, в котором будет отображаться id задачи (только для вебхуков со статусом pending).
-
В Webhook на исходящее сообщение API добавлены новые поля. Поле contact_name, в котором будет отображаться название чата, как оно записано на телефоне. Поле task_id, в котором будет отображаться id задачи.
-
В Webhook на исходящее сообщение с телефона добавлено новое поле contact_name, в котором будет отображаться название чата, как оно записано на телефоне.
-
Во все Webhook на входящие сообщения добавлено новое поле contact_name, в котором будет отображаться название чата, как оно записано на телефоне.
-
В API методе "Запустить рассылку Start" в ответе переименовано поле uuid на mass_posting_id.
18.08.2023
-
В API добавлен новый метод "Получить сообщение по ID". Теперь вы можете использовать URL api/sync/messages/id/get, чтобы получить сообщение по его ID. Метод имеет два обязательных параметра profile_id и message_id.
-
В API метод "Ответить на сообщение" добавлена возможность отправить файл. Для этого нужно в body запроса добавить необязательное поле url. Если не указывать url, то будет отправлен просто текст.Пример:
{ "body": "тестовый ответ на сообщение", "message_id": "3A55DB13083225830A8F", "url": "https://freetestdata.com/100KB_XLSX.xlsx" } -
В API метод "Переслать сообщение" добавлена возможность пересылки файлов.Пример:
{ "message_id":"3EB07AD49FD5A5FD394D", "recipient": "79215574354" }
04.06.2023
-
В API добавлена новая группа методов для работы с прокси. Добавлены методы "Получить proxy", "Установить proxy" и "Удалить proxy". Более подробно смотрите в Документации.
-
В API метод "Отправить контакт" добавлена возможность указать имя контакта. Для этого нужно в body запроса добавить необязательный параметр name. Если не указывать, то имя берется из сохраненного контакта.Пример:
{ "phone": "79602041930", "recipient": "79115576366", "name": "Имя контакта" } -
В API добавлена новая группа методов для работы с инструментом Рассылка сообщений, который позволяет запускать массовые рассылки. Добавлены методы "Запустить рассылку Start", "Приостановить рассылку Pause", "Возобновить рассылку Resume", "Закрыть рассылку Cancel", "Список всех рассылок" и "Результат рассылки". Более подробно смотрите в Документации.
-
Добавлена возможность использовать авторизацию для webhook - POST запрос от сервиса будет отправлен с заданным токеном в заголовке Authorization. Можно настроить в личном кабинете в Настройках уведомлений (вебхуки).
25.05.2023
-
В API методы "Получить сообщения из чата" и "Получить все сообщения профиля" добавлен необязательный параметр order (по умолчанию desc), который позволяет настраивать сортировку сообщений.
-
В API добавлен новый метод "Создать опрос". Теперь вы можете использовать URL api/sync/pool/create, чтобы создать опрос с возможностью настройки вариантов ответов.Пример:
{ "recipient": "79115576317", "body": "Тестовый опрос", "poll_options": ["да", "нет", "не знаю", "где я?"], "poll_select_count": 1 } -
Добавлен новый вид уведомлений Webhook на входящий опрос poll.Пример:
{ "messages": [ { "wh_type": "incoming_message", "profile_id": "91ad40e9-b023", "id": "3EB0F7485D1C02A618F3", "body": "Тестовый опрос", "type": "poll", "from": "79217304433@c.us", "to": "79602041920@c.us", "senderName": "Дмитрий", "chatId": "79217304433@c.us", "timestamp": "2023-05-22T12:47:09+03:00", "time": 1684748829, "from_where": "api", "is_forwarded": false, "stanza_id": "", "poll_options": [ "да", "нет", "не знаю", "где я?" ] } ] } -
Добавлен новый вид уведомлений Webhook на голосование в опросе poll_vote.Пример:
{ "messages": [ { "wh_type": "incoming_message", "profile_id": "501d59e1-0b07", "id": "3A8B4D1C2EF20C6F895C", "type": "poll_vote", "from": "79602041920@c.us", "to": "79217304433@c.us", "senderName": "Ми", "chatId": "79602041920@c.us", "timestamp": "2023-05-22T12:53:34+03:00", "time": 1684749214, "from_where": "phone", "is_forwarded": false, "stanza_id": "3EB0F7485D1C02A618F3", "poll_options": [ "да", "нет", "не знаю", "где я?" ], "selected_poll_variant": [ "да" ] } ] } -
В API методы "Получить сообщения из чата" и "Отметить сообщение прочитанным" добавлен необязательный параметр mark_all (по умолчанию false), который позволяет отметить прочитанными все непрочитанные сообщения в чате.
16.05.2023
-
В API методах "Получить сообщения из чата" и "Получить все сообщения профиля" изменена структура. Добавлено поле chatId, в котором указывается личный чат в формате "79115576367@c.us" или группа/сообщество в формате "389232323472744@g.us".
06.05.2023
-
В API добавлен новый метод "Отметить сообщение прочитанным". Теперь вы можете использовать URL api/sync/message/mark/read, чтобы отметить прочитанным любое непрочитанное вами сообщение в чате.Пример:
{ "message_id": "3EB04E6C3BF173879610C0" }Параметр “message_id” содержит идентификатор сообщения, которое вы хотите прочитать. -
В API метод "Получить все сообщения профиля" добавлены необязательные параметры limit (по умолчанию 200), offset (по умолчанию 0), date.
26.04.2023
-
Добавлен новый вид уведомлений - Webhook на статус приложения application_status. Теперь вы сможете получать уведомления о состоянии вашего приложения (online, offline). По умолчанию при создании профиля данный тип уведомлений выключен. Его можно включить в методе "Настройка типов webhook уведомлений". Не путайте с уведомлением о статусе авторизации профиля authorization_status, которое показывает авторизацию Whatsapp.Пример:
{ "messages": [ { "wh_type": "application_status", "profile_id": "11ad40e9-b023", "status": "online", "phone": "79902022982", "timestamp": "2023-05-01T22:04:44.198883039+03:00", "time": 1682967884 } ] }
10.04.2023
-
В API добавлен новый метод "Отправить реакцию на сообщение". Теперь вы можете использовать URL api/sync/message/reaction, чтобы поставить реакцию на любое сообщение в чате.Пример:
{ "body": "👍", "message_id": "3EB057D96C8E94E169BC" } -
Добавлен новый вид уведомлений - Webhook на входящую реакцию. При получении реакции будет передаваться соответствующий смайлик в поле body. Если клиент удалит реакцию, то в поле body будет передана строка "reaction_remove" ("body": "reaction_remove").Пример:
{ "messages": [ { "wh_type": "incoming_message", "profile_id": "33ad11e9-b222", "id": "3AA755D0E3567C18ACD9", "body": "😮", "type": "reaction", "from": "79223334455@c.us", "to": "79112224455@c.us", "senderName": "Александр", "chatId": "79223334455@c.us", "timestamp": "2023-03-20T20:56:05+03:00", "time": 1679334965, "from_where": "phone", "contact": null, "contact_name": "Александр", "is_forwarded": false, "stanza_id": "3EB026F1068B2822FAF1" } ] }