Перейти к основному содержимому

Локальное хранилище | Документация для разработчиков

Локальное хранилище

Обновлено: 31 марта 2026 г
Локальное хранилище обеспечивает дополнительный уровень контроля над управлением данными, предоставляя возможность указать, где именно будут храниться данные ваших сообщений в состоянии покоя. Если ваша компания работает в регулируемой отрасли, такой как финансы, государственное управление или здравоохранение, вы можете предпочесть хранение данных ваших сообщений в определенной стране в состоянии покоя из-за нормативных требований или политики компании.

Как работает локальное хранилище

Управление локальным хранилищем осуществляется с помощью параметра, включенного или выключенного на уровне бизнес-номера телефона WhatsApp. Локальное хранилище поддерживают как Cloud API, так и Marketing Messages API для WhatsApp, и этот параметр будет применяться ко всем сообщениям, отправленным через любой из этих API, если он включен.
При включении локального хранилища к содержимому сообщений для корпоративного телефонного номера применяются следующие ограничения:
    Период использования данных: Когда содержимое сообщения отправляется или принимается через Cloud API или Marketing Messages API для WhatsApp, оно может храниться в международных центрах обработки данных Meta во время обработки. Период использования данных различается для Cloud API и Marketing Messages API для WhatsApp:
      При использовании локального хранилища для облачного API период использования данных составляет до 60 минут.При использовании API локального хранилища для маркетинговых сообщений в WhatsApp период использования данных составляет до 90 минут.Данные в состоянии покоя: по истечении периода использования данных содержимое сообщения удаляется из центров обработки данных Meta за пределами указанного локального региона хранения и сохраняется только в центрах обработки данных в пределах выбранного локального региона хранения.
      Функция локального хранилища дополняет другие средства контроля конфиденциальности и безопасности платформы WhatsApp Business и позволяет клиентам обеспечить более высокий уровень соответствия местным правилам защиты данных.

      Данные в рамках исследования

      Локальное хранилище применяется к содержимому сообщений (тексту и медиафайлам), отправленных и/или полученных через Cloud API и Marketing Messages API для WhatsApp. Функция локального хранилища распространяется на следующее содержимое сообщений:
        Текстовые сообщения: текстовая полезная нагрузка (тело сообщения)Медиасообщения: медиаконтент (аудио, документ, изображение или видео)Шаблонные сообщения (статический шаблон + параметры, передаваемые во время отправки сообщения): компоненты с текстовой/медийной полезной нагрузкой
        Кроме того, к локально сохраненному содержимому сообщения прилагается ограниченный набор атрибутов метаданных, чтобы корректно связать зашифрованную полезную нагрузку сообщения с исходным обработанным сообщением и проверить факт локализации. Сохраненные метаданные защищены токенизацией и шифрованием.

        Сохранение телефонных номеров посредством запросов контактной информации

        Если в вашей компании включена функция контактной книги, и пользователь WhatsApp делится своей контактной информацией, нажав кнопку «Поделиться контактной информацией», Meta извлекает номер телефона пользователя из предоставленной контактной карточки (vCard) и сохраняет его в вашей контактной книге. Контактная книга размещается в центрах обработки данных Meta, независимо от вашей конфигурации локального хранилища. Извлекается и сохраняется только номер телефона; никакие другие данные vCard не хранятся в центрах обработки данных Meta после стандартного периода использования данных. политики хранения контактной книги , и вы можете отключить эту функцию .

        Доступные регионы

        Чтобы узнать, какие регионы поддерживаются локальным хранилищем, см. data_localization_region в документации по регистрации телефонных номеров .

        Ограничения

          Медиафайлы, загруженные с корпоративного телефонного номера с включенным локальным хранилищем, доступны только этому конкретному номеру телефона и не могут быть переданы другим телефонным номерам, связанным с компанией.Если в вашей компании включена функция контактной книги, номера телефонов, предоставленные через кнопку «Поделиться контактной информацией», извлекаются из vCard и сохраняются в вашей контактной книге в центрах обработки данных Meta, независимо от конфигурации локального хранилища. Подробнее см. «Хранение номеров телефонов через запросы контактной информации»

          Отключение локального хранилища в версиях 20 и более ранних

          Используйте POST / /deregister для отключения локального хранилища для корпоративного телефонного номера с использованием API версии 20.0 или более ранней.
          Например:
          Обратите внимание, что это аннулирует регистрацию корпоративного номера телефона, поэтому его нельзя будет использовать с WhatsApp Cloud API. Если вы хотите продолжить использовать его с Cloud API, но без включенного локального хранилища, вам необходимо повторно зарегистрировать его, не указывая data_localization_region .

          Часто задаваемые вопросы

          В: Каковы пути миграции для переноса телефонного номера в облачную версию API с локальным хранилищем?
          Мы поддерживаем все варианты миграции на облачную версию API с локальным хранилищем, включая:
            Существующий номер Cloud API переводится на версию Cloud API с локальным хранилищемНовый номер облачного API, позволяющий использовать локальное хранилище
            Во всех этих сценариях вам потребуется отправить POST-запрос на /register для выбранного номера телефона, указав целевую страну, для которой необходимо локализовать данные, в новом параметре data_localization_region .
            В: Существуют ли какие-либо риски, связанные с миграцией? Возможны ли простои в работе системы?
            Отсутствие рисков миграции. Время простоя обычно составляет менее 5 минут, и повторная проверка номера телефона компании не требуется.
            В: Возникают ли какие-либо простои в работе при включении локального хранилища для корпоративного телефонного номера?
            Если корпоративный номер телефона уже зарегистрирован, вам потребуется отменить его регистрацию и зарегистрировать заново, включив локальное хранилище. Этот процесс обычно занимает менее 5 минут. Повторная проверка корпоративного номера телефона в ходе этого процесса не требуется.