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

Настройка тестовой учетной записи для звонков | Документация для разработчиков

Создайте тестовую учетную запись для звонков

Обновлено: 31 октября 2025 г
Доступ к тестовым учетным записям (Sandbox accounts) предоставляется только технологическим партнерам.

Обзор

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

    лимиты вызовов учетной записи песочницы

    В таблице ниже указаны ограничения на количество вызовов для тестовых учетных записей. Эти ограничения могут быть изменены.
    Лимит Описание Ограничение количества произведенных изделий Ограничение на количество публичных тестов
    Лимит подключенных звонков
    Количество звонков, которые компании разрешено совершать с использованием утвержденных разрешений.
    100 совершенных звонков за 24 часа
    Без изменений
    Ограничения на количество сообщений запроса разрешения на вызов
    Ограничивает количество сообщений запроса разрешения на вызов, которые могут быть отправлены одному и тому же потребителю
    1 запрос в день
    2 запроса в неделю
    25 запросов в день
    100 запросов в неделю
    Лимиты неотвеченных звонков
    Когда звонок, инициированный компанией, остается без ответа (по сути, отклоняется пользователем или пропускается пользователем).
    Напоминание о двух подряд неотвеченных звонках
    Отозвать разрешение по 4 последовательным неотвеченным звонкам
    Напоминание о пяти подряд неотвеченных звонках
    Отменить подписку после 10 последовательных неотвеченных звонков
    Временная продолжительность звонка
    Период времени, в течение которого компания может связаться с пользователем после подтверждения его разрешения.
    7 дней
    Без изменений

    Создайте тестовую учетную запись

    Шаг 1. Войдите в песочницу разработчика WhatsApp

      Перейдите на панель управления приложения .Нажмите на приложение, которое вы используете, и введите WhatsApp.Выберите варианты использования (значок карандаша) на боковой панели.В разделе «Связь с клиентами через WhatsApp» нажмите «Настроить» .В левом меню выберите «Инструменты для партнеров» .В «Заявка на создание учетной записи в песочнице» , в подразделе «Функции» , щелкните раскрывающийся список. Выберите «Cloud API и вызовы» .Нажмите «Заявить права на тестовый аккаунт» .В разделе «Включить функцию звонков» щелкните раскрывающийся список, затем выберите «Управление списком телефонных номеров» .Добавьте свой номер телефона в качестве получателя.

      Шаг 2. Получите учетные данные и идентификаторы для вашей тестовой учетной записи

        На той же странице, в разделе «Настройка нового процесса регистрации» , нажмите « Начать» , чтобы открыть встроенную форму регистрации.
          Примечание: Держите эту вкладку открытой и доступной, так как вы будете использовать ее несколько раз в процессе работы.В «Встроенная регистрация» убедитесь, что «Функции» пуст, затем нажмите «Войти через Facebook» .Появится всплывающее окно со встроенной формой регистрации. В разделе «Бизнес-портфолио» выберите «Песочница для бизнеса» .Заполните оставшуюся необходимую информацию, затем нажмите «Далее» .На следующем экране в «Создать или выбрать бизнес-профиль WhatsApp» выберите «Тестовый номер» .После завершения процесса авторизации в «Токен обмена» нажмите «Получить токен» .
            Примечание: Сохраните этот токен для дальнейшего использования API для тестовых учетных записей.В «Получить данные общего бизнес-аккаунта WhatsApp» нажмите «Получить данные WABA» .В поле «Бизнес-аккаунт WhatsApp» скопируйте значение из id .
              Примечание: Сохраните этот идентификатор, поскольку это идентификатор бизнес-аккаунта WhatsApp для тестовой среды WABA.В «Получить номера телефонов» нажмите «Получить номера телефонов» .В поле ID скопируйте значение.
                Примечание: Сохраните этот идентификатор, поскольку это идентификатор номера телефона для вашей тестовой учетной записи в песочнице.

                Шаг 3. Зарегистрируйте свой тестовый номер телефона и подпишитесь на WABA

                Предварительные требования
                Убедитесь, что у вас есть следующая информация, полученная на предыдущих этапах:
                  Строка токена вашей тестовой учетной записиИдентификатор WABA вашей учетной записи в песочницеВаш тестовый номер телефона ID
                  Для выполнения следующих шагов вам потребуется использовать инструмент Graph API Explorer .
                    Примечание: Оставьте это окно открытым, так как вы будете использовать созданную вами конфигурацию снова на последующих шагах этого руководства.
                      Перейдите к инструменту Graph API Explorer .Убедитесь, что вы используете последнюю версию API.Нажмите «Сгенерировать токен доступа» и следуйте инструкциям.В разделе «Разрешения» добавьте разрешения whatsapp_business_management и whatsapp_business_messaging В конструкторе конечных точек введите / /subscribed_apps , затем нажмите «Отправить» . 
                      

                      { "success": true }
                      

                        Далее зарегистрируйте свой тестовый номер телефона, введя / /register в конструкторе конечных точек.В левой боковой панели нажмите JSON, затем введите следующий JSON-код и нажмите «Отправить»:

                        

                        {
                        
"messaging_product": "whatsapp", "pin": "123456" }
                          Вы должны получить стандартный  об успешном завершении :

                          

                          { "success": true }
                          

                          

                          

                          Шаг
4. Проверьте функциональность вашей системы обмена сообщениями
                            В Инструмент Graph API Explorer, входить /<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID> /сообщения в конструкторе конечных точек.В левой боковой панели нажмите JSONЗатем введите следующий JSON-текст и нажмите кнопку Представлять на рассмотрение:
                            { "messaging_product": "whatsapp", "to": "YOUR_NUMBER", // Замените это значение номером телефона вашего устройства. "type": "template", "template": { "name": "hello_world", "language": { "code": "en_US" } } }
                              Вы получите ответ с "message_status": "accepted" и вы должны получить текстовое сообщение на своё устройство.
                              Шаг 5. Настройка веб-хуков и прав доступа
                              

                                Перейдите на панель управления приложения .Нажмите на приложение, которое вы используете, и введите WhatsApp.Выберите варианты использования (значок карандаша) на боковой панели.В разделе «Связь с клиентами через WhatsApp» нажмите «Настроить» .В левой боковой панели нажмите «Конфигурация» .В поле "URL обратного вызова" укажите URL обратного вызова для вашего веб-сервера перехвата.

                                  Если у вас нет сервера веб-перехватчиков, вы можете следовать нашим инструкциям по созданию тестового сервера веб-перехватчиков .В разделе «Проверить токен» добавьте произвольную строку проверки.Нажмите «Проверить и сохранить» .На следующей странице в  «Выберите продукт» нажмите «Аккаунт WhatsApp Business» .В разделе «Поля веб-перехватчика» , в  «Вызовы» , нажмите кнопку-переключатель, чтобы подписаться на  «Вызовы» .

                                  

                                  

                                  Заканчивать:
Включите функцию звонков на тестовом телефонном номере
                                    В Инструмент Graph API Explorer, входить /<YOUR_SANDBOX_TEST_PHONE_NUMBER_ID> /настройки в конструкторе конечных точек.В левой боковой панели нажмите JSONЗатем введите следующий JSON-текст и нажмите кнопку Представлять на рассмотрение:
                                    { "calling": { "status": "ENABLED", "call_icon_visibility": "DEFAULT", "callback_permission_status": "ENABLED" } }
                                      Вы должны получить стандарт успех ответ:
                                      { "success": true }
                                        Наконец, под Токен доступаСкопируйте токен доступа для дальнейшего использования.
    
                                          Примечание: Сохраните этот токен доступа, так как вы будете использовать его для выполнения вызовов API при тестировании интеграции с Calling API.
                                          Тестирование звонков, инициированных компанией
                                          

                                          Прежде чем тестировать звонки, инициированные бизнесом (BIC), необходимо предоставить пользователям права на совершение звонков в вашей тестовой учетной записи.
                                          

                                          Это можно сделать на клиентском устройстве, которое вы используете для тестирования:
                                          

                                            На своем устройстве откройте WhatsApp.Перейдите к ветке сообщений, в которой указан номер телефона вашей тестовой группы.В верхней части экрана коснитесь номера телефона компании, работающей в тестовой среде.Прокрутите вниз и нажмите «Разрешение на деловые звонки» .Нажмите « Разрешить звонки» .

                                            Теперь вы можете использовать интеграцию Calling API для звонка на клиентское устройство и тестирования вашей интеграции.
                                            


                                            

                                            

                                            

                                            Тестирование вызова, инициированного пользователем
                                            

                                            Вы можете протестировать инициированные пользователем вызовы (UIC) на клиентском устройстве, которое используете для тестирования:
                                            

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

    
                                                      
                                              
    
                                              

            
                                              
        
                                              
    
                                              

    
                                              

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