WhatsApp Cloud API: начало работы | Документация для разработчиков
WhatsApp Cloud API: Начало работы
Обновлено: 1 октября 2025 г
Это руководство поможет разработчикам быстро начать работу с WhatsApp Cloud API. Оно охватывает основные шаги настройки, включая регистрацию в качестве разработчика, создание приложения Meta, отправку первого сообщения и настройку тестовой конечной точки веб-перехватчика. Вы также узнаете, как генерировать защищенные токены доступа и отправлять как шаблонные, так и нешаблонные сообщения. Для более глубокого изучения представлены расширенные функции и дополнительные ресурсы.
Скачайте демонстрационное приложение
В демонстрационном приложении Jasper's Market содержатся все сообщения и код, использованные в демонстрации Jasper's Market. Вы можете использовать это демонстрационное приложение, чтобы научиться создавать приложение, которое отправляет и обрабатывает данные из WhatsApp Cloud API.
Предварительные требования
Шаг 1. Создайте новое приложение Meta Developer и настройте его с WhatsApp
Вам необходимо создать приложение для разработчиков Meta и настроить его с учетом сценария использования WhatsApp.
Нажмите на кнопку «Перейти на панель управления приложения» и следуйте приведенным ниже инструкциям, чтобы начать работу.
Если у вас уже есть приложение Meta
Если у вас нет приложения Meta
Шаг 2. Подключите ваше приложение Meta к бизнес-аккаунту WhatsApp
После создания приложения Meta вам необходимо подключить его к бизнес-аккаунту WhatsApp. Это подключение позволит вашему приложению получить доступ к облачному API WhatsApp и отправлять сообщения от имени вашей компании.
Примечание: Если вы создали новый бизнес-портфолио Meta во время создания приложения, для вас мог быть автоматически создан бизнес-аккаунт WhatsApp. Перед продолжением проверьте подключение в разделе «Настройка API».
Шаг 3. Отправьте первое шаблонное сообщение
После настройки нового приложения давайте отправим ваше первое сообщение в WhatsApp.
hello_world на выбранный вами номер телефона.Шаг 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.Шаг 6. Отправьте сообщение, не являющееся шаблоном
Когда вы ответили на предыдущее тестовое сообщение, вы запустили так называемое окно службы поддержки клиентов . Это 24-часовое окно позволяет отправлять сообщения, не являющиеся шаблонами . Теперь, когда окно службы поддержки клиентов открыто, вы можете отправить сообщение, не являющееся шаблоном, самому себе. Для этого вставьте свой тестовый идентификатор номера телефона, токен доступа пользователя системы и свой номер телефона в приведенный ниже пример кода, затем вставьте код в терминал и запустите его.
curl 'https://graph.facebook.com/v23.0/ /messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer ' \ - d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": " ", "type": "text", "text": { "body": "Привет!" } }' После успешной отправки сообщения проверьте тестовое приложение веб-перехватчика, чтобы увидеть событие веб-перехватчика, подтверждающее получение сообщения.
Шаг 7. Завершение
WhatsApp Cloud API позволяет отправлять сообщения и получать веб-хуки — это основные элементы интеграции мессенджера. Помимо этих базовых функций, API предлагает дополнительные возможности, такие как создание и управление группами, а также поддержку звонков. Чтобы узнать больше об этих расширенных возможностях, ознакомьтесь с разделом «Подробнее» ниже.