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 для дальнейшего использования.Получив отправленное вами сообщение, обязательно ответьте на него, чтобы продолжить разговор.
Шаг
4. Настройка тестового приложения веб-перехватчика
Для получения уведомлений о статусе сообщений, таких как «прочитано» и «доставлено», вам потребуется настроить конечную точку веб-перехватчика.
После того, как ваше тестовое приложение с веб-перехватчиком будет настроено, ответьте в созданном вами чате WhatsApp. Вы увидите полезную нагрузку веб-перехватчика в вашем тестовом приложении примерно такого вида:
{ "object": "whatsapp_business_account", "entry": [ { "id": "215589313241560883", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15551797781", "phone_number_id": "7794189252778687" }, "contacts": [ { "profile": { "name": "Jessica Laverdetman" }, "wa_id": "13557825698" } ], "messages": [ { "from": "17863559966", "id": "wamid.HBgLMTc4NjM1NTk5NjYVAGHAYWYET688aASGNTI1QzZFQjhEMDk2QQA=", "timestamp": "1758254144", "text": { "body": "Привет!" }, "type": "text" } ] }, "field": "messages" } ] } ] }
Шаг 5. Создайте системного пользователя и сгенерируйте постоянный токен доступа
Созданный вами временный токен доступа для отправки hello_world быстро истекает и не подходит для целей разработки. Поэтому вам следует создать постоянный токен для использования на всей платформе WhatsApp Business.
Перейдите в раздел «Настройки бизнеса» и нажмите «Пользователи системы» на боковой панели.Нажмите «Добавить+» в правом верхнем углу и следуйте инструкциям, чтобы создать нового системного пользователя.Выберите созданного вами нового системного пользователя и нажмите «Назначить ресурсы».
Выберите приложение и включите параметр «Управление приложением» в разделе «Полный доступ».Выберите свой аккаунт WhatsApp и включите параметр «Управление бизнес-аккаунтами WhatsApp» в разделе «Полный контроль».Нажмите «Назначить активы» .Нажмите «Сгенерировать токен».
Следуйте инструкциям, чтобы сгенерировать свой токен.Добавьте к токену следующие разрешения:
управление бизнесомwhatsapp_business_messagingwhatsapp_business_managementСкопируйте токен и сохраните его в безопасном месте для использования на последующих этапах.
Шаг
6. Отправьте сообщение, не являющееся шаблоном
Когда вы ответили на свое предыдущее тестовое сообщение, вы запустили то, что называется окно обслуживания клиентовЭтот 24-часовой период позволяет вам отправить сообщение сообщения, не являющиеся шаблонами пользователям WhatsApp. После открытия окна службы поддержки вы можете отправить себе сообщение, не являющееся шаблоном. Для этого вставьте свой тестовый идентификатор номера телефона, токен доступа системного пользователя и свой номер телефона в приведенный ниже пример кода, затем вставьте код в терминал и запустите его.локон 'https://graph.facebook.com/v23.0/<TEST_BUSINESS_PHONE_NUMBER_ID> /сообщения' \
-ЧАС 'Content-Type: application/json' \
-ЧАС «Авторизация: Предъявитель»<SYSTEM_USER_ACCESS_TOKEN> ' \
-д ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "text", "text": { "body": "Привет!" } }'
После успешной отправки сообщения проверьте тестовое приложение веб-перехватчика, чтобы увидеть событие веб-перехватчика, подтверждающее получение сообщения.
WhatsApp Cloud API позволяет отправлять сообщения и получать веб-хуки — это основные элементы интеграции мессенджера. Помимо этих базовых функций, API предлагает дополнительные возможности, такие как создание и управление группами, а также поддержку звонков. Чтобы узнать больше об этих расширенных возможностях, ознакомьтесь с разделом «Подробнее» ниже.
Узнайте о различных типах сообщений, не являющихся шаблонамиУзнайте, как создавать и отправлять шаблонные сообщенияУзнайте, как создавать и управлять группами WhatsApp через APIУзнайте, как отправлять и принимать звонки в WhatsApp через APIУзнайте, как добавить рабочий телефонный номерУзнайте, как настроить собственный сервер веб-хуковСтаньте поставщиком решенийПросмотреть спецификацию OpenAPI API WhatsApp
