Внедрение корпоративных клиентов в качестве поставщика технологических услуг или технологического партнера | Документация для разработчиков
Привлечение корпоративных клиентов в качестве поставщика или технологического партнера
Обновлено: 14 ноября 2025 г
В этом документе описаны шаги, которые поставщики и партнеры в сфере технологий должны выполнить для подключения новых корпоративных клиентов, завершивших встроенную процедуру регистрации.
Если вы являетесь поставщиком или партнером в сфере технологий, то любой бизнес-клиент, завершивший внедрение встроенной системы регистрации, не сможет использовать ваше приложение для доступа к своим ресурсам WhatsApp или для отправки и получения сообщений (если вы предоставляете услуги обмена сообщениями), пока вы не выполните эти шаги.
Что вам понадобится
Кроме того, если вы хотите проверить возможности обмена сообщениями, используя рабочий номер телефона клиента, вам понадобится номер телефона WhatsApp, на который уже можно отправлять и получать сообщения с других номеров WhatsApp.
Все описанные ниже запросы выполняйте, используя межсерверные запросы. Не используйте запросы на стороне клиента.
Шаг 1: Обменяйте код токена на бизнес-токен
Используйте GET /oauth/access_token для обмена кода токена, возвращаемого функцией Embedded Signup, на токен доступа пользователя к системе бизнес-интеграции («бизнес-токен»).
Запрос
curl --get 'https://graph.facebook.com/v21.0/oauth
/access_token' \ -d 'client_id=
< APP_ID > ' \ -d 'client_secret=
< APP_SECRET > ' \ -d 'code=
< CODE > '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<APP_ID> | Необходимый. Идентификатор вашего приложения. Он отображается в верхней части панели управления приложения . | 236484624622562 |
<APP_SECRET> | Необходимый. Ваш секретный ключ приложения. Вы можете получить его в панели управления приложением > Секретный ключ приложения > Основные параметры. | 614fc2afde15eee07a26b2fe3eaee9b9 |
<CODE> | Необходимый. Код , возвращаемый встроенной системой регистрации после успешного завершения клиентом процесса регистрации. | |
Ответ
В случае успеха:
<BUSINESS_TOKEN>
Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_TOKEN> | Бизнес-токен клиента . | |
Шаг 2: Подпишитесь на веб-хуки в WABA клиента
Используйте POST /
Запрос
curl -X POST 'https://graph.facebook.com/
< API_VERSION > / < WABA_ID > /subscribed_apps' \ -H 'Авторизация: Bearer
< ACCESS_TOKEN > '
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<API_VERSION>Нить | Необязательный. Версия Graph API. | v25.0 |
| Необходимый. -токен корпоративного клиента . | |
| Необходимый. Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
Ответ
В случае успеха:
{
"success"
: true }
Шаг 3: Зарегистрируйте номер телефона клиента
Используйте POST /
Запрос
curl 'https://graph.facebook.com/v21.0/
< BUSINESS_CUSTOMER_PHONE_NUMBER_ID > /register' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< BUSINESS_TOKEN > ' \ -d '
{
"messaging_product": "whatsapp",
"pin": "
< DESIRED_PIN > " }'
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
| Необходимый. Идентификатор номера корпоративного телефона клиента. | 106540352242922 |
| Необходимый. -токен корпоративного клиента . | |
| Необходимый. Установите это значение на 6-значное число. Это будет PIN-код для двухфакторной аутентификации номера телефона компании. | 581063 |
Ответ
В случае успеха:
{
"успех": правда
}
Шаг 4: Отправьте тестовое сообщение
Этот шаг необязателен.
Если вы хотите проверить возможности обмена сообщениями с бизнес-номера телефона вашего клиента, отправьте сообщение на этот номер со своего номера WhatsApp (это откроет окно службы поддержки , где вы сможете ответить любым сообщением).
Запрос
curl 'https://graph.facebook.com/v21.0/
< BUSINESS_CUSTOMER_PHONE_NUMBER_ID > /messages' \ -H 'Content-Type: application/json' \
-H 'Authorization: Bearer
< BUSINESS_TOKEN > ' \ -d '
{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "
< WHATSAPP_USER_NUMBER > ", "type": "text",
"text": {
"body": "
< BODY_TEXT > " }
}'
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
| Необходимый. Текст сообщения. Поддерживает URL-адреса. Максимальное количество символов: 4096. | Сообщение получено, четко и ясно! |
| Необходимый. Идентификатор номера корпоративного телефона клиента. | 106540352242922 |
| Необходимый. -токен корпоративного клиента . | |
| Необходимый. Ваш номер телефона WhatsApp, с которого вы можете отправлять и получать сообщения с других номеров WhatsApp. Обратите внимание, что это не может быть корпоративный номер телефона, уже зарегистрированный для использования с Cloud API. | +16505551234 |
Ответ
В случае успеха:
{
"messaging_product": "whatsapp",
"contacts": [
{
"input": "
< WHATSAPP_USER_NUMBER > ", "wa_id": "
< WHATSAPP_USER_ID > " }
],
"messages": [
{
"id": "
< WHATSAPP_MESSAGE_ID > " }
]
}
Параметры отклика
| Заполнитель | Описание | Пример значения |
|---|---|---|
<WHATSAPP_MESSAGE_ID> | Идентификатор сообщения WhatsApp. | wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA |
<WHATSAPP_USER_ID> | Ваш идентификатор пользователя WhatsApp. | 16505551234 |
<WHATSAPP_USER_NUMBER> | Номер телефона WhatsApp, на который было отправлено сообщение. | +16505551234 |
Если вам удалось успешно отправлять и получать сообщения, используя рабочий телефонный номер клиента, и если сработали веб-хуки, описывающие отправленное вами первоначальное сообщение , а также статусы доставки отправленного вами ответного сообщения, значит, рабочий телефонный номер клиента работает корректно.
Шаг 5: Предложите клиенту добавить способ оплаты
Попросите клиента использовать WhatsApp Manager для добавления способа оплаты. Вы можете предоставить ему следующую ссылку на Справочный центр:
В качестве альтернативы вы можете дать им указание:
После добавления способа оплаты ваш клиент полностью интегрируется в платформу WhatsApp Business и сможет начать использовать ваше приложение для доступа к своим ресурсам WhatsApp, а также для отправки и получения сообщений (если вы предоставляете ему эту услугу).