Подключение WhatsApp Cloud API

WhatsApp Cloud API — это интеграция напрямую с API WhatsApp, в отличие от Business API, где вы подключаетесь через провайдера. Задача инструмента — упростить работу для бизнеса: можно получить доступ за 5-15 минут и не тратиться на покупку сервера или обращаться к провайдеру. Разработчики могут создавать приложения, используя WhatsApp более удобным способом, и повышать скорость обработки сообщений от клиентов.

Российским компаниям запрещено финансировать Meta*. Рекомендуем использовать WhatsApp Business API, где подключение происходит через провайдера.

Создание WhatsApp Cloud API

Если у вас уже есть WhatsApp Cloud API, сразу переходите к следующему разделу этой статьи и читайте инструкцию по подключению к ChatApp. Если у вас еще нет WhatsApp Cloud API, то перед подключением к ChatApp нужно проделать следующие шаги:

Шаг 1. Регистрация компании на Facebook*

Подробная инструкция по созданию Facebook Business Sute.
При наличии действующей компании создавать ещё одну не требуется.

Важно: Информация в компании должна совпадать с информацией на сайте компании:

«Название» — как указано в документах о регистрации компании. Если это ИП, юридическое название компании – ИП ФИО.

«Адрес, строка 1», «Город», «Штат/провинция/регион», «Индекс» — в полном соответствии с юридическим адресом компании, указанным в документах о регистрации.

«Номер телефона компании» — который принадлежит данному юридическому лицу.

«Сайт компании» — адрес веб-сайта компании. Домен сайта должен совпадать с доменом адреса электронной почты компании.

Шаг 2. Создать аккаунт Meta* for Developers

1. Перейдите на страницу Meta* for developers;

2. Нажмите «Начало работы»;

3. Введите адрес электронной почты;

4. Поставьте галочку, соглашаясь принимать рассылку, и нажмите «Отправить электронное письмо»;

Если вы видите ошибку «Этот электронный адрес уже подтвержден в вашем аккаунте Facebook»*, нужно ввести другой e-mail или отвязать почту от своей страницы Facebook*. Для этого:
1. Зайдите на свою страницу Facebook*;
2. Нажмите на иконку профиля;
3. В выпадающем окне выберите «Настройки и конфиденциальность» → «Настройки»;
4. В меню слева нажмите «Центр аккаунтов»;
5. Кликните на «Личная информация» → «Контактная информация»;
6. Нажмите на e-mail который хотите удалить;
7. Нажмите «Удалить электронный адрес» → «Удалить».

5. В открывшемся окне введите код, который придет на указанную вами почту. Нажмите «Продолжить»;

6. На следующем шаге выберите «Разработчик»;

7. Нажмите «Завершить регистрацию».

Шаг 3. Создать приложение

Перейдите на страницу Meta* for developers и создайте приложение. Для этого:

1. Выберите в верхнем меню «Мои приложения».

2. Нажмите «Создать приложение».

3. Введите название приложения и адрес электронной почты и нажмите «Далее».

4. В разделе «Сценарии использования» выберите «Другое» и нажмите «Далее».

5. Выберите тип приложения «Business» и нажмите «Далее».

6. Нажмите «Создание приложения».

Важно: если у вас уже создано приложение с подключенным номером и оно связано с бизнес-портфолио, к которому необходимо подключить еще один номер — не создавайте новое приложение. Это вызовет дублирование сообщений по обоим номерам, авторизованным в личном кабинете ChatApp. Подключите номер к уже созданному приложению.

Шаг 4. Создать аккаунт WhatsApp

В настройках приложения добавьте WhatsApp. Для этого:

1) В меню слева нажмите «Панель».

2) На плашке WhatsApp нажмите «Настроить».

3) В меню слева появится вкладка «WhatsApp». Откройте ее и перейдите в «Настройку API».

4) В открывшемся окне нажмите «Добавить номер телефона».

5) В открывшемся окне введите «Отображаемое имя…», часовой пояс, категорию и Описание компании.

6) Введите номер телефона. На него придет смс с кодом подтверждения.

Если вы видите ошибку «This number is registered to an existing WhatsApp account…», нужно использовать другой номер телефона или удалить аккаунт WhatsApp с вашего номера. Для этого:
1) Со своего телефона зайдите в приложение WhatsApp, к которому привязан этот номер;
2) Нажмите «Настройки» → «Учетная запись» → «Удалить учётную запись»;
3) Введите номер телефона и нажмите «Удалить учетную запись».

7) Введите код из смс и нажмите «Далее»;

Шаг 5. Создать системного пользователя

1) В настройках компании FBM перейдите в меню «Системные пользователи».

2) Введите имя системного пользователя, выберите роль «Администратор» и нажмите «Создать системного пользователя».

3) Далее необходимо дать системному пользователю доступ к приложению.

4) Выберите приложение, которое было создано на 3 шаге и выдайте полный контроль.

Шаг 6. Создать маркер доступа (токен)

Для создания маркера доступа:

1) Перейдите в меню «Системные пользователи», выберите системного пользователя и нажмите «Создать новый маркер».

2) Выберите приложение.

3) Срок действия маркера - Никогда

4) Выберите разрешения как на скриншоте.

5) В следующем окне созданного маркера скопируйте и сохрание токен.

Шаг 7. Установить Webhook

1) Перейдите на страницу Meta for developers и создайте приложение, для этого выберите в верхнем меню «Мои приложения».

2) Перейдите в меню «Webhook».

3) Нажмите на User и выберите Whatsapp Business Account.

4) Вставьте в поле «URL обратного вызова» ссылку https://api.chatapp.online/v1/webhooks/caWhatsApp

5) Введите в поле «Маркер подтверждения» v8WxwE

6) Включите опцию «messages».

Шаг 8. Подключение оплаты. Только для стран СНГ и Запада

1) Перейдите в «Настройки API» (см. Шаг 4);

2) Внизу открывшейся страницы нажмите «Добавить способ оплаты»;

3) Нажмите «Настройки оплаты» → «Добавить способ оплаты»;

4) Выберите страну, валюту и часовой пояс;

5) Введите данные своей карты. Нажмите «Сохранить».

Запуск номера WhatsApp

В некоторых случаях номер может попасть в статус «Рассмотрение». Чтобы его активировать, выполните следующие действия:

Перейдите в «Настройки API» (см. Шаг 4);
Нажмите кнопку «Сгенерировать маркер доступа»

3. Пройдите все этапы в новом окне, выбрав аккаунт, который был подключен на Шаге 4.

4. После успешной генерации маркера отправьте тестовое сообщение, вписав личный номер телефона на котором имеется WhatsApp.

Даже если вышла ошибка при отправке тестового сообщения, ничего страшного. Вы активировали номер!

Подключение второго и последующих номеров

Подключение дополнительного номера происходит без создания нового приложения в кабинете разработчика Meta* for developers .

Перейдите в созданное приложение;
Добавьте номер телефона см. Шаг 4;
Добавьте способ оплаты см. Шаг 8;
Авторизуйте номер в линии ChatApp.

В случае утери System user token, сгенерированного при первоначальном подключении номера, необходимо обратиться в службу технической поддержки ChatApp, предоставив идентификатор линии (ID), к которой привязан первый номер WhatsApp Cloud API.

Подключение WhatsApp Cloud API в кабинете ChatApp

1) Купите линию или запросите демо.

2) В левом меню выберите «Выбранная компания» и перейдите в настройки линии.

3) Выберите канал WhatsApp Cloud API, нажмите «Привязать».

4) Введите данные:

WhatsApp Business account ID и Phone number ID: Перейдите в «Настройки API» (см. Шаг 4), под подключенным номером находятся данные значения.

System user token: Сгенерирован на Шаге 6.

Подключение готово!

Подключение готово

Теперь можно перейти в Dialogs.pro и написать клиенту.
1. Нажмите на «Новый диалог» — «Новый диалог».

2. Выберите WhatsApp Business.
3. Выберите мессенджер WhatsApp Cloud API.
4. Выберите линию.
5. Введите телефон клиента.
6. Выберите шаблон отправки сообщения.
7. Нажмите «Начать диалог».

*Facebook принадлежит Meta, признанной в Российской Федерации экстремистской организацией

Оставить заявку на услуги интегратора