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. Set Up the Test Webhook App
Для получения уведомлений о статусе сообщений, таких как «прочитано» и «доставлено», вам потребуется настроить конечную точку веб-перехватчика.
После того, как ваше тестовое приложение с веб-перехватчиком будет настроено, ответьте в созданном вами чате 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. Send a Non-Template Message
When you responded to your earlier test message, you triggered what is known as a окно обслуживания клиентов. This 24-hour window allows you to send non-template messages to users on WhatsApp. With the customer service window now open, you can send a non-template message to yourself. To do this, insert your test phone number ID, the system user access token, and your phone number in the code sample below, then paste the code into your terminal and run it.локон 'https://graph.facebook.com/v23.0/<TEST_BUSINESS_PHONE_NUMBER_ID>/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС 'Authorization: Bearer <SYSTEM_USER_ACCESS_TOKEN>' \
-д ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER>", "type": "text", "text": { "body": "Hello!" } }'
После успешной отправки сообщения проверьте тестовое приложение веб-перехватчика, чтобы увидеть событие веб-перехватчика, подтверждающее получение сообщения.
WhatsApp Cloud API позволяет отправлять сообщения и получать веб-хуки — это основные элементы интеграции мессенджера. Помимо этих базовых функций, API предлагает дополнительные возможности, такие как создание и управление группами, а также поддержку звонков. Чтобы узнать больше об этих расширенных возможностях, ознакомьтесь с разделом «Подробнее» ниже.
Узнайте о различных типах сообщений, не являющихся шаблонамиУзнайте, как создавать и отправлять шаблонные сообщенияУзнайте, как создавать и управлять группами WhatsApp через APIУзнайте, как отправлять и принимать звонки в WhatsApp через APIУзнайте, как добавить рабочий телефонный номерУзнайте, как настроить собственный сервер веб-хуковСтаньте поставщиком решенийПросмотреть спецификацию OpenAPI API WhatsApp
