Начните работу в качестве партнера по решениям | Документация для разработчиков
Начните работу в качестве партнера по решениям
Обновлено: 12 декабря 2025 г
В этом руководстве описаны шаги, которые партнеры по решениям , чтобы предложить облачный API своим клиентам. Существует 4 основных этапа:
После завершения, пожалуйста, продолжайте получать ежемесячные обновления .
Подготовка и планирование
Ознакомьтесь с документацией
Прежде чем начать, рекомендуем ознакомиться с нашей документацией для разработчиков и нашей коллекцией Postman . Это поможет вам понять, как работает Cloud API, включая способы начала работы и миграции данных.
Планирование внедрения и миграции
Мы рекомендуем использовать встроенную регистрацию для подключения новых бизнес-клиентов к Cloud API. Если вы еще этого не сделали, внедрите встроенную регистрацию . Встроенная регистрация — это самый быстрый и простой способ регистрации бизнес-клиентов, позволяющий им начать отправлять сообщения менее чем за пять минут.
Настройка активов
Для использования облачного API партнерам по решениям необходимы следующие ресурсы:
| Объект | Конкретные инструкции |
|---|---|
|
Бизнес-портфолио |
Вы можете использовать существующий идентификатор или создать новый ? Сохраните идентификатор бизнес-портфеля. |
|
Бизнес-аккаунт WhatsApp (WABA) |
См. раздел «Как создать бизнес-аккаунт WhatsApp для использования WhatsApp Business API ?» для получения справки. |
|
Если у вас нет приложения, вам необходимо создать его, выбрав «Бизнес» . Не забудьте добавить в приложение отображаемое имя и контактный адрес электронной почты.
В качестве партнера по решениям ваше приложение должно пройти проверку и запросить расширенный доступ к следующим разрешениям:
whatsapp_business_management — Используется для управления номерами телефонов, шаблонами сообщений, регистрацией и бизнес-профилем в рамках бизнес-аккаунта WhatsApp. Для получения этого разрешения ваше приложение должно пройти проверку .whatsapp_business_messaging — Используется для отправки/получения сообщений от пользователей WhatsApp, загрузки/скачивания медиафайлов через бизнес-аккаунт WhatsApp. Для получения этого разрешения ваше приложение должно пройти проверку .whatsapp_business_manage_events — Используется для регистрации событий, таких как покупки, добавление товаров в корзину, лиды и многое другое, в рамках бизнес-аккаунта WhatsApp. Запрашивайте это разрешение только в том случае, если вы используете API маркетинговых сообщений для WhatsApp с API конверсий . Для получения этого разрешения ваше приложение должно пройти проверку .
Как партнер по решениям, вы также можете свободно использовать одно и то же приложение Meta для разных клиентов и WABA. Однако имейте в виду, что каждое приложение может иметь только одну конечную точку веб-перехватчика, и каждое приложение должно пройти проверку на соответствие требованиям. | |
|
Системный пользователь |
См. раздел «Добавление пользователей системы в портфель вашего бизнеса ?» для получения справки.
В настоящее время приложение Meta с
whatsapp_business_messaging , whatsapp_business_management , whatsapp_business_manage_events и business_messaging имеет доступ к следующему объему данных:Для развертывания в производственной среде мы рекомендуем использовать системного пользователя-администратора. Дополнительную информацию разделе «О доступе к бизнес-портфолио ». |
|
Рабочий номер телефона |
Это номер телефона, который компания будет использовать для отправки сообщений. Номера телефонов необходимо подтвердить с помощью SMS/голосового звонка.
Для партнеров по решениям и прямых разработчиков: Если вы хотите использовать свой собственный номер, вам следует добавить номер телефона в WhatsApp Manager и подтвердить его с помощью конечной точки проверки через Graph API .
встроенную процедуру регистрации партнера по решениям .
Количество корпоративных телефонных номеров, которые можно подключить к облачному API, не ограничено. |
|
Номер телефона потребителя |
Это номер телефона, на который в данный момент распространяется потребительская версия WhatsApp. На этот номер будут приходить сообщения, отправленные с вашего рабочего номера телефона. |
Подписать контракты
Принятие условий предоставления услуг
Для доступа к API WhatsApp Business Messaging Cloud вам необходимо сначала принять Условия использования платформы WhatsApp Business от имени вашей компании.
Для этого перейдите в WhatsApp Manager и примите Условия использования в информационном баннере.
Для всех новых пользователей Cloud API необходимо принять Условия предоставления услуг, прежде чем начать его использовать. Заявки на регистрацию будут завершаться неудачей, пока вы не примете Условия предоставления услуг.
Вы, как разработчик, должны принять Условия предоставления услуг. Если вы являетесь Партнером по решениям, то ваши клиенты не обязаны их принимать.
Создание интеграции
Шаг 1: Получите токен доступа системного пользователя
Для аутентификации при вызовах Graph API используются токены доступа. Дополнительную информацию см. в разделе « Токены доступа» . Рекомендуем использовать системного пользователя для генерации токена.
Для генерации токена доступа системного пользователя:
Перейдите в раздел «Портфолио бизнеса » > «Настройки бизнеса» > «Пользователи» > «Системные пользователи» , чтобы просмотреть созданного вами системного пользователя.
Щелкните по этому пользователю и выберите «Добавить ресурсы» . Это действие откроет новое окно.
В левой боковой панели в разделе «Выбор типа ресурса» «Приложения» . В разделе «Выбор ресурсов» выберите приложение Meta, которое вы хотите использовать (ваше приложение должно иметь необходимые разрешения). Включите режим «Разработка приложения» для этого приложения.
Выберите «Сохранить изменения» , чтобы сохранить настройки и вернуться на главный экран пользователя системы.
Теперь вы готовы сгенерировать свой токен. На главном экране пользователя системы нажмите «Сгенерировать токен» и выберите ваше приложение Meta.
После выбора приложения вы увидите список доступных разрешений. Выберите
whatsapp_business_management , whatsapp_business_messaging и whatsapp_business_manage_events . Нажмите «Сгенерировать токен» .Откроется новое окно с именем пользователя вашей системы, назначенным приложением и токеном доступа. Сохраните свой токен.
При желании вы можете щелкнуть по своему токену и открыть отладчик токенов. В отладчике вы увидите выбранные вами разрешения. Вы также можете напрямую вставить свой токен в отладчик токенов доступа .
Шаг 2: Настройка веб-хуков
Настроив веб-хуки, вы сможете получать HTTP-уведомления в режиме реального времени от платформы WhatsApp Business. Это означает, что вы будете получать уведомления, например, когда получите сообщение от клиента или когда произойдут изменения в вашем аккаунте WhatsApp Business (WABA).
Для настройки конечной точки веб-перехватчика необходимо создать доступный из интернета веб-сервер с URL-адресом, соответствующим требованиям Meta и WhatsApp. Более подробную информацию см. в нашем по веб-перехватчикам . Если вам нужна конечная точка для тестирования, вы можете развернуть тестовое приложение, которое просто выводит данные веб-перехватчика в вашу консоль.
настройка приложения
Как только конечная точка будет готова, настройте её для использования вашим приложением Meta:
В панели управления приложения перейдите в WhatsApp > Настройки , затем нажмите «Редактировать» .
После добавления информации нажмите «Проверить и сохранить» .
После сохранения вернитесь в «Конфигурация» , нажмите «Управление» и подпишитесь на отдельные поля веб-перехватчика. Чтобы получать уведомления о сообщениях клиентов, обязательно подпишитесь на Сообщения» .
Для каждого приложения веб-хуки нужно настроить всего один раз. Вы можете использовать один и тот же веб-хук для получения событий нескольких типов из нескольких учетных записей WhatsApp Business или настроить переопределение. Для получения дополнительной информации см. раздел «Веб-хуки».
Шаг 3: Подпишитесь на WABA
Чтобы получать уведомления для нужного аккаунта, подпишите приложение:
Если вы получите ответ, указанный ниже, все события Webhook для телефонных номеров, относящихся к этой учетной записи, будут отправлены на настроенную вами конечную точку Webhooks.
{ "success": true }Шаг 6: Получение сообщения от пользовательского приложения
После того, как участвующие клиенты отправят сообщение вашей компании, вы получите 24 часа бесплатного общения с ними — этот период времени называется окном обслуживания клиентов. В целях тестирования мы хотим включить это окно, чтобы вы могли отправлять столько сообщений, сколько захотите.
Отправьте сообщение на только что зарегистрированный номер телефона через персональное приложение WhatsApp для iOS/Android. После отправки сообщения вы должны получить входящее сообщение на свой вебхук с уведомлением в следующем формате.
Следите за ежемесячными обновлениями
Мы будем выпускать обновления Cloud API в первый вторник каждого месяца. Они будут включать новые функции и улучшения. Вам не нужно ничего делать, чтобы использовать новые функции, поскольку Cloud API обновляется автоматически.
Часто задаваемые вопросы
Часто задаваемые вопросы общего характера
Какая компания будет предоставлять облачный API?
WhatsApp разрабатывает и управляет WhatsApp Business API, который позволяет компаниям общаться с пользователями WhatsApp в сети WhatsApp. При использовании облачного API компания Meta разместит WhatsApp Business API для вас и предоставит конечную точку для сервиса WhatsApp для входящих и исходящих сообщений WhatsApp.
Взимается ли какая-либо дополнительная плата за использование Cloud API?
Доступ к Cloud API предоставляется бесплатно, и мы ожидаем, что это позволит разработчикам дополнительно сэкономить средства, поскольку Meta размещает и поддерживает Cloud API.
Часто задаваемые вопросы по технической реализации
Какова архитектура облачного API?
Архитектура Cloud API значительно упрощает операционные и инфраструктурные требования партнера по решениям для интеграции с платформой WhatsApp Business. Во-первых, она устраняет необходимость в инфраструктуре для запуска контейнеров Docker для Business API (экономия капитальных затрат). Во-вторых, она избавляет от необходимости нести операционные обязанности по управлению развертыванием (экономия операционных затрат). 
Как будет выглядеть восстановление после катастрофы: если регион недоступен, сколько времени потребуется для переноса сообщений в другой регион?
Мы обеспечим аварийное восстановление и репликацию данных в нескольких регионах. Ожидаемое время простоя будет соответствовать нашему соглашению об уровне обслуживания (SLA) и, как правило, составит от менее одной до менее пяти минут.
Часто задаваемые вопросы о конфиденциальности и безопасности данных
Где расположены серверы для Cloud API?
Облачный API обрабатывает сообщения на серверах в центрах обработки данных Meta . Если компания выбирает использование локального хранилища Cloud API, данные сообщений хранятся в центрах обработки данных, расположенных в другой указанной стране .
Используется ли сквозное шифрование в облачном API? Какова модель шифрования?
Что происходит с данными сообщения в состоянии покоя? Как долго они хранятся?
Сообщения Cloud API в состоянии покоя шифруются. Максимальный срок хранения сообщений составляет 30 дней, что необходимо для обеспечения базовых функций и возможностей сервиса Cloud API, например, для повторной передачи.
Есть ли у Meta доступ к ключам шифрования?
Для отправки и получения сообщений через Cloud API, Cloud API управляет ключами шифрования/дешифрования от имени компании. Более подробную информацию можно найти в техническом документе «Обзор шифрования WhatsApp » .
Часто задаваемые вопросы о соблюдении нормативных требований
Как Cloud API соответствует региональным законам о защите данных (таким как GDPR, LGPD и PDPB)?
Компания Meta очень серьезно относится к защите данных и конфиденциальности пользователей и соблюдает применимые правовые, отраслевые и нормативные требования, регулирующие защиту данных, а также передовые отраслевые практики. Клиенты Cloud API должны выполнять свои собственные обязательства в соответствии с законами о защите данных, такими как Общий регламент по защите данных (GDPR). Пожалуйста, посетите наш Центр соответствия требованиям Meta Business Messaging , чтобы узнать больше.
Комментарии отсутствуют
Комментарии отсутствуют