Если вы разрабатываете приложение, которое будет использоваться в других компаниях, ознакомьтесь с нашими руководствами Начало работы: информация для поставщиков технологий или Начало работы: информация для партнеров по решениям.
Начало работы
Это руководство поможет вам отправить и получить первое сообщение с использованием облачного API. Вы также узнаете, как настраивать Webhooks для использования с примером приложения.
Это руководство предназначено для людей, которые разрабатывают приложения для себя или для своей организации. Если вы разрабатываете приложение, которое будет использоваться другими компаниями, ознакомьтесь с нашими документами Начало работы: информация для партнеров по решениям и Начало работы: информация для поставщиков технологий.
Прежде чем начать
Вам понадобятся:
- аккаунт разработчика Meta (подробнее о регистрации в качестве разработчика Meta);
- приложение для бизнеса (подробнее о создании приложений). Если вам не видно, как создать бизнес-приложение, выберите Другие > Далее > Бизнес.
Шаг 1. Добавление продукта WhatsApp в приложение
Если вы создали новое приложение, на этом этапе вам будет предложено добавить продукты в приложение. Прокрутите вниз и в разделе WhatsApp выберите Настроить. Либо выберите свое приложение на панели Мои приложения, после чего вы сможете повторно выполнить те же инструкции, чтобы добавить WhatsApp в приложение.
Если у вас есть бизнес-аккаунт Meta, вам будет предложено подключить его при добавлении WhatsApp в приложение. Если у вас нет бизнес-аккаунта Meta, будут отображены инструкции, которые помогут создать его. После подключения бизнес-аккаунта Meta к приложению вы сможете начать тестирование.
После добавления WhatsApp в ваше приложение:
- Вам будет предложено создать бизнес-аккаунт Meta, если у вас его нет.
- Для вас будет автоматически создан тестовый аккаунт WhatsApp Business. Этот аккаунт имеет некоторые ограничения и должен использоваться для тестирования и разработки, поскольку вы не платите за сообщения.
- Будет создан тестовый номер телефона, связанный с вашим аккаунтом WhatsApp Business. Этот номер позволяет отправлять бесплатные сообщения максимум на пять номеров телефонов получателей.
- Будет создан набор предварительно утвержденных шаблонов сообщений.
Шаг 2. Добавление номера получателя
Добавьте действительный номер WhatsApp, на который вы сможете отправить тестовые сообщения.
На панели приложений в меню слева выберите WhatsApp > Настройка API. В разделе Отправка и получение сообщений выберите поле Кому, а затем — Управление списком номеров телефонов.
В качестве получателя можно добавить любой действительный номер WhatsApp. На выбранный номер получателя в WhatsApp будет отправлен код подтверждения, предназначенный для проверки номера.
После проверки номера получателя его следует выбрать в поле Кому. Повторите эти действия, если необходимо добавить еще одного получателя (всего не более 5).
Шаг 3. Отправка тестового сообщения
Используя предварительно утвержденный шаблон hello_world, отправьте сообщение на выбранный номер получателя.
На панели WhatsApp > Настройка API:
- Убедитесь, что в поле От указан тестовый номер телефона вашей компании.
- Убедитесь, что в поле Кому указан номер телефона получателя, на который нужно отправить сообщение. Если вы указали несколько номеров, можно одновременно отправить несколько сообщений.
- На панели Отправка сообщений с помощью API нажмите кнопку Отправить сообщение.
Либо вы можете скопировать команду cURL, затем вставить ее в новое окно терминала и выполнить.
Обратите внимание: код означает, что вы отправляете сообщение с шаблоном (”type”:”template”) и указываете для использования определенный шаблон (”name”:”hello_world”).
Шаг 4. Клонирование нашего примера приложения и настройка Webhooks
Webhooks позволяют в режиме реального времени получать уведомления HTTP об изменениях определенных объектов. В WhatsApp вы можете получать уведомления Webhooks о разных событиях в вашем приложении, таких как доставка или прочтение сообщения, и даже об изменениях в аккаунте.
Для просмотра контента Webhooks добавьте URL обратного вызова. Следуйте нашему руководству Тестовый URL обратного вызова для тестирования Webhooks, чтобы клонировать наш пример приложения, которое принимает уведомления Webhooks и отображает содержащиеся в них полезные данные в формате JSON на экране.
После настройки Webhooks повторно отправьте сообщение с шаблоном, а затем ответьте на него. Вы должны увидеть четыре отдельных уведомления Webhooks: сообщение отправлено, доставлено и прочитано, а также контент входящего сообщения. Отлично!
Шаг 5. Добавление настоящего номера компании (необязательно)
При наличии тестового номера компании и тестового аккаунта WhatsApp Business вы можете приступить к разработке приложения. При использовании этих тестовых компонентов вы не платите за отправку сообщений, поскольку занимаетесь разработкой своего приложения.
Как только все будет готово к отправке сообщений клиентам, вы можете добавить настоящий номер компании на панели Настройка API и создать настоящий аккаунт WhatsApp Business.