Maytapi Changelog


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


15.09.2026
Новое
  • Добавлен параметр 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)
    • 14.08.2026
    Новое
  • Добавлен опциональный статический IP для вебхуков — теперь вы можете включить статический IP на странице https://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) не отправлялись
    • 08.07.2026
    Новое
  • Добавлен эндпоинт /{phone_id}/disappearingConversations/{conversation_id} для установки таймера исчезающих (эфемерных) сообщений в личных чатах (выкл, 24 часа, 7 дней или 90 дней)
    • Исправлено
  • Обнаружение события выхода (logout) сделано надёжным - количество незамеченных пропусков снижено до очень низкого уровня
  • Исправлена проблема с недоставкой уведомлений о подтверждении (ack)
  • Исправлено обнаружение QR-кода
  • Исправлена проблема создания группы в эндпоинте createGroup
  • Исправлена проблема, из-за которой события звонка (call/ringing) не поступали в вебхуки
  • Исправлена обработка vCard в эндпоинте sendMessage
  • Исправлена проблема при редактировании конфигурации старых групп
  • Исправлена проблема в community/add, из-за которой приглашения не отправлялись приглашённым пользователям
    • 21.04.2026
    Новое
  • Добавлен тип сообщения 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 - старый строковый формат по-прежнему поддерживается
    • 13.03.2026
    Новое
  • Добавлена поддержка медиа-ссылок для сообщений с кнопками - теперь вы можете включать поле media с URL в запросах сообщений с кнопками
    • Исправлено
  • Исправлены проблемы отправки сообщений типа sticker и product в эндпоинте SendMessage
  • Исправлена функциональность эндпоинта /connectWithPhoneNumber
  • Исправлена проблема models при отправке медиа-сообщений
    • 20.02.2026
    Новое
  • Добавлен прием сообщений типа order и их доставка через вебхуки для отслеживания заказов в WhatsApp
  • Добавлены эндпоинты /{phone_id}/catalog/getOrders и /{phone_id}/catalog/getOrders/{orderId} для получения информации о заказах
  • Добавлена функция отправки каталога в эндпоинте SendMessage для обмена каталогами товаров в беседах
    • Исправлено
  • Исправлена проблема обнаружения каналов — теперь все каналы полностью возвращаются в ответах
  • Исправлено обнаружение события выхода — теперь выход надежно определяется во всех сценариях
  • Исправлена ошибка 500 в эндпоинте /{phone_id}/getGroups/{conversation_id}
  • Исправлена ошибка отправки медиафайлов в эндпоинте SendMessage
  • Исправлена работа эндпоинта BlockContact
  • Исправлена ошибка проверки прав доступа в сообществах
    • 16.01.2026
    Новое
  • Добавлена функциональность отправки медиа в канал (Gif) для обмена GIF-контентом в каналах
    • Исправлено
  • Исправлена функциональность эндпоинтов /contacts/add, /contacts/remove и /contacts/edit для правильного управления контактами
  • Исправлена проблема видимости голосов в типе сообщения опроса - голоса теперь отображаются правильно
  • Улучшена загрузка предыдущих сообщений для функциональности reply_to
  • Исправлена проблема временной метки в типе вебхука message_edit
    • 15.12.2025
    Новое
  • 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
    • 12.11.2025
    Новое
  • Добавлены прокси-регионы Северной Африки, Юго-Восточной Азии и Аргентины для расширения возможностей глобального подключения
  • Добавлены эндпоинты /{phone_id}/contact/add, /{phone_id}/contact/edit и /{phone_id}/contact/remove в Операции с контактами для программного управления контактами
    • Исправлено
  • Исправлена функциональность типа forwardMessage в эндпоинте SendMessage
  • Исправлена функциональность эндпоинта /{phone_id}/group/approvalRequestList/{conversation_id} для правильной обработки запросов на одобрение в группах
  • Исправлена функциональность эндпоинта /{phone_id}/connectWithPhoneNumber для обеспечения стабильных подключений номеров телефонов
  • Исправлена проблема автоматического выхода из системы, которая возникала сразу после сканирования QR-кода, для улучшения управления сеансами
    • 14.10.2025
    Новое
  • Добавлен параметр 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
  • Улучшено отслеживание статуса выхода из системы во всех сценариях - события выхода теперь надежно сообщаются в вебхуках изменения статуса
    • 11.07.2025
    Новое
  • Добавлен тип сообщения Приглашение в Канал к 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 для захвата сообщений приглашения администратора канала
    • Исправлено
  • Исправлена проблема с изменением имени группы, где имена групп не обновлялись должным образом
    • 08.07.2025
    Новое
  • Добавлены типы сообщений реакции и удаления реакции в endpoint SendMessage
  • Добавлена функциональность звездного сообщения с параметром действия для отметки/снятия отметки сообщений
  • Добавлен тип сообщения createEvent для создания событий WhatsApp с сообщением, описанием, startTime, endTime и местоположением
  • Добавлен тип сообщения event_response в webhook payload для отслеживания ответов на события
  • Добавлен тип channel_audio в endpoint SendMessage для аудио контента в каналах
    • Исправлено
  • Исправлены пользовательские ID @lid в поддержке упоминаний в webhook payload сообщений
  • Исправлены пользовательские ID @lid в поле участников информационных сообщений для отображения реальных номеров телефонов
    • 05.05.2025
    Новое
  • Добавлен параметр isHd в endpoint sendMedia для включения отправки изображений в HD, когда это поддерживается WhatsApp (Мы не конвертируем изображения в HD, мы отправляем их в HD только если WhatsApp поддерживает это)
  • Улучшен endpoint createGroup с возможностью установки изображения и конфигурации при создании группы
  • Добавлена функция возврата изображения в endpoint getGroups
    • Исправлено
  • Исправлены ID пользователей @lid в группах и сообщениях, доставляемых через webhook
  • Решены проблемы с цветом в endpoints createLabel и edit в разделе Labels
  • Исправлена проблема отображения QR в endpoint /screen, где часть QR-кода не была видна
    • 22.04.2025
    Новое
  • Представлена функция вебхука locationLive для передачи обновлений местоположения в реальном времени через новый тип вебхука
  • Улучшен конечный пункт sendMessage с поддержкой shortVideo для более универсальных вариантов обмена медиафайлами
  • Расширены типы ответов вебхуков, включая формат ptv (видеозаметка), увеличивая разнообразие форматов видео, которые могут быть захвачены
  • Добавлен конечный пункт /createLabel для создания пользовательских меток в WhatsApp Business с настраиваемыми именами и цветами
  • Реализован конечный пункт /label/edit для изменения свойств существующих меток, включая атрибуты имени и цвета
  • Добавлен конечный пункт /label/remove для одновременного удаления одной или нескольких меток из системы
  • Представлен конечный пункт /label/getlabelColors для получения всех доступных вариантов цветов для меток WhatsApp Business
    • Исправлено
  • Решены проблемы с отображением и обработкой анимированных стикеров для улучшения функциональности стикеров на всех платформах
    • 09.04.2025
    Новое
  • Изменен формат доставки 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 для улучшенной обработки ошибок
    • 17.03.2025
    Новое
  • Представлены операции Community Chat для управления сообществами
  • Добавлены новые операции Call Operations для улучшения функциональности обработки вызовов
  • Добавлен статус call/ringing в информационное сообщение для лучшего отслеживания статуса вызова
    • Исправлено
  • Исправлена проблема с эндпоинтом /{phone_id}/group/revokeInvite, пользователи теперь могут успешно изменять ссылки-приглашения в группы
    • 24.02.2025
    Новое
  • Добавлен тип 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
    • 11.02.2025
    Новое
  • Представлена новая конечная точка статистики канала (/channel/statistics/{conversation_id}), предоставляющая комплексную аналитику, включая общее количество подписчиков, метрики охвата, данные о росте и географическое распределение аудитории вашего канала
    • 22.01.2025
    Новое
  • Улучшена полезная нагрузка webhook с поддержкой ответов на принятие звонков, обеспечивая лучшее отслеживание принятых звонков в ваших разговорах
  • Реализована функциональность ответа на отклонение звонков в полезной нагрузке webhook, позволяющая отслеживать отклоненные звонки через API WhatsApp
  • Расширены типы полезной нагрузки сообщений webhook, включая group_invite и group_invite_v4, предоставляющие полную информацию о приглашениях в группы в ваших ответах webhook
    • Исправлено
  • Исправлена и улучшена обработка ответов на пропущенные звонки в полезной нагрузке webhook для обеспечения более надежного отслеживания статуса звонков
    • 09.01.2025
    Новое
  • Добавлена поддержка GIF-сообщений в конечной точке SendMessage, позволяющая отправлять анимированные GIF-файлы в ваших разговорах через WhatsApp API
    • Исправлено
  • Исправлены ответы изображений в конечной точке getGroups/{conversation_id}
  • Добавлена полная поддержка типа стикеров в конечной точке SendMessage
    • 17.12.2024
    Новое
  • Инструмент JSON Escape/Unescape теперь доступен для эффективной обработки данных JSON. Инструмент помогает разработчикам правильно форматировать JSON-строки, обрабатывать специальные символы и проверять данные JSON с возможностью мгновенного предпросмотра и сохранения файлов. (Новый инструмент)
    • Исправлено
  • Исправлена поддержка упоминаний в полезной нагрузке вебхука
  • Исправлены проблемы с получением медиафайлов при получении контента из каналов (рекомендуется указывать значение count для получаемых медиафайлов)
  • Исправлены проблемы с обновлением изображения профиля группы в конечной точке /group/setProfileImage - изображения группы теперь можно успешно изменять
    • 21.12.2023
    Новое
  • Каналы WhatsApp теперь доступны в нашем WhatsApp API, вы можете посетить документацию и ознакомиться с этим.
  • Вы можете получить подробную информацию о своих историях в WhatsApp, а также делиться медиа (изображениями, видео) в своих историях в любое время.
  • Вы можете получать реакции на свои сообщения в чатах WhatsApp через WhatsApp API.
  • Вы можете отслеживать голоса, данные в опросах, размещенных в WhatsApp, в режиме реального времени через WhatsApp API.
  • Истории пользователей в вашем списке контактов теперь доступны через WhatsApp API. Вы можете ознакомиться с разделом /contactsStories в документации в разделе Операции со Stories (Beta) для получения более подробной информации.
  • Теперь вы можете отправлять стикеры через раздел сообщений стикеров в части 'SendMessage'.
  • Теперь вы можете показывать индикатор набора текста для своих текстовых сообщений другой стороне.
  • Мы настроили процесс отправки ссылок на каналы.
  • Вы можете получить подробную информацию о своих сообщениях через конечные точки с 'Информацией о сообщении'.
  • Теперь вы можете стать партнером с нашим API и управлять своими телефонами без каких-либо первоначальных платежей. Для получения подробной информации вы можете посетить страницу Партнер WhatsApp API