Перейти к основному содержимому

Внедрение корпоративных клиентов в качестве поставщика технологических услуг или технологического партнера | Документация для разработчиков

Привлечение корпоративных клиентов в качестве поставщика или технологического партнера

Обновлено: 14 ноября 2025 г
В этом документе описаны шаги, которые поставщики и партнеры в сфере технологий должны выполнить для подключения новых корпоративных клиентов, завершивших встроенную процедуру регистрации.
Если вы являетесь поставщиком или партнером в сфере технологий, то любой бизнес-клиент, завершивший внедрение встроенной системы регистрации, не сможет использовать ваше приложение для доступа к своим ресурсам WhatsApp или для отправки и получения сообщений (если вы предоставляете услуги обмена сообщениями), пока вы не выполните эти шаги.

Что вам понадобится

    WABA-идентификатор бизнес-клиента (возвращается через логирование сессии или API-запрос )Идентификатор номера корпоративного телефона клиента (возвращается через журнал сессии или API-запрос ).Идентификатор вашего приложения (отображается в верхней части панели управления приложения ).Ваш секретный ключ приложения (отображается в панели управления приложением > Настройки приложения > Основные параметры).
    Кроме того, если вы хотите проверить возможности обмена сообщениями, используя рабочий номер телефона клиента, вам понадобится номер телефона WhatsApp, на который уже можно отправлять и получать сообщения с других номеров WhatsApp.
    Все описанные ниже запросы выполняйте, используя межсерверные запросы. Не используйте запросы на стороне клиента.

    Шаг 1: Обменяйте код токена на бизнес-токен

    Используйте GET /oauth/access_token для обмена кода токена, возвращаемого функцией Embedded Signup, на токен доступа пользователя к системе бизнес-интеграции («бизнес-токен»).

    Запрос

    

    локон
    
--получать
    
'https://graph.facebook.com/v21.0/oauth/access_token'
    
\
    -д
    
'client_id=<APP_ID>' \
    -d 'client_secret=<APP_SECRET>' \
    -d 'code=<КОД>'
    Параметры запроса
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <APP_ID>
    


    

    Необходимый.
    

    Идентификатор вашего приложения. Он отображается в верхней части панели управления приложения .
    


    

    236484624622562
    



    

    <APP_SECRET>
    


    

    Необходимый.
    

    Ваш секретный ключ приложения. Вы можете получить его в панели управления приложением > Секретный ключ приложения > Основные параметры.
    


    

    614fc2afde15eee07a26b2fe3eaee9b9
    



    

    <CODE>
    


    

    Необходимый.
    

    Код , возвращаемый встроенной системой регистрации после успешного завершения клиентом процесса регистрации.
    


    

    AQBhlXsctMxJYbwbrpybxlo9tLPGy-QAmjBJA03jxLos43wxlBlrYozY5C33BXJULd133cOJf_5y6EkJZYMrAmW-EMj3Wdap9-NUM2nS4s8 tC-ES7slBhh6QpCFM7-Szpi-iqsjqTGyxbUUW3AeaEyLkeZFIkBgcQ_SOxo9HShm20SDR5_n7AT9ZJ5dcgpqBQykNT-pQ8V7Ne9-sr6RLAWt JMF7-Zx6ABudRcWIN53tUTtquDVNuq3lrco4BlVQAv-54tR83Ae0ODN9Uet6j-BVLuetXhQCM3sz9RdgedlbxkidMbkztvYX1j7baOrJxyLyYGWYgbnUrKRQKCtWTsO5ekIGFgtbpS8UPJNqV6j8E5XKPJ8QA7ZFqzkB0s2O__J5FrjHzc_rDo1EuRbw98ihHDzQnvuXeHapEyfhLDJct0A
    

    

    

    

    Ответ
    

    В случае успеха:
    

    

    <BUSINESS_TOKEN>
    

    

    

    

    Параметры отклика
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <BUSINESS_TOKEN>
    


    

    Бизнес-токен клиента .
    


    

    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    

    

    

    

    Шаг 2: Подпишитесь на веб-хуки в WABA клиента
    

    Используйте POST /  /subscribed_apps используется для подписки вашего приложения на веб-хуки в WABA бизнес-клиента. Если вы хотите, чтобы веб-хуки клиента отправлялись на другой URL-адрес обратного вызова, отличный от того, который установлен в вашем приложении, у вас есть несколько  переопределения веб-хуков .
    

    

    

    

    Запрос
    

    

    локон
    
-X
    
ПОЧТА
    
'https://graph.facebook.com/<API_VERSION>/<WABA_ID>/subscribed_apps'
    
\
    -H 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>'
    Параметры запроса
    

    

    



Заполнитель 

Описание 

Пример значения 




    

    <API_VERSION>
    

    Нить
    


    

    Необязательный.
    

    Версия Graph API.
    


    

    v25.0
    



    

    Нить
    


    

    Необходимый.
    

    


    

    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    



    

    Нить
    


    

    Необходимый.
    

    Идентификатор бизнес-аккаунта WhatsApp.
    


    

    102290129340398
    

    

    

    

    Ответ
    

    В случае успеха:
    

    

    {
     "success"
     : true }
    

    

    

    Шаг
3: Зарегистрируйте номер телефона клиента
    Используйте ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /register Конечная точка для регистрации номера корпоративного телефона клиента для использования с Cloud API.
    Запрос
    curl 'https://graph.facebook.com/v21.0/<НОМЕР ТЕЛЕФОНА_КЛИЕНТА_КОМПАНИИ>/register' \
    -H 'Content-Type: application/json' \
    -H 'Авторизация: Предъявитель' <BUSINESS_TOKEN>' \
    -д '
    {
      "messaging_product": "whatsapp",
      "приколоть": "<ЖЕЛАЕМЫЙ_ПИН-КОД>"
    }'
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <BUSINESS_CUSTOMER_PHONE_NUMBER_ID>Нить
    Необходимый.
    Идентификатор номера корпоративного телефона клиента.
    106540352242922
    <BUSINESS_TOKEN>Нить
    Необходимый.
    Корпоративный клиент бизнес-токен.
    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    <DESIRED_PIN>Нить
    Необходимый.
    Установите это значение на 6-значное число. Это будет PIN-код для двухфакторной аутентификации номера телефона компании.
    581063
    Ответ
    В случае успеха:
    {
      "успех": правда
    }
    Шаг 4: Отправьте тестовое сообщение
    Этот шаг необязателен.
    Если вы хотите проверить возможности обмена сообщениями с корпоративного номера телефона вашего клиента, отправьте сообщение на этот номер со своего номера WhatsApp (это откроет...) окно обслуживания клиентов(что позволяет вам отвечать любым типом сообщения).
    Далее используйте ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщения Конечная точка для отправки текстового сообщения в ответ.
    Запрос
    curl 'https://graph.facebook.com/v21.0/<НОМЕР ТЕЛЕФОНА_КЛИЕНТА_КОМПАНИИ>/messages' \
    -H 'Content-Type: application/json' \
    -H 'Авторизация: Предъявитель' <BUSINESS_TOKEN>' \
    -д '
    {
      "messaging_product": "whatsapp",
      "recipient_type": "individual",
      "к": "<НОМЕР ПОЛЬЗОВАТЕЛЯ WHATSAPP>",
      "type": "text",
      "текст": {
        "тело": "<BODY_TEXT>"
      }
    }'
    Параметры запроса
    
Заполнитель

Описание

Пример значения

    <BODY_TEXT>Нить
    Необходимый.
    Текст сообщения. Поддерживает URL-адреса.
    Максимальное количество символов: 4096.
    Сообщение получено, четко и ясно!
    <BUSINESS_CUSTOMER_PHONE_NUMBER_ID>Нить
    Необходимый.
    Идентификатор номера корпоративного телефона клиента.
    106540352242922
    <BUSINESS_TOKEN>Нить
    Необходимый.
    Корпоративный клиент бизнес-токен.
    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    <WHATSAPP_USER_NUMBER>Нить
    Необходимый.
    Ваш номер телефона WhatsApp, с которого вы можете отправлять и получать сообщения с других номеров WhatsApp.
    Обратите внимание, что это не может быть корпоративный номер телефона, уже зарегистрированный для использования с Cloud API.
    +16505551234
    Ответ
    В случае успеха:
    {
      "messaging_product": "whatsapp",
      "контакты": [
        {
          "вход": "<НОМЕР ПОЛЬЗОВАТЕЛЯ WHATSAPP>",
          "wa_id": "<Идентификатор_пользователя_WhatsApp>"
        }
      ],
      "сообщения": [
        {
          "идентификатор": "<Идентификатор сообщения WhatsApp>"
        }
      ]
    }
    Параметры отклика
    
Заполнитель

Описание

Пример значения

    <WHATSAPP_MESSAGE_ID>
    Идентификатор сообщения WhatsApp.
    wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA
    <WHATSAPP_USER_ID>
    Ваш идентификатор пользователя WhatsApp.
    16505551234
    <WHATSAPP_USER_NUMBER>
    Номер телефона WhatsApp, на который было отправлено сообщение.
    +16505551234
    Если вам удалось успешно отправлять и получать сообщения, используя рабочий телефонный номер клиента, и если сообщения были активированы веб-хуки описание вашего первоначального сообщенияа также статусы доставки Судя по вашему ответному сообщению, рабочий номер телефона клиента работает корректно.
    Шаг 5: Предложите клиенту добавить способ оплаты
    

    Попросите клиента использовать WhatsApp Manager для добавления способа оплаты. Вы можете предоставить ему следующую ссылку на Справочный центр:
    


    В качестве альтернативы вы можете дать им указание:
    

      Перейдите в раздел «Менеджер WhatsApp» > «Обзор»  ссылке https://business.facebook.com/wa/manage/home/Нажмите кнопку «Добавить способ оплаты» Завершите процесс

      После добавления способа оплаты ваш клиент полностью интегрируется в платформу WhatsApp Business и сможет начать использовать ваше приложение для доступа к своим ресурсам WhatsApp, а также для отправки и получения сообщений (если вы предоставляете ему эту услугу).
      
    
              
      
    
      

            
      
        
      
    
      

    
      

    
    
      
        
      
             Вернуться наверх