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

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

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

Обновлено: 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 за пределами указанного локального региона хранения и сохраняется только в центрах обработки данных в пределах выбранного локального региона хранения.
      The local storage feature supplements other WhatsApp Business Platform privacy and security controls⁠?, and allows customers to ensure a higher level of compliance with local data protection regulations.

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

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

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

        If your business has enabled the contact book feature and a WhatsApp user shares their contact information by tapping the share contact information button, Meta extracts the пользователь'пользователь's phone number from the shared contact card (vCard) and stores it in your contact book. The contact book is hosted on Meta data centers, regardless of your Local Storage configuration. Only the phone number is extracted and stored; no other vCard data is retained on Meta data centers beyond the standard data-in-use period. Contact book retention policies apply to this data and you can turn off this feature.

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

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

        Ограничения

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

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

          Follow the steps below to enable local storage for an unregistered business phone number using API version 21.0 or newer. If you are using an older API version, see Enabling Local Storage (v20 and older).

          Шаг 1: Включите локальное хранилище на номере

          Включение или отключение локального хранилища для бизнес-номеров телефонов WhatsApp возможно только в том случае, если номер телефона в данный момент не зарегистрирован. Если номер телефона зарегистрирован, его необходимо отменить регистрацию и зарегистрировать заново с включенным локальным хранилищем.
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings endpoint to enable local storage on the unregistered business phone number:
          Синтаксис запроса
          ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /settings { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "<COUNTRY_CODE> " } }
          Набор <COUNTRY_CODE> к country code of the country where data-at-rest should be stored.
          Синтаксис ответа
          { "успех":<SUCCESS> }
          Upon success, <SUCCESS> будет установлено на истинный.
          Пример запроса
          curl 'https://graph.facebook.com/v25.0/106540352242922/settings' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "BR" } }'

          Пример ответа
          { "success": true }
          Шаг 2: Зарегистрируйте номер
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register endpoint to register the business phone number.
          Синтаксис запроса
          ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /register { "messaging_product": "whatsapp", "pin": "<TWO_STEP_PIN> " }

          Набор <TWO_STEP_PIN> to the desired two-step verification PIN for the business phone number.
          Синтаксис ответа
          { "успех":<SUCCESS> }
          Upon success, <SUCCESS> будет установлено на истинный.
          Пример запроса
          curl 'https://graph.facebook.com/v21.0/v25.0/register' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "pin": "123456" }'

          Пример ответа
          { "success": true }
          Получение настроек локального хранилища
          Используйте GET /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings endpoint to get local storage settings on a WhatsApp Business Phone Number. For example:
          curl 'https://graph.facebook.com/v25.0/179776755229976/settings' \ -H 'Авторизация: Bearer EAAJB...'

          This returns a node that represents the local storage settings on the business phone number. For example:
          { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "BR" } }
          Отключение локального хранилища
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/settings endpoint to disable local storage on an unregistered business phone number using API version 21.0 or newer. If you are using an older API version, see Disabling Local Storage (v20 and older).
          Синтаксис запроса
          ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID/> настройки { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_DISABLED" } }

          Набор <COUNTRY_CODE> к country code of the country where data-at-rest should be stored.
          Синтаксис ответа
          { "успех":<SUCCESS> }
          Upon success, <SUCCESS> будет установлено на истинный.
          Пример запроса
          curl 'https://graph.facebook.com/v25.0/106540352242922/settings' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_DISABLED" } }'

          Пример ответа
          { "success": true }
          Включение локального хранилища в версиях 20 и более ранних
          Чтобы включить локальное хранилище для незарегистрированного корпоративного телефонного номера с использованием API версии 20.0 или более ранней:
          Шаг 1: Проверьте статус подтверждения
          Используйте GET /<WHATSAPP_BUSINESS_PHONE_NUMBER> конечную точку и запросить code_verification_status field. If the code verification status is VERIFIED, skip to step 4. Otherwise, proceed to step 2.
          Шаг 2: Запросите код подтверждения
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/request_code endpoint to request a verification code. Upon success, the API will respond with истинный and a verification code will be sent to the business phone number via the method specified in the код_метод параметр.
          Например, этот запрос запрашивает отправку кода подтверждения по SMS на английском языке (в соответствии с локалью США).
          curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/request_code?code_method=SMS&language=en_US' \ -H 'Авторизация: Bearer EAAJB...'
          Используйте код из полученного сообщения на следующем шаге.
          Шаг 3: Проверьте номер телефона компании
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/verify_code endpoint to verify the business phone number using the verification code included in the message you received from the previous step.
          Например:
          curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/verify_code?code=123830' \ -H 'Авторизация: Bearer EAAJB...'
          Шаг 4: Перерегистрируйте номер телефона компании
          Используйте POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/register endpoint to register the business phone number. Indicate the country where data-at-rest should be stored using the data_localization_region параметр.
          Например, этот запрос включает локальное хранение данных на рабочем телефонном номере и указывает страну, в которой должны храниться данные, — Индию:
          curl 'https://graph.facebook.com/v20.0/110200345501442/register' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "pin": "123456", "data_localization_region": "IN" }'
          Отключение локального хранилища в версиях 20 и более ранних
          

          Используйте POST /  /deregister для отключения локального хранилища для корпоративного телефонного номера с использованием API версии 20.0 или более ранней.
          

          Например:
          

          локон
          
-X POST 'https://graph.facebook.com/v25.0/110200345501442/deregister' \ -H 'Authorization: Bearer EAAJB...'

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

          

          

          

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

          В: Каковы пути миграции для переноса телефонного номера в облачную версию API с локальным хранилищем?
          

          Мы поддерживаем все варианты миграции на облачную версию API с локальным хранилищем, включая:
          

            Существующий номер Cloud API переводится на версию Cloud API с локальным хранилищемНовый номер облачного API, позволяющий использовать локальное хранилище

            Во всех этих сценариях вам потребуется отправить POST-запрос на  /register для выбранного номера телефона, указав целевую страну, для которой необходимо локализовать данные, в новом параметре data_localization_region .
            

            В: Существуют ли какие-либо риски, связанные с миграцией? Возможны ли простои в работе системы?
            

            Отсутствие рисков миграции. Время простоя обычно составляет менее 5 минут, и повторная проверка номера телефона компании не требуется.
            

            В: Возникают ли какие-либо простои в работе при включении локального хранилища для корпоративного телефонного номера?
            

            Если корпоративный номер телефона уже зарегистрирован, вам потребуется отменить его регистрацию и зарегистрировать заново, включив локальное хранилище. Этот процесс обычно занимает менее 5 минут. Повторная проверка корпоративного номера телефона в ходе этого процесса не требуется.
            
    
                    
            
    
            

            
            
        
            
    
            

    
            

    
    
            
        
            
             Вернуться наверх