WhatsApp Cloud API: Начало работы
Обновлено: 1 октября 2025 г
Это руководство поможет разработчикам быстро начать работу с WhatsApp Cloud API. Оно охватывает основные шаги настройки, включая регистрацию в качестве разработчика, создание приложения Meta, отправку первого сообщения и настройку тестовой конечной точки веб-перехватчика. Вы также узнаете, как генерировать защищенные токены доступа и отправлять как шаблонные, так и нешаблонные сообщения. Для более глубокого изучения представлены расширенные функции и дополнительные ресурсы.
Скачайте демонстрационное приложение
В демонстрационном приложении Jasper's Market содержатся все сообщения и код, использованные в демонстрации Jasper's Market. Вы можете использовать это демонстрационное приложение, чтобы научиться создавать приложение, которое отправляет и обрабатывает данные из WhatsApp Cloud API.
Предварительные требования
У вас должен быть аккаунт в Facebook или управляемый аккаунт Meta.Вы должны быть зарегистрированы как разработчик.
Если вы еще не зарегистрированы как разработчик, перейдите по ссылке https://developers.facebook.com/async/registration/ и следуйте инструкциям.Для отправки и получения тестовых сообщений во время настройки вам потребуется устройство с установленным WhatsApp.
Шаг 1. Создайте новое приложение Meta Developer и настройте его с WhatsApp
Вам необходимо создать приложение для разработчиков Meta и настроить его с учетом сценария использования WhatsApp.
Нажмите на кнопку «Перейти на панель управления приложения» и следуйте приведенным ниже инструкциям, чтобы начать работу.
Если у вас уже есть приложение Meta
Выберите существующее приложение на панели управления приложениями.Нажмите « Добавить варианты использования».Выберите пункт «Связаться с клиентами через WhatsApp» и следуйте инструкциям, чтобы добавить сценарий использования в ваше приложение.
Примечание: Если у вас нет бизнес-портфолио Meta, вы создадите его в процессе работы.
Если у вас нет приложения Meta
Следуйте инструкциям на панели управления приложениями, чтобы создать новое приложение.
Выберите Взаимодействие с клиентами через WhatsApp» .Выберите существующее бизнес-портфолио или следуйте подсказкам, чтобы создать новое.Завершите создание своего приложения.После создания приложения выберите пункт «Варианты использования » (значок карандаша) на боковой панели.
Шаг 2. Подключите ваше приложение Meta к бизнес-аккаунту WhatsApp
После создания приложения Meta вам необходимо подключить его к бизнес-аккаунту WhatsApp. Это подключение позволит вашему приложению получить доступ к облачному API WhatsApp и отправлять сообщения от имени вашей компании.
Перейдите в панель управления приложениями и выберите свое приложение.Нажмите на «Варианты использования » (значок карандаша) на боковой панели.В «Связь с клиентами через WhatsApp» нажмите «Настроить».В «Настройка API» выберите существующий бизнес-аккаунт WhatsApp или создайте новый:
Чтобы использовать существующий аккаунт: выберите аккаунт WhatsApp Business из выпадающего меню.Чтобы создать новый аккаунт: нажмите «Создать бизнес-аккаунт WhatsApp» и следуйте инструкциям, чтобы настроить свой бизнес-профиль.После подключения в панели настроек API отобразится идентификатор вашей бизнес-учетной записи WhatsApp.
Сохраните этот идентификатор для использования в вызовах API.
Примечание: Если вы создали новый бизнес-портфолио Meta во время создания приложения, для вас мог быть автоматически создан бизнес-аккаунт WhatsApp. Перед продолжением проверьте подключение в разделе «Настройка API».
Шаг 3. Отправьте первое шаблонное сообщение
После настройки нового приложения давайте отправим ваше первое сообщение в WhatsApp.
Нажмите на значок "Варианты использования " (значок карандаша) на боковой панели.В «Связь с клиентами через WhatsApp» нажмите «Настроить».В разделе «Быстрый старт» нажмите Начать использование API» и выполните первые 2 шага, чтобы отправить hello_world на выбранный вами номер телефона.
Обязательно сохраните идентификатор тестового номера телефона и идентификатор бизнес-аккаунта WhatsApp для дальнейшего использования.Получив отправленное вами сообщение, обязательно ответьте на него, чтобы продолжить разговор.
Шаг 5. Создайте системного пользователя и сгенерируйте постоянный токен доступа
Созданный вами временный токен доступа для отправки hello_world быстро истекает и не подходит для целей разработки. Поэтому вам следует создать постоянный токен для использования на всей платформе WhatsApp Business.
Перейдите в раздел «Настройки бизнеса » и нажмите «Пользователи системы» на боковой панели.Нажмите «Добавить+» в правом верхнем углу и следуйте инструкциям, чтобы создать нового системного пользователя.Выберите созданного вами нового системного пользователя и нажмите «Назначить ресурсы».
Выберите приложение и включите параметр «Управление приложением» в разделе «Полный доступ».Выберите свой аккаунт WhatsApp и включите параметр «Управление бизнес-аккаунтами WhatsApp» в разделе «Полный контроль».Нажмите «Назначить активы» .Нажмите «Сгенерировать токен».
Следуйте инструкциям, чтобы сгенерировать свой токен.Добавьте к токену следующие разрешения:
управление бизнесомwhatsapp_business_messagingwhatsapp_business_managementСкопируйте токен и сохраните его в безопасном месте для использования на последующих этапах.
WhatsApp Cloud API позволяет отправлять сообщения и получать веб-хуки — это основные элементы интеграции мессенджера. Помимо этих базовых функций, API предлагает дополнительные возможности, такие как создание и управление группами, а также поддержку звонков. Чтобы узнать больше об этих расширенных возможностях, ознакомьтесь с разделом «Подробнее» ниже.
Узнайте о различных типах сообщений, не являющихся шаблонамиУзнайте, как создавать и отправлять шаблонные сообщенияУзнайте, как создавать и управлять группами WhatsApp через APIУзнайте, как отправлять и принимать звонки в WhatsApp через APIУзнайте, как добавить рабочий телефонный номерУзнайте, как настроить собственный сервер веб-хуковСтаньте поставщиком решенийПросмотреть спецификацию OpenAPI API WhatsApp
Комментарии отсутствуют
Комментарии отсутствуют