Начало работы
В этом документе описаны необходимые условия и действия, которые нужно предпринять, чтобы интегрировать функции регистрации на сайте поставщика на свой сайт или портал для клиентов.
Перед началом работы
Для интеграции функций регистрации на сайте поставщика сначала потребуется настроить аккаунт Business Manager и приложение Meta.
Business Manager
Для управления своей кредитной линией и аккаунтами WhatsApp Business (WABA) зарегистрированных клиентов вам потребуется аккаунт Business Manager. Сведения о создании бизнес-аккаунта в Business Manager см. в этой статье. Настроив аккаунт Business Manager, подтвердите свою компанию.
Приложение Meta
Из своего аккаунта разработчика Meta создайте приложение типа Бизнес. На панели приложений доступны все ваши приложения Meta, для которых можно настраивать параметры и запрашивать разрешения.
Для бизнес-приложений автоматически одобряется стандартный уровень доступа со всеми разрешениями и функциями, доступными для приложения типа "Бизнес", поэтому на этом уровне доступа вы можете разрабатывать и тестировать свое приложение.
Это означает, что бизнес-приложения получают доступ только к данным пользователей, имеющих роли в приложении или компании. Перед выпуском необходимо пройти проверку приложения и запросить для него расширенный доступ с разрешением whatsapp_business_management. Рекомендуем начать эту процедуру как можно раньше. Чтобы начать этот процесс, не нужно дожидаться полной реализации регистрации на сайте поставщика.
Вы также должны будете запросить разрешение whatsapp_business_messaging для облачного API WhatsApp, поскольку оно требуется для вызовов API.
Настоятельно рекомендуем не запрашивать какие-либо другие разрешения, кроме этих двух, поскольку это замедлит процесс регистрации.
Маркеры доступа
Для доступа к данным зарегистрированных клиентов можно использовать как маркеры доступа системного пользователя бизнес-интеграции, так и маркеры доступа системного пользователя. Тип используемого вами маркера зависит от того, настраиваете ли вы регистрацию на сайте поставщика с помощью входа через Facebook или с помощью входа через Facebook для компаний, а также от того, являетесь ли вы поставщиком технологий или поставщиком решений.
Поставщики технологий
Предпочтительным маркером для поставщиков технологий является маркер доступа системного пользователя бизнес-интеграции, поскольку эти маркеры предназначены для отдельных клиентов. Вы можете получить один из этих маркеров путем обмена кода, возвращаемого вам каждый раз, когда клиент выполняет регистрацию на сайте поставщика, настроенную с помощью входа через Facebook для компаний. Если вы используете регистрацию на сайте поставщика, настроенную с помощью входа через Facebook (что не рекомендуется), вместо этого вы должны использовать маркер доступа системного пользователя.
Если вы используете маркер доступа системного пользователя, этот пользователь должен предоставить вашему приложению разрешение whatsapp_business_management.
Партнеры по решениям
Вы должны использовать маркер доступа системного пользователя, чтобы предоставить доступ к своей кредитной линии зарегистрированным клиентам. Для всех остальных запросов предпочтительным решением является использование маркера доступа системного пользователя бизнес-интеграции.
Вы можете получить маркер доступа системного пользователя бизнес-интеграции путем обмена кода, возвращаемого, когда клиент выполняет регистрацию на сайте поставщика, настроенную с помощью входа через Facebook для компаний. Если вы используете регистрацию на сайте поставщика, настроенную с помощью входа через Facebook (что не рекомендуется), вместо этого вы должны использовать маркер доступа системного пользователя.
Обратите внимание, что для маркеров доступа системного пользователя такой пользователь должен предоставить вашему приложению разрешение whatsapp_business_management (которое вы можете предоставить при создании маркера), а самому системному пользователю должна быть назначена роль финансового редактора, чтобы у вас была возможность поделиться своей кредитной линией с зарегистрированными клиентами.
Чтобы назначить вашему системному пользователю роль финансового редактора:
- Войдите в Meta Business Suite.
- Найдите свой бизнес-аккаунт в раскрывающемся меню в левом верхнем углу и нажмите значок шестеренки "Настройки".
- Выберите Настройки компании.
- Перейдите в раздел Пользователи > Системные пользователи.
- Отредактируйте информацию пользователя и назначьте ему роль финансового редактора.
Кредитная линия
Для отправки сообщений через платформу WhatsApp Business вам потребуется настроить кредитную линию. Эту кредитную линию вы будете предоставлять своим клиентам, поэтому проследите за тем, чтобы они приняли условия API Credit Allocation в Business Manager в разделе Настройки компании > Платежи.
Сведения о предоставлении кредитной линии через Business Manager вместо API см. в статье о предоставлении доступа к ежемесячному выставлению счетов на оплату.
Локальный клиент API платформы WhatsApp Business
Если вы используете локальный API, убедитесь, что для вашей версии клиента API WhatsApp Business не истек срок действия.
Процесс интеграции
В процессе интеграции необходимо пройти проверку приложения Meta и запросить для него расширенный доступ с разрешением whatsapp_business_management. Рекомендуем начать эту процедуру как можно раньше. Чтобы начать этот процесс, не нужно дожидаться полной реализации регистрации на сайте поставщика.
1. Реализуйте процесс регистрации на сайте поставщика.
Настройте Facebook SDK для JavaScript и вход через Facebook, чтобы реализовать функции регистрации на своем сайте или портале для клиентов. Этот процесс можно интегрировать и на нескольких веб-страницах или порталах, которые вам принадлежат.
2. Настройте интеграцию с необходимыми конечными точками.
Реализовав функции регистрации, настройте интеграцию с конечными точками API, необходимыми для этих функций. Прежде чем переходить на следующий шаг, убедитесь, что вам доступны следующие функции и возможности:
Когда регистрация будет завершена, используйте конечную точку message_templates, чтобы получить утвержденные шаблоны сообщений и пространства имен, которые необходимы компаниям для отправки сообщений.
Необходимо использовать защищенную конечную точку (HTTPS). Дополнительные сведения см. в статье Безопасность входа.
3. Подпишите аккаунты WhatsApp Business для получения Webhooks.
После того как компания пройдет регистрацию, вы можете оформить подписку на все аккаунты WhatsApp Business, для которых хотите получать Webhooks. Вызовы Webhooks можно настроить таким образом, чтобы получать оповещения о следующих событиях:
- изменение имени, привязанного к номеру телефона;
- изменение статуса качества номера телефона;
- проверка, обновление или блокировка аккаунта.
Необязательно
При необходимости вы можете: