Ошибка WhatsApp Flows 139000: Заблокировано из-за целостности

Разрешите ошибку API WhatsApp Flows 139000 'Заблокировано из-за целостности' с помощью нашего подробного руководства. Узнайте о ограничениях тестовых аккаунтов, требованиях к верификации и пошаговых решениях для успешной реализации Flow.

Авторы: НейроАгент

20.11.2025, 09:51

Ошибка API WhatsApp Flows: Заблокировано из-за целостности (Код 139000)

Описание проблемы

Я разрабатываю приложение Meta с использованием WhatsApp Cloud API для отправки сообщений клиентам. Хотя базовая отправка сообщений работает идеально, я сталкиваюсь с ошибкой при попытке отправки WhatsApp Flows через API.

Детали ошибки

При попытке отправки Flow через API я получаю следующую ошибку:

json

{
    "error": {
        "message": "(#139000) Blocked by Integrity",
        "type": "OAuthException",
        "code": 139000,
        "error_data": {
            "messaging_product": "whatsapp",
            "details": "Integrity requirements not met."
        },
        "fbtrace_id": "Ax6tYhZjqbj5Dsjkv3EaEhD"
    }
}

Исследование и предпринятые решения

Верификация бизнес-портфолио: Мое бизнес-портфолио верифицировано, что должно соответствовать одному из основных требований для отправки Flow.
Качество сообщений: Мой тестовый номер телефона имеет высокий рейтинг качества, что не должно вызывать эту проблему.
Прямое тестирование в Flow Builder: Я также попробовал отправить Flow напрямую через Flow Builder, что завершилось неудачей без предоставления подробной информации об ошибке.
Статус верификации аккаунта: Похоже, есть несоответствие в моем аккаунте:
- WhatsApp Manager показывает мой бизнес как верифицированный
- Некоторые части интерфейса все еще отображают “верификация в процессе”
- При нажатии “Опубликовать” в Flow Builder появляется сообщение “Верификация бизнеса находится в процессе”
- При нажатии “Просмотреть детали” отображается “Поздравляем, ваш бизнес был верифицирован Meta”
Отображаемое имя номера телефона: Поскольку это тестовый номер телефона, его профиль нельзя отредактировать или верифицировать, что может быть фактором.

Основной вопрос

Ограничена ли отправка WhatsApp Flows для тестовых аккаунтов WABA или тестовых номеров телефонов? Если да, то каковы конкретные требования для успешного тестирования или отправки Flow?

Дополнительный контекст

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

Ошибка API WhatsApp Flows 139000 “Заблокировано из-за нарушений целостности” возникает, когда ваш аккаунт не соответствует требованиям целостности WhatsApp, которые включают верификацию бизнеса, утверждение отображаемого имени и стандарты качества рейтинга. Эта ошибка обычно затрагивает тестовые аккаунты и unverifицированные телефонные номера, поскольку WhatsApp ограничивает функциональность Flows для обеспечения соответствия их политикам бизнес-сообщений и поддержания целостности платформы.

Содержание

Понимание ошибки целостности 139000
Распространенные причины ошибки
Требования для использования WhatsApp Flows
Ограничения тестовых аккаунтов и решения
Пошаговое руководство по устранению неполадок
Лучшие практики для тестирования WhatsApp Flows

Понимание ошибки целостности 139000

Код ошибки 139000 “Заблокировано из-за нарушений целостности” — это мера безопасности, реализованная WhatsApp для обеспечения того, чтобы только соответствующие требованиям бизнес-аккаунты могли использовать Flows. Согласно официальной документации Meta, эта ошибка возникает, когда ваш аккаунт нарушает условия обслуживания WhatsApp, что приводит к временным ограничениям на действия, связанные с Flows.

Сообщение об ошибке конкретно указывает, что “Требования целостности не выполнены”, что означает, что ваш аккаунт не удовлетворил один или несколько обязательных критериев WhatsApp для функциональности Flows. Это особенно характерно для тестовых аккаунтов и сред разработки, где полная верификация бизнеса не была завершена.

Важно: Как объясняется в документации Rapidbott Help Docs, эта ошибка часто возникает при интеграции систем стороннего хранения без надлежащих разрешений, что приводит к сбоям доставки и запускает проверки целостности.

Распространенные причины ошибки

На основе результатов исследования, несколько факторов могут вызвать ошибку целостности:

Неполная верификация бизнеса: Ваш бизнес-портфель может отображаться как верифицированный в некоторых областях, но все еще показывать “верификация в процессе” в других, создавая противоречивый статус, который блокирует функциональность Flows.
Неверифицированное отображаемое имя: Телефонные номера тестовых аккаунтов обычно не могут иметь отредактированные или верифицированные отображаемые имена, что является требованием для отправки Flows через API.
Проблемы с качеством рейтинга: Хотя ваш тестовый номер может иметь хороший рейтинг качества, временные снижения или недавние изменения могут запустить проверки целостности.
Проблемы с разрешениями сторонних сервисов: При использовании облачных сервисов хранения, таких как Cloudinary или S3, для файлов в ваших Flows, отсутствующие разрешения могут вызвать сбои доставки, которые запускают ошибку целостности.
Нарушения политики: Предыдущая активность в отправке сообщений, которая могла нарушить политику бизнес-сообщений WhatsApp, может привести к временным ограничениям на расширенные функции, такие как Flows.

Требования для использования WhatsApp Flows

Для успешного использования WhatsApp Flows бизнесы должны соответствовать нескольким строгим требованиям:

Верифицированный бизнес-аккаунт: Как указано в полном руководстве Sanoflow, бизнесам нужен активный, верифицированный аккаунт на платформе WhatsApp Business API.
Статус известного бизнеса: Согласно документации Meta, бизнес должен представлять собой “известный, широко известный и часто запрашиваемый бизнес, бренд или сущность.”
Утвержденное отображаемое имя: Отображаемое имя телефонного номера должно быть утверждено WhatsApp, что часто представляет сложность для тестовых номеров.
Высокий рейтинг качества: Бизнес-аккаунт должен поддерживать высокий рейтинг качества сообщений для доступа к расширенным функциям.
Верификация бизнеса: Полная верификация через процесс Business Verification, а не только верификация портфеля.

Ограничения тестовых аккаунтов и решения

Да, отправка WhatsApp Flows действительно ограничена для тестовых аккаунтов WABA и тестовых телефонных номеров. Исследования подтверждают, что тестовые аккаунты имеют ограничения, которые предотвращают полную функциональность Flows:

Ограничения тестовых аккаунтов:

Телефонные номера тестовых аккаунтов не могут иметь верифицированные или отредактированные отображаемые имена
Тестовые аккаунты могут не соответствовать требованию “известного бизнеса”
Некоторые тестовые среды запускают дополнительные проверки безопасности
Публикация Flows может быть заблокирована на этапах разработки

Решения для тестирования:

Используйте ограниченный тестовый Flow: Как упоминается в обсуждении на Stack Overflow, вы можете создавать черновики Flows, которые позволяют ограниченное тестирование с небольшим количеством клиентов.
Запросите доступ разработчика: Некоторые разработчики обнаружили, что запрос специального доступа разработчика может временно снять ограничения для целей тестирования.
Используйте реальный бизнес-номер: Рассмотрите возможность использования реального бизнес-номера с надлежащей верификацией для тестирования, даже если это не ваш финальный производственный номер.
Свяжитесь с поддержкой Meta: Обратитесь в поддержку WhatsApp Business с запросом на временный доступ для разработки и тестирования.

Пошаговое руководство по устранению неполадок

Следуйте этим шагам для решения ошибки целостности:

Проверьте полный статус бизнеса:
- Проверьте все области WhatsApp Manager на предмет согласованности статуса верификации
- Убедитесь, что и верификация портфеля, и верификация бизнеса завершены
- Проверьте наличие любых ожидающих шагов верификации
Устраните проблемы с отображаемым именем:
- Для тестовых номеров рассмотрите возможность использования производственного номера с верифицированным отображаемым именем
- Убедитесь, что отображаемое имя точно соответствует названию вашего бизнеса
- Выделите 24-48 часов на утверждение отображаемого имени после отправки
Проверьте рейтинг качества:
- Просмотрите метрики качества вашего аккаунта в WhatsApp Manager
- Устраните любые недавние проблемы с доставкой сообщений
- Обеспечьте правильное управление согласием (opt-in) для ваших контактов
Проверьте разрешения сторонних сервисов:
- Проверьте все разрешения на хранение файлов для активов, используемых в ваших Flows
- Убедитесь в правильности настроек CORS для доступа к файлам
- Протестируйте доступность файлов непосредственно в браузере
Очистите кэш и сбросьте настройки:
- Очистите кэш и файлы cookie вашего браузера
- При необходимости сбросьте токены API
- Повторно аутентифицируйте подключения вашего приложения

Лучшие практики для тестирования WhatsApp Flows

Настройка среды разработки:

Создайте отдельный WABA для разработки и тестирования
Используйте ограниченный набор тестовых контактов (5-10 пользователей)
Реализуйте правильную обработку ошибок в вашем приложении

Стратегия тестирования:

Сначала тестируйте Flows в режиме черновика
Используйте Flow Builder для начальной разработки
Постепенно переходите к интеграции с API, как только базовая функциональность будет работать

Управление аккаунтами:

Поддерживайте раздельные производственные и аккаунты разработки
Ведите подробные записи о статусе верификации
Мониторьте метрики качества на протяжении всего процесса разработки

Альтернативные подходы к тестированию:

Используйте песочницы (sandbox), когда они доступны
Рассмотрите платформы-партнеры, которые предоставляют инфраструктуру для тестирования
Воспользуйтесь инструментами сторонних разработчиков, предназначенными для разработки WhatsApp Flows

Заключение

Ошибка API WhatsApp Flows 139000 “Заблокировано из-за нарушений целостности” в основном вызвана ограничениями тестовых аккаунтов и неполными требованиями верификации бизнеса. Тестовые аккаунты WABA и телефонные номера сталкиваются с ограничениями из-за проблем с верификацией отображаемого имени и невозможности соответствовать критериям “известного бизнеса”. Для успешного тестирования WhatsApp Flows рассмотрите использование верифицированного производственного номера для разработки, поддержание полной верификации бизнеса на всех платформах и реализацию правильных разрешений для сторонних сервисов для активов Flows. Для продолжения разработки запросите специальный доступ разработчика или используйте ограниченные режимы тестирования, доступные через Flow Builder. Помните, что требования целостности WhatsApp предназначены для поддержания качества платформы, и надлежащее соответствие в конечном итоге принесет пользу возможностям вашего бизнеса в области обмена сообщениями.

Источники

Авторы

НейроАгент

Автор

Проверено модерацией

НейроОтветы

Модерация