Начните работу в качестве партнера по решениям | Документация для разработчиков
Начните работу в качестве партнера по решениям
Обновлено: 12 декабря 2025 г
В этом руководстве описаны шаги, которые партнеры по решениям , чтобы предложить облачный API своим клиентам. Существует 4 основных этапа:
После ты'ты'Повторите, пожалуйста следите за ежемесячными обновлениями.
Подготовка и планирование
Ознакомьтесь с документацией
Прежде чем начать, мы рекомендуем ознакомиться с нашими рекомендациями документация для разработчиков и наши Коллекция почтальонов?Это поможет вам понять, как работает Cloud API, в том числе, как начать работу и перенести данные.
Планирование внедрения и миграции
Мы рекомендуем использовать встроенную регистрацию для подключения новых корпоративных клиентов к облачному API. Если вы убежищеубежищеуже реализовано Встроенная регистрацияВстроенная регистрация — это самый быстрый и простой способ зарегистрировать корпоративных клиентов, позволяющий им начать отправлять сообщения менее чем за пять минут.
Настройка активов
Для использования облачного API партнерам по решениям необходимы следующие ресурсы:
Бизнес-портфолио
Вы можете использовать уже существующий, или создать новый?Сохраните идентификатор бизнес-портфеля.
Бизнес-аккаунт WhatsApp (WABA)
Видеть Создайте бизнес-аккаунт WhatsApp для использования API WhatsApp Business? за помощью.
Если вы дон'дон'Если у вас нет приложения, вам нужно.. создать один с Бизнес Не забудьте добавить отображаемое имя и контактный адрес электронной почты в ваше приложение.
В качестве партнера по решениям ваше приложение должно пройти проверку и запросить расширенный доступ к следующим разрешениям:
whatsapp_business_management whatsapp_business_messaging whatsapp_business_manage_events Как партнер по решениям, вы также можете свободно использовать одно и то же приложение 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? и принять Условия предоставления услуг, указанные в информационном баннере.
Для всех новых пользователей 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-адресом, соответствующим требованиям Мета'Мета'песок WhatsAppWhatsApps требований. Ознакомьтесь с нашими Вебхуки Для получения более подробной информации см. документ. Если вам необходима конечная точка для целей тестирования, вы можете развернуть тестовое приложение Это просто выводит содержимое веб-хуков в вашу консоль.
настройка приложения
Как только конечная точка будет готова, настройте её для использования вашим приложением Meta:
В панели управления приложения перейдите в WhatsApp > Настройки , затем нажмите «Редактировать» .
После добавления информации нажмите «Проверить и сохранить» .
После сохранения вернитесь в «Конфигурация» , нажмите «Управление» и подпишитесь на отдельные поля веб-перехватчика. Чтобы получать уведомления о сообщениях клиентов, обязательно подпишитесь на Сообщения» .
Для каждого приложения веб-хуки нужно настроить всего один раз. Вы можете использовать один и тот же веб-хук для получения событий нескольких типов из нескольких учетных записей WhatsApp Business или настроить переопределение. Для получения дополнительной информации см. раздел «Веб-хуки».
Шаг 3: Подпишитесь на WABA
Чтобы получать уведомления для нужного аккаунта, подпишите приложение:
локонЕсли вы получите ответ, указанный ниже, все события Webhook для телефонных номеров, относящихся к этой учетной записи, будут отправлены на настроенную вами конечную точку Webhooks.
{ "success": true }Шаг
4: Получите идентификатор номера телефона
curl -X GET \ 'https://graph.facebook.com/v25.0/<WHATSAPP_BUSINESS_ACCOUNT_ID> /phone_numbers' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> '
{ "data": [ { "verified_name": "Jasper's Market", "display_phone_number": "+1 631-555-5555", "id": "1906385232743451", "quality_rating": "GREEN" }, { "verified_name": "Jasper's Ice Cream", "display_phone_number": "+1 631-555-5556", "id": "1913623884432103", "quality_rating": "NA" } ] }
Исключение при миграции
Шаг 5: Зарегистрируйте номер телефона
curl -X POST \ 'https://graph.facebook.com/v25.0/<FROM_PHONE_NUMBER_ID> /register' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> ' \ -H 'Content-Type: application/json' \ -d '{"messaging_product": "whatsapp","pin": "<6_DIGIT_PIN>"}'
{ "success": true }
Встроенная регистрация пользователей
Шаг 6: Получение сообщения от пользовательского приложения
Как только клиенты-участники отправят сообщение вашей компании, вы получите 24 часа бесплатного общения с ними —-Этот временной промежуток называется окном обслуживания клиентов. В целях тестирования мы хотим включить это окно, чтобы вы могли отправлять столько сообщений, сколько захотите.
Отправьте сообщение на только что зарегистрированный номер телефона через персональное приложение WhatsApp для iOS/Android. После отправки сообщения вы должны получить входящее сообщение на свой вебхук с уведомлением в следующем формате.
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "16315551234", "phone_number_id": "PHONE_NUMBER_ID" }, "contacts": [ { "profile": { "name": "Kerry Fisher" }, "wa_id": "16315555555" } ], "messages": [ { "from": "16315555555", "id": "wamid.ABGGFlA5FpafAgo6tHcNmNjXmuSf", "timestamp": "1602139392", "text": { "body": "Hello!" }, "type": "text" } ] }, "field": "messages" } ] } ] }
Шаг 7: Отправьте тестовое сообщение
curl -X POST \ 'https://graph.facebook.com/v25.0/<FROM_PHONE_NUMBER_ID> /messages' \ -H 'Авторизация: Bearer'<ACCESS_TOKEN> ' \ -H 'Content-Type: application/json' \ -d '{"messaging_product": "whatsapp", "to": "16315555555","text": {"body" : "hello world!"}}'
{ "id":"wamid.gBGGFlaCGg0xcvAdgmZ9plHrf2Mh-o" }
Следите за ежемесячными обновлениями
Мы будем выпускать обновления Cloud API в первый вторник каждого месяца. Они будут включать новые функции и улучшения дон'дон'Для использования новых функций не требуется никаких дополнительных действий, поскольку облачный 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 обрабатывает сообщения на серверах в Мета-центры обработки данных?Если компания выбирает использование локального хранилища 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? чтобы узнать больше.