Локальное хранилище | Документация для разработчиков
Локальное хранилище
Обновлено: 31 марта 2026 г
Локальное хранилище обеспечивает дополнительный уровень контроля над управлением данными, предоставляя возможность указать, где именно будут храниться данные ваших сообщений в состоянии покоя. Если ваша компания работает в регулируемой отрасли, такой как финансы, государственное управление или здравоохранение, вы можете предпочесть хранение данных ваших сообщений в определенной стране в состоянии покоя из-за нормативных требований или политики компании.
Как работает локальное хранилище
Управление локальным хранилищем осуществляется с помощью параметра, включенного или выключенного на уровне бизнес-номера телефона WhatsApp. Локальное хранилище поддерживают как Cloud API, так и Marketing Messages API для WhatsApp, и этот параметр будет применяться ко всем сообщениям, отправленным через любой из этих API, если он включен.
При включении локального хранилища к содержимому сообщений для корпоративного телефонного номера применяются следующие ограничения:
Функция локального хранилища дополняет другие возможности Настройки конфиденциальности и безопасности платформы WhatsApp Business?и позволяет клиентам обеспечить более высокий уровень соответствия местным правилам защиты данных.
Данные в рамках исследования
Локальное хранилище применяется к содержимому сообщений (тексту и медиафайлам), отправленных и/или полученных через Cloud API и Marketing Messages API для WhatsApp. Функция локального хранилища распространяется на следующее содержимое сообщений:
Кроме того, к локально сохраненному содержимому сообщения прилагается ограниченный набор атрибутов метаданных, чтобы корректно связать зашифрованную полезную нагрузку сообщения с исходным обработанным сообщением и проверить факт локализации. Сохраненные метаданные защищены токенизацией и шифрованием.
Сохранение телефонных номеров посредством запросов контактной информации
Если в вашей компании включена функция контактной книги и пользователь WhatsApp делится своей контактной информацией, нажав кнопку «Поделиться контактной информацией», Meta извлекает эти данные пользователь'пользователь'Телефонный номер пользователя извлекается из общей контактной карточки (vCard) и сохраняется в вашей контактной книге. Контактная книга размещается в центрах обработки данных Meta, независимо от вашей конфигурации локального хранилища. Извлекается и сохраняется только телефонный номер; никакие другие данные vCard не сохраняются в центрах обработки данных Meta после стандартного периода использования данных. политика хранения контактной книги примените эти данные, и вы сможете отключить эту функцию.
Доступные регионы
Чтобы узнать, какие регионы поддерживаются локальным хранилищем, см.
data_localization_region в документации по регистрации телефонных номеров.Ограничения
Включение
Локальное хранилище
Шаг 1: Включите локальное хранилище на номере
Синтаксис запроса
ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /settings { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "<COUNTRY_CODE> " } }
Синтаксис ответа
{ "успех":<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: Зарегистрируйте номер
Синтаксис запроса
ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /register { "messaging_product": "whatsapp", "pin": "<TWO_STEP_PIN> " }
<TWO_STEP_PIN>Синтаксис ответа
{ "успех":<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 }
Получение настроек локального хранилища
curl 'https://graph.facebook.com/v25.0/179776755229976/settings' \ -H 'Авторизация: Bearer EAAJB...'
{ "storage_configuration": { "status": "IN_COUNTRY_STORAGE_ENABLED", "data_localization_region": "BR" } }
Отключение локального хранилища
Синтаксис запроса
ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID/> настройки { "storage_configuration": { "status": "IN_COUNTRY_STORAGE_DISABLED" } }
Синтаксис ответа
{ "успех":<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 и более ранних
Шаг 1: Проверьте статус подтверждения
статус_проверки_кодаПРОВЕРЕНОШаг 2: Запросите код подтверждения
истинныйкод_методcurl -X POST 'https://graph.facebook.com/v20.0/110200345501442/request_code?code_method=SMS&language=en_US' \ -H 'Авторизация: Bearer EAAJB...'
Шаг 3: Проверьте номер телефона компании
curl -X POST 'https://graph.facebook.com/v20.0/110200345501442/verify_code?code=123830' \ -H 'Авторизация: Bearer EAAJB...'
Шаг 4: Перерегистрируйте номер телефона компании
data_localization_regioncurl '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 / Конечная точка для отключения локального хранилища для корпоративного телефонного номера с использованием API версии 20.0 или более ранней.
Например:
локонОбратите внимание, что это аннулирует регистрацию корпоративного номера телефона, поэтому его нельзя будет использовать с WhatsApp Cloud API. Если вы хотите продолжить использовать его с Cloud API, но без включенного локального хранилища, вам необходимо повторно зарегистрировать его, не указывая
data_localization_region .Часто задаваемые вопросы
В: Каковы пути миграции для переноса телефонного номера в облачную версию API с локальным хранилищем?
Мы поддерживаем все варианты миграции на облачную версию API с локальным хранилищем, включая:
Во всех этих сценариях вам потребуется отправить POST-запрос на /register для выбранного номера телефона, указав целевую страну, для которой необходимо локализовать данные, в новом параметре
data_localization_region.В: Существуют ли какие-либо риски, связанные с миграцией? Возможны ли простои в работе системы?
Отсутствие рисков миграции. Время простоя обычно составляет менее 5 минут, и повторная проверка номера телефона компании не требуется.
В: Возникают ли какие-либо простои в работе при включении локального хранилища для корпоративного телефонного номера?
Если корпоративный номер телефона уже зарегистрирован, вам потребуется отменить его регистрацию и зарегистрировать заново, включив локальное хранилище. Этот процесс обычно занимает менее 5 минут. Повторная проверка корпоративного номера телефона в ходе этого процесса не требуется.