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

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

Внедрение корпоративных клиентов в качестве партнеров по решениям

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

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

    WABA-идентификатор бизнес-клиента (возвращается через логирование сессии или API-запрос )Идентификатор номера корпоративного телефона клиента (возвращается через журнал сессии или API-запрос ).Идентификатор вашего приложения (отображается в верхней части панели управления приложения ).Ваш секретный ключ приложения (отображается в панели управления приложением > Настройки приложения > Основные параметры).Идентификатор вашей кредитной линии (отображается в Business Manager > Business Settings > Business Info или возвращается через 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 'Авторизация: Предъявитель' <ТОКЕН ДОСТУПА>'
    Параметры запроса
    

    

    



Заполнитель 

Описание 

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




    

    <BUSINESS_TOKEN>
    


    

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

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


    

    EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
    



    

    <WABA_ID>
    


    

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

    Идентификатор WABA клиента.
    


    

    102290129340398
    

    

    

    

    Ответ
    

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

    

    {
     "success"
     : true }
    

    

    

    

    Шаг 3: Сообщите клиенту о вашей кредитной линии
    

    

    В настоящее время мы тестируем новые шаги для предоставления доступа к вашей кредитной линии уже подключенным бизнес-клиентам. Эти шаги в конечном итоге заменят данный, поэтому, если вы хотите внедрить их сейчас, см. Альтернативный способ предоставления доступа к вашей кредитной линии .
    

    Примечание : Если вы используете API, указанный ниже, а именно whatsapp_credit_sharing_and_attach , вам необходимо предварительно добавить своего системного пользователя в общие бизнес-аккаунты WhatsApp. Инструкции см. в этом документе .
    

    После добавления пользователя «Система» в бизнес-аккаунт WhatsApp используйте POST / /whatsapp_credit_sharing_and_attach — конечная точка для предоставления доступа к вашей кредитной линии подключенному бизнес-клиенту.
    

    

    

    

    Запрос
    

    

    локон
    
-X
    
ПОЧТА
    
'https://graph.facebook.com/<API_VERSION>/<РАСШИРЕННЫЙ_ИД_КРЕДИТНОЙ_ЛИНИИ>/whatsapp_credit_sharing_and_attach?waba_currency=<CUSTOMER_BUSINESS_CURRENCY>&waba_id=<CUSTOMER_WABA_ID>'
    
\
    -H 'Авторизация: Предъявитель' <СИСТЕМНЫЙ_ТОКЕН>'
    Параметры запроса
    

    

    



Заполнитель 

Описание 

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




    

    <CUSTOMER_BUSINESS_CURRENCY>
    


    

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

    Валюта компании представлена ​​в виде трехбуквенного кода валюты. Поддерживаемые значения:
    

      АУДевроФунт стерлинговИДРмРНКдоллар США

      Эта валюта используется для выставления счетов и соответствует ценовым ставкам.
      


      

      доллар США
      



      

      <CUSTOMER_WABA_ID>
      


      

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

      Идентификатор WABA клиента.
      


      

      102290129340398
      



      

      <EXTENDED_CREDIT_LINE_ID>
      


      

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

      Идентификатор вашей расширенной кредитной линии.
      


      

      1972385232742146
      



      

      <SYSTEM_TOKEN>
      


      

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

      Ваш системный токен.
      


      

      EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
      

      

      

      

      Ответ
      

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

      

      {
      
"allocation_config_id":
      
"<ИД_КОНФИГУРАЦИИ_РАСПРЕДЕЛЕНИЯ>",
      
"waba_id":
      
"<CUSTOMER_WABA_ID>"
      }
      Параметры отклика
      

      

      



Заполнитель 

Описание 

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




      

      <ALLOCATION_CONFIGURATION_ID>
      


      

      Идентификатор конфигурации распределения расширенной кредитной линии.
      

      Сохраните этот идентификатор, если хотите убедиться  что информация о вашей кредитной линии была предоставлена ​​клиенту.
      


      

      58501441721238
      



      

      <CUSTOMER_WABA_ID>
      


      

      Идентификатор WABA клиента.
      


      

      102290129340398
      Шаг 4: Зарегистрируйте номер телефона клиента
      Используйте ПОЧТА /<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_PHONE_NUMBER_ID>
      Необходимый.
      Получен идентификатор номера рабочего телефона клиента.
      106540352242922
      <BUSINESS_TOKEN>
      Необходимый.
      Бизнес-токен клиента.
      EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn
      <DESIRED_PIN>
      Необходимый.
      Установите это значение на 6-значное число. Это будет PIN-код для двухфакторной аутентификации номера телефона компании.
      581063
      Ответ
      В случае успеха:
      {
        "успех": правда
      }
      Шаг 5: Отправьте тестовое сообщение
      Этот шаг необязателен.
      Если вы хотите проверить возможности обмена сообщениями с корпоративного номера телефона вашего клиента, отправьте сообщение на этот номер со своего номера 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_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
      Если вам удалось успешно отправлять и получать сообщения, используя рабочий телефонный номер клиента, и если сообщения были активированы веб-хуки описание вашего первоначального сообщенияа также статусы доставки Судя по вашему ответному сообщению, рабочий номер телефона клиента работает корректно.
      
    
              
      
    
      

            
      
        
      
    
      

    
      

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