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

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

Обновлено: 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, независимо от конфигурации локального хранилища. Подробнее см. «Хранение номеров телефонов через запросы контактной информации»

Включение локального хранилища

Выполните следующие шаги, чтобы включить локальное хранилище для незарегистрированного корпоративного телефонного номера, используя API версии 21.0 или новее. Если вы используете более старую версию API, см. раздел « Включение локального хранилища (версия 20 и старше)» .

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

Включение или отключение локального хранилища для бизнес-номеров телефонов WhatsApp возможно только в том случае, если номер телефона в данный момент не зарегистрирован. Если номер телефона зарегистрирован, его необходимо отменить регистрацию и зарегистрировать заново с включенным локальным хранилищем.

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

Синтаксис запроса

ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /settings { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "<COUNTRY_CODE> " } }

Набор к коду страны, в которой должны храниться данные в состоянии покоя.

Синтаксис ответа

{ "успех":<SUCCESS> }

В случае успеха, будет установлено значение true .

Пример запроса

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 / /register для регистрации номера телефона компании.

Синтаксис запроса

ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /register { "messaging_product": "whatsapp", "pin": "<TWO_STEP_PIN> " }

Набор вводить желаемый PIN-код для двухфакторной аутентификации номера телефона компании.

Синтаксис ответа

{ "успех":<SUCCESS> }

В случае успеха, будет установлено значение true .

Пример запроса

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 / /settings для получения настроек локального хранилища для бизнес-номера телефона WhatsApp. Например:

curl 'https://graph.facebook.com/v25.0/179776755229976/settings' \ -H 'Авторизация: Bearer EAAJB...'

Эта функция возвращает узел, представляющий локальные настройки хранилища для корпоративного телефонного номера. Например:

{ "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "BR" } }

Отключение локального хранилища

Используйте POST / /settings позволяет отключить локальное хранилище для незарегистрированного корпоративного номера телефона с использованием API версии 21.0 или новее. Если вы используете более старую версию API, см. раздел «Отключение локального хранилища (версия 20 и старше)» .

Синтаксис запроса

ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID/> настройки { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_DISABLED" } }

Набор к коду страны, в которой должны храниться данные в состоянии покоя.

Синтаксис ответа

{ "успех":<SUCCESS> }

В случае успеха, будет установлено значение true .

Пример запроса

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 / Задайте конечную точку и запросите code_verification_status . Если статус проверки кода VERIFIED , перейдите к шагу 4. В противном случае перейдите к шагу 2.

Шаг 2: Запросите код подтверждения

Используйте POST / /request_code для запроса кода подтверждения. В случае успеха API ответит значением true , и код подтверждения будет отправлен на номер телефона компании способом, указанным в code_method .

Например, этот запрос запрашивает отправку кода подтверждения по SMS на английском языке (в соответствии с локалью США).

curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/request_code?code_method=SMS&language=en_US' \ -H 'Авторизация: Bearer EAAJB...'

Используйте код из полученного сообщения на следующем шаге.

Шаг 3: Проверьте номер телефона компании

Используйте POST / /verify_code используется для проверки номера телефона компании с помощью кода подтверждения, содержащегося в сообщении, полученном на предыдущем шаге.

Например:

curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/verify_code?code=123830' \ -H 'Авторизация: Bearer EAAJB...'

Шаг 4: Перерегистрируйте номер телефона компании

Используйте POST / /register для регистрации номера телефона компании. Укажите страну, в которой должны храниться данные в состоянии покоя, используя 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 или более ранней.

Например:

curl -X POST 'https://graph.facebook.com/v25.0/110200345501442/deregister' \ -H 'Авторизация: Bearer EAAJB...'

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

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

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

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

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

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

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

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

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

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