Changelog

Maytapi Changelog

Здесь мы объявляем о новых функциях и изменениях, которые мы внесли в API WhatsApp

Октябрь 2026

12.10.2026

15 Новое11 Исправлено
Новое
- Упоминайте всех сразу - sendMessage теперь поддерживает @all, поэтому одно сообщение может уведомить всех участников группы без перечисления каждого номера; см. пример 'Mention Everyone Message'
- Проводите викторины в своих каналах WhatsApp - новый тип channel_quiz в sendMessage позволяет опубликовать вопрос с правильным ответом, а getMessage / channel/getMessages возвращают варианты, правильный вариант и количество голосов, чтобы вы могли отслеживать результаты
- Присоединяйтесь к обсуждению под своими объявлениями - sendMessage теперь может публиковать комментарии к сообщениям группы объявлений сообщества (см. пример 'Comment Message'), а в ответах сообщений есть replyCount и полный список комментариев
- Метки теперь приходят в ваш webhook - при добавлении или удалении метки в чате вы получаете сообщение label/add или label/remove, чтобы в реальном времени отражать метки WhatsApp в своей CRM
- Полный контроль над профилем - читайте и обновляйте отображаемое имя, текст «о себе» и имя пользователя WhatsApp подключённого номера с помощью новых эндпоинтов getProfileName / setProfileName, getProfileAbout / setProfileAbout и getProfileUsername / setProfileUsername (getProfileAbout/{conversation_id} также читает «о себе» другого контакта)
- Смотрите, кого вы заблокировали - новый эндпоинт /{phone_id}/getBlockContacts возвращает заблокированные контакты номера
- Узнайте свою квоту новых чатов до того, как исчерпаете её - /{phone_id}/getNewChatLimit показывает, ограничивает ли WhatsApp первые сообщения новым контактам для номера, сколько квоты использовано и когда сбрасывается цикл. Это ограничение сейчас тестируется WhatsApp и пока появляется только у новых аккаунтов WhatsApp
- Управляйте бизнес-профилем через API - getBusinessProfile, getBusinessProfile/{conversation_id} и setBusinessProfile позволяют читать свой или чужой публичный бизнес-профиль и обновлять описание, адрес, email, сайты и часы работы
- Решайте, кто видит ваши истории - getStoryPrivacy и setStoryPrivacy управляют аудиторией историй (все контакты, список разрешённых или список исключённых) номера
- Находите подгруппы сообщества и вступайте в них - community/unjoinedSubGroups/{conversation_id} выводит подгруппы, к которым вы ещё не присоединились, а community/joinSubGroup присоединяет к одной из них
- Более богатые истории - createStory теперь поддерживает аудиоистории (пока только файлы OGG/Opus .oga), собственный backgroundColor для текстовых историй и аудиторию для каждой истории через contacts / excludeContacts
- Группы знают своё сообщество - getGroups теперь возвращает communityId и isCommunityAnnounce, чтобы вы понимали, какие группы входят в сообщество и какая из них является группой объявлений
- Фильтруйте контакты по типу - новый параметр type (group или contact) в /getContacts возвращает только нужные записи
- Выбирайте между скоростью и актуальностью - /getConversations/{conversation_id} принимает fromCache и fresh, чтобы мгновенно отдавать данные из кэша или принудительно читать актуальные
- Больше точек выхода по всему миру - новые регионы прокси: Россия, Мексика, Гонконг, Сингапур, Вьетнам, Украина, США, Италия, Малайзия, Ливан и Мадагаскар
Исправлено
- Исправлен createGroup
- Исправлена проблема автоматического выхода (logout) инстансов
- Применено расширенное исправление для состояния conn-retry - сокет-соединения инстансов с WhatsApp стали значительно стабильнее
- Добавлен резервный механизм возврата медиаконтента в виде ссылки - теперь ссылка возвращается всегда, когда инстанс подключён (это и раньше работало очень надёжно)
- Исправлены getGroups и getCommunities
- Исправлены действия profileImage
- Исправлен call/start
- Исправлены эндпоинты acceptGroupInvite и createCallLink
- Исправлена запись входящих медиафайлов с неверным расширением (.jpeg, .mp4), когда подпись содержала эмодзи
- Исправлена проблема cipherText, из-за которой инстансы зависали
- Исправлен эндпоинт deactiveCommunity
Сентябрь 2026

15.09.2026

8 Новое6 Исправлено
Новое
- Добавлен параметр days в /getConversations для возврата только бесед за последние N дней
- Добавлен параметр refresh в /getGroups и /getGroups/{conversation_id} для повторного получения информации о группе из WhatsApp; кэшированные данные могут по-прежнему возвращать номера @lid даже после их преобразования в @c.us, поэтому использование refresh остаётся на ваше усмотрение
- Увеличен лимит размера отправляемых медиа в sendMessage до 50MB
- Увеличен лимит входящего медиаконтента (при получении сообщений) с 40MB до 180MB
- Увеличен размер предпросмотра ссылок для сообщений channel_link в sendMessage (с автоматическим переходом на меньший предпросмотр, если больший не может быть отправлен)
- Добавлена поддержка аудио mp3 в sendMessage — файлы mp3 теперь отправляются корректно
- Добавлены новые прокси-регионы: South America (Ecuador exit), Colombia, South Africa, Argentina, North Africa (Egypt exit), Southeast Asia (Indonesia exit), Israel, Cameroon, United Kingdom, Brazil, Spain, Chile и India
- Добавлено поле isVideo в уведомления о входящих звонках (info-сообщения с subtype call/ringing, call/miss, call/reject или call/accept), указывающее, является ли звонок видеозвонком
Исправлено
- Исправлена ошибка 'Contact could not found' в sendMessage — ошибка больше не возникает при отправке сообщений
- Исправлен ответ 'CreateGroup could not complete.' в createGroup
- Исправлена ошибка с сообщениями channel_text в sendMessage
- Исправлена ошибка с сообщениями forward в sendMessage
- Улучшена проверка номеров телефонов в checkPhones
- Исправлен слушатель вызовов для текущих звонков (call/ringing)
Август 2026

14.08.2026

2 Новое6 Исправлено
Новое
- Добавлен опциональный статический IP для вебхуков — теперь вы можете включить статический IP на странице console.maytapi.com/developers/webhook, чтобы доставка вебхуков приходила через один канал (IP)
- Добавлен тип сообщения channel_question — теперь вы можете отправлять вопросы с возможностью ответа в каналы WhatsApp; вопрос и ответы на него (с именем ответившего, а также id/phone, если номер сохранён) возвращаются в getMessage и channel/getMessages
Исправлено
- Исправлен случай, когда при отправке сообщений channel_media медиа иногда не отображалось
- Исправлен случай, когда правки message_edit иногда не доставлялись через вебхук
- Исправлена ошибка в эндпоинтах getGroups и getCommunities
- Исправлена проблема, из-за которой товары не добавлялись в эндпоинте /catalog/addProduct
- Внесено исправление для случая, когда getCommunities иногда возвращал участников в формате lid — некоторые участники всё ещё могут возвращаться как lid
- Исправлена проблема, из-за которой сообщения с кнопками (buttons) не отправлялись
Июль 2026

08.07.2026

1 Новое8 Исправлено
Новое
- Добавлен эндпоинт /{phone_id}/disappearingConversations/{conversation_id} для установки таймера исчезающих (эфемерных) сообщений в личных чатах (выкл, 24 часа, 7 дней или 90 дней)
Исправлено
- Обнаружение события выхода (logout) сделано надёжным - количество незамеченных пропусков снижено до очень низкого уровня
- Исправлена проблема с недоставкой уведомлений о подтверждении (ack)
- Исправлено обнаружение QR-кода
- Исправлена проблема создания группы в эндпоинте createGroup
- Исправлена проблема, из-за которой события звонка (call/ringing) не поступали в вебхуки
- Исправлена обработка vCard в эндпоинте sendMessage
- Исправлена проблема при редактировании конфигурации старых групп
- Исправлена проблема в community/add, из-за которой приглашения не отправлялись приглашённым пользователям
Апрель 2026

21.04.2026

2 Новое4 Исправлено
Новое
- Добавлен тип сообщения carousel в эндпоинт SendMessage для отправки каруселных сообщений
- pinMessage теперь доставляется через вебхук как reaction, pollVoteUpdate, message_edit и event_response - закрепленное сообщение определяется по полю parentMsgId
Исправлено
- При отправке реакции через эндпоинт SendMessage, если целевое сообщение не найдено, вебхук теперь возвращает сообщение об ошибке 'Message could not found..!'
- Улучшена и исправлена функция загрузки сообщений в эндпоинтах reply_to, /getMessage/{msgId}, /getMessages/{conversation_id} и других связанных эндпоинтах
- Исправлена проблема получения медиа-контента во входящих медиа-сообщениях (возникала в ограниченных mp4 сообщениях)
- Значения duration в pinMessage через SendMessage теперь преобразуются в integer - старый строковый формат по-прежнему поддерживается
Март 2026

13.03.2026

1 Новое3 Исправлено
Новое
- Добавлена поддержка медиа-ссылок для сообщений с кнопками - теперь вы можете включать поле media с URL в запросах сообщений с кнопками
Исправлено
- Исправлены проблемы отправки сообщений типа sticker и product в эндпоинте SendMessage
- Исправлена функциональность эндпоинта /connectWithPhoneNumber
- Исправлена проблема models при отправке медиа-сообщений
Февраль 2026

20.02.2026

3 Новое6 Исправлено
Новое
- Добавлен прием сообщений типа order и их доставка через вебхуки для отслеживания заказов в WhatsApp
- Добавлены эндпоинты /{phone_id}/catalog/getOrders и /{phone_id}/catalog/getOrders/{orderId} для получения информации о заказах
- Добавлена функция отправки каталога в эндпоинте SendMessage для обмена каталогами товаров в беседах
Исправлено
- Исправлена проблема обнаружения каналов — теперь все каналы полностью возвращаются в ответах
- Исправлено обнаружение события выхода — теперь выход надежно определяется во всех сценариях
- Исправлена ошибка 500 в эндпоинте /{phone_id}/getGroups/{conversation_id}
- Исправлена ошибка отправки медиафайлов в эндпоинте SendMessage
- Исправлена работа эндпоинта BlockContact
- Исправлена ошибка проверки прав доступа в сообществах
Январь 2026

16.01.2026

1 Новое4 Исправлено
Новое
- Добавлена функциональность отправки медиа в канал (Gif) для обмена GIF-контентом в каналах
Исправлено
- Исправлена функциональность эндпоинтов /contacts/add, /contacts/remove и /contacts/edit для правильного управления контактами
- Исправлена проблема видимости голосов в типе сообщения опроса - голоса теперь отображаются правильно
- Улучшена загрузка предыдущих сообщений для функциональности reply_to
- Исправлена проблема временной метки в типе вебхука message_edit
Декабрь 2025

15.12.2025

2 Новое4 Исправлено
Новое
- Ispravleny vozvrashaemye znacheniya ID polzovatelya @lid v endpointah /contacts i /getConversations - teper vozvrashaetsya pravilnyj format c.us ili g.us
- Dobavleno pole description v endpointy /getGroups dlya polucheniya opisanij grupp
Исправлено
- Ispravlena funkcionalnost endpointa /group/add dlya pravilnogo upravleniya uchastnikami gruppy
- Ispravleny vozvrashaemye znacheniya ID polzovatelya @lid v payload-ah konversacii webhook - teper vozvrashaetsya format c.us ili g.us vmesto lid
- Ispravleny vozvrashaemye znacheniya ID polzovatelya @lid v payload-ah ack (podtverzhdeniya) - teper vozvrashaetsya format c.us ili g.us
- Ispravlena funkcionalnost tipa soobsheniya product v endpointe SendMessage
Ноябрь 2025

12.11.2025

2 Новое4 Исправлено
Новое
- Добавлены прокси-регионы Северной Африки, Юго-Восточной Азии и Аргентины для расширения возможностей глобального подключения
- Добавлены эндпоинты /{phone_id}/contact/add, /{phone_id}/contact/edit и /{phone_id}/contact/remove в Операции с контактами для программного управления контактами
Исправлено
- Исправлена функциональность типа forwardMessage в эндпоинте SendMessage
- Исправлена функциональность эндпоинта /{phone_id}/group/approvalRequestList/{conversation_id} для правильной обработки запросов на одобрение в группах
- Исправлена функциональность эндпоинта /{phone_id}/connectWithPhoneNumber для обеспечения стабильных подключений номеров телефонов
- Исправлена проблема автоматического выхода из системы, которая возникала сразу после сканирования QR-кода, для улучшения управления сеансами
Октябрь 2025

14.10.2025

6 Новое6 Исправлено
Новое
- Добавлен параметр deleteForEveryone к типу сообщения delete в эндпоинте SendMessage - установите true для удаления сообщений для всех участников или false для удаления только для себя
- Добавлено поле isBusiness в ответ эндпоинта /{phone_id}/getContacts для идентификации бизнес-аккаунтов
- Добавлен тип уведомления group/revoke_invite к вебхукам info-message для отслеживания изменений ссылок-приглашений в группы и получения обновленных ссылок
- Введен тип вебхука message-edit, который возвращает как исходное, так и измененное содержимое сообщения при редактировании сообщений
- Добавлен эндпоинт /{phone_id}/group/deleteProfileImage для удаления изображений профиля групп
- Добавлен эндпоинт /{phone_id}/clearConversations/{conversation_id} для очистки истории чата конкретных бесед
Исправлено
- Исправлены проблемы с функциональностью эндпоинта /{phone_id}/createGroup
- Исправлена обработка ошибок эндпоинта /{phone_id}/group/acceptInvite
- Исправлено поведение параметра запроса invite в эндпоинтах /{phone_id}/getGroups и /{phone_id}/getGroups/{conversation_id} - invite=true теперь корректно возвращает ссылки-приглашения, когда они доступны
- Исправлено сопоставление идентификаторов пользователей @lid в payload-ах сообщений вебхуков для отображения правильных идентификаторов пользователей
- Исправлена ошибка, возникающая при отправке ссылок через тип сообщения channel_text
- Улучшено отслеживание статуса выхода из системы во всех сценариях - события выхода теперь надежно сообщаются в вебхуках изменения статуса
Июль 2025

11.07.2025

7 Новое1 Исправлено
Новое
- Добавлен тип сообщения Приглашение в Канал к endpoint SendMessage для отправки приглашений в канал
- Добавлен тип сообщения Приглашение Администратора Канала к endpoint SendMessage для отправки приглашений администратора в каналы
- Добавлен endpoint /{phone_id}/channel/demote для понижения администраторов канала
- Добавлен endpoint /{phone_id}/channel/acceptAdminInvite для принятия приглашений администратора в каналы
- Добавлен endpoint /{phone_id}/channel/revokeAdminInvite для отзыва приглашений администратора из каналов
- Добавлен тип webhook channel-invite-message для захвата сообщений приглашения в канал
- Добавлен тип webhook channel-admin-invite-message для захвата сообщений приглашения администратора канала
Исправлено
- Исправлена проблема с изменением имени группы, где имена групп не обновлялись должным образом
Июль 2025

08.07.2025

5 Новое2 Исправлено
Новое
- Добавлены типы сообщений реакции и удаления реакции в endpoint SendMessage
- Добавлена функциональность звездного сообщения с параметром действия для отметки/снятия отметки сообщений
- Добавлен тип сообщения createEvent для создания событий WhatsApp с сообщением, описанием, startTime, endTime и местоположением
- Добавлен тип сообщения event_response в webhook payload для отслеживания ответов на события
- Добавлен тип channel_audio в endpoint SendMessage для аудио контента в каналах
Исправлено
- Исправлены пользовательские ID @lid в поддержке упоминаний в webhook payload сообщений
- Исправлены пользовательские ID @lid в поле участников информационных сообщений для отображения реальных номеров телефонов
Май 2025

05.05.2025

3 Новое3 Исправлено
Новое
- Добавлен параметр isHd в endpoint sendMedia для включения отправки изображений в HD, когда это поддерживается WhatsApp (Мы не конвертируем изображения в HD, мы отправляем их в HD только если WhatsApp поддерживает это)
- Улучшен endpoint createGroup с возможностью установки изображения и конфигурации при создании группы
- Добавлена функция возврата изображения в endpoint getGroups
Исправлено
- Исправлены ID пользователей @lid в группах и сообщениях, доставляемых через webhook
- Решены проблемы с цветом в endpoints createLabel и edit в разделе Labels
- Исправлена проблема отображения QR в endpoint /screen, где часть QR-кода не была видна
Апрель 2025

22.04.2025

7 Новое1 Исправлено
Новое
- Представлена функция вебхука locationLive для передачи обновлений местоположения в реальном времени через новый тип вебхука
- Улучшен конечный пункт sendMessage с поддержкой shortVideo для более универсальных вариантов обмена медиафайлами
- Расширены типы ответов вебхуков, включая формат ptv (видеозаметка), увеличивая разнообразие форматов видео, которые могут быть захвачены
- Добавлен конечный пункт /createLabel для создания пользовательских меток в WhatsApp Business с настраиваемыми именами и цветами
- Реализован конечный пункт /label/edit для изменения свойств существующих меток, включая атрибуты имени и цвета
- Добавлен конечный пункт /label/remove для одновременного удаления одной или нескольких меток из системы
- Представлен конечный пункт /label/getlabelColors для получения всех доступных вариантов цветов для меток WhatsApp Business
Исправлено
- Решены проблемы с отображением и обработкой анимированных стикеров для улучшения функциональности стикеров на всех платформах
Апрель 2025

09.04.2025

1 Новое2 Исправлено
Новое
- Изменен формат доставки webhook для уведомлений reaction и pollVoteUpdate - начиная с 30.04.2025, они будут доставляться только как подтипы в рамках типа message вместо структуры ack
Исправлено
- Исправлена проблема с конечной точкой /group/acceptInvite, теперь корректно обрабатываются сценарии ошибок ALREADY_JOINED_THE_GROUP, INVALID_INVITE_CODE и REMOVED_FROM_GROUP для лучшего управления приглашениями в группы
- Исправлена проблема с конечной точкой /group/acceptInviteV4, теперь корректно возвращаются ответы об ошибках ALREADY_JOINED_THE_GROUP и INVALID_INVITE_CODE для улучшенной обработки ошибок
Март 2025

17.03.2025

3 Новое1 Исправлено
Новое
- Представлены операции Community Chat для управления сообществами
- Добавлены новые операции Call Operations для улучшения функциональности обработки вызовов
- Добавлен статус call/ringing в информационное сообщение для лучшего отслеживания статуса вызова
Исправлено
- Исправлена проблема с эндпоинтом /{phone_id}/group/revokeInvite, пользователи теперь могут успешно изменять ссылки-приглашения в группы
Февраль 2025

24.02.2025

3 Новое2 Исправлено
Новое
- Добавлен тип list в endpoint SendMessage для отправки структурированных списочных сообщений
- Добавлены типы story_text и story_media в endpoint SendMessage для ответа на истории контактов
- Представлены endpoints /{phone_id}/contactsStories или /{phone_id}/contactsStories/{conversation_id} для просмотра историй ваших контактов с их ID переписки, которые можно использовать с типами story_text и story_media для ответов на истории
Исправлено
- Оптимизирована производительность endpoints /{phone_id}/contactsStories и /{phone_id}/getStories для улучшения времени отклика
- Улучшена производительность сканирования для ранее пропущенных типов сообщений group_invite
Февраль 2025

11.02.2025

1 Новое
Новое
- Представлена новая конечная точка статистики канала (/channel/statistics/{conversation_id}), предоставляющая комплексную аналитику, включая общее количество подписчиков, метрики охвата, данные о росте и географическое распределение аудитории вашего канала
Январь 2025

22.01.2025

3 Новое1 Исправлено
Новое
- Улучшена полезная нагрузка webhook с поддержкой ответов на принятие звонков, обеспечивая лучшее отслеживание принятых звонков в ваших разговорах
- Реализована функциональность ответа на отклонение звонков в полезной нагрузке webhook, позволяющая отслеживать отклоненные звонки через API WhatsApp
- Расширены типы полезной нагрузки сообщений webhook, включая group_invite и group_invite_v4, предоставляющие полную информацию о приглашениях в группы в ваших ответах webhook
Исправлено
- Исправлена и улучшена обработка ответов на пропущенные звонки в полезной нагрузке webhook для обеспечения более надежного отслеживания статуса звонков
Январь 2025

09.01.2025

1 Новое2 Исправлено
Новое
- Добавлена поддержка GIF-сообщений в конечной точке SendMessage, позволяющая отправлять анимированные GIF-файлы в ваших разговорах через WhatsApp API
Исправлено
- Исправлены ответы изображений в конечной точке getGroups/{conversation_id}
- Добавлена полная поддержка типа стикеров в конечной точке SendMessage
Декабрь 2024

17.12.2024

1 Новое3 Исправлено
Новое
- Инструмент JSON Escape/Unescape теперь доступен для эффективной обработки данных JSON. Инструмент помогает разработчикам правильно форматировать JSON-строки, обрабатывать специальные символы и проверять данные JSON с возможностью мгновенного предпросмотра и сохранения файлов. (Новый инструмент)
Исправлено
- Исправлена поддержка упоминаний в полезной нагрузке вебхука
- Исправлены проблемы с получением медиафайлов при получении контента из каналов (рекомендуется указывать значение count для получаемых медиафайлов)
- Исправлены проблемы с обновлением изображения профиля группы в конечной точке /group/setProfileImage - изображения группы теперь можно успешно изменять
Декабрь 2023

21.12.2023

9 Новое
Новое
- Каналы WhatsApp теперь доступны в нашем WhatsApp API, вы можете посетить документацию и ознакомиться с этим.
- Вы можете получить подробную информацию о своих историях в WhatsApp, а также делиться медиа (изображениями, видео) в своих историях в любое время.
- Вы можете получать реакции на свои сообщения в чатах WhatsApp через WhatsApp API.
- Вы можете отслеживать голоса, данные в опросах, размещенных в WhatsApp, в режиме реального времени через WhatsApp API.
- Истории пользователей в вашем списке контактов теперь доступны через WhatsApp API. Вы можете ознакомиться с разделом /contactsStories в документации в разделе Операции со Stories (Beta) для получения более подробной информации.
- Теперь вы можете отправлять стикеры через раздел сообщений стикеров в части 'SendMessage'.
- Теперь вы можете показывать индикатор набора текста для своих текстовых сообщений другой стороне.
- Мы настроили процесс отправки ссылок на каналы.
- Вы можете получить подробную информацию о своих сообщениях через конечные точки с 'Информацией о сообщении'.
- Теперь вы можете стать партнером с нашим API и управлять своими телефонами без каких-либо первоначальных платежей. Для получения подробной информации вы можете посетить страницу Партнер WhatsApp API

Получите ключ и отправьте первое сообщение за десять минут

Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.