> For the complete documentation index, see [llms.txt](https://manual.selarti.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.selarti.com/vneshnie-integracii/whatsapp-business-api.md).

# WhatsApp business API

*В этой статье расскажем о том, как подключить канал WhatsApp Business API (WABA).* 

Для подключения потребуется: 

* Личный аккаунт [Facebook](https://facebook.com/)\*.
* Доступ к зарегистрированному аккаунту [Facebook Business Manager](https://business.facebook.com/)\*.
* Номер телефона, подключенный к WhatsApp Business. Номер должен быть активным, принимать звонки и SMS. 

{% hint style="warning" %}
Перед подключением убедитесь в отсутствии проблем с [рекламным аккаунтом в Facebook](https://business.facebook.com/business-support-home/)\*.  
{% endhint %}

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

Перед подключением WABA проверьте соответствие вашего сайта требованиям Meta\*. 

Для успешного прохождения проверки в подвале сайта должны быть:

* **Ссылка на политику конфиденциальности или обработки персональных данных.** Важно, чтобы там был пункт о том, что вы можете отправлять клиентам рассылки, а клиенты могут от них отписаться. Формулировка может быть иной.

<details>

<summary>Пример формулировки</summary>

Компания имеет право отправлять пользователю уведомления о новых продуктах и услугах, специальных предложениях и различных событиях. Пользователь может отказаться от получения сообщений, направив компании письмо на адрес электронной почты <pochta@yandex.ru> с пометкой «Отказ от уведомлений».

</details>

* **Юридическое название компании.** Оно должно совпадать с указанным в бизнес-портфолио Meta\* в [Facebook\* Business Manager](https://business.facebook.com/select/?next=https%3A%2F%2Fbusiness.facebook.com%2Fsettings%2Finfo\&ext=1719569849\&hash=Afngqy8QoolXzCGMaaQBWbLfDhtLbwAUI1OPQL39uJC48w). Несовпадение приведёт к блокировке аккаунта.&#x20;
* **Юридический адрес.** Он тоже должен совпадать с указанным в бизнес-портфолио Meta\* в [Facebook\* Business Manager](https://business.facebook.com/select/?next=https%3A%2F%2Fbusiness.facebook.com%2Fsettings%2Finfo\&ext=1719569849\&hash=Afngqy8QoolXzCGMaaQBWbLfDhtLbwAUI1OPQL39uJC48w). Несовпадение приведёт к блокировке аккаунта.&#x20;

{% hint style="warning" %}
Обязательно проверьте все пункты, описанные выше, иначе ваш аккаунт может быть заблокирован!
{% endhint %}

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

### Шаг 1. Создание аккаунта Meta\* for Developers

1. Перейдите на страницу [Meta\* for developers](https://developers.facebook.com/).
2. В верхнем меню нажмите *«Начало работы»*.
3. Нажмите *«Продолжить»*.
4. Введите номер телефона.
5. Введите код из SMS. Нажмите *«Продолжить»*.&#x20;
6. Введите адрес электронной почты.
7. Поставьте галочку, соглашаясь принимать рассылку, и нажмите *«Отправить электронное письмо»*.
8. В открывшемся окне введите код, который придет на указанную вами почту. Нажмите *«Продолжить»*.
9. На следующем шаге выберите *«Разработчик»*.
10. Нажмите *«Завершить регистрацию»*.

### Шаг 2. Создание приложения

Перейдите на [страницу](https://developers.facebook.com/apps/creation/). Выберите бизнес-портфолио, к которому вы хотите подключить приложение, нажмите «*Далее»*.

<figure><img src="/files/U1e2nBvetTqtSgs4dfvQ" alt=""><figcaption></figcaption></figure>

На следующем шаге выберите пункт *«Другое»* и нажмите *«Далее»*.

<figure><img src="/files/oZBYSJS1dieh7Vf7tWXT" alt=""><figcaption></figcaption></figure>

Затем выберите тип приложения «*Компания».*

<figure><img src="/files/t5kHQdjfqOAHgA52de63" alt=""><figcaption></figcaption></figure>

Введите название приложения и вашу контактную почту. Нажмите «*Создание приложения».*&#x20;

<figure><img src="/files/Ho2q6vtkyk1M6TWqSx25" alt=""><figcaption></figcaption></figure>

### Шаг 3. Создайте аккаунт WhatsApp

В списке приложений найдите WhatsApp и нажмите *«Настроить»*.

<figure><img src="/files/S673CGdoAek8da0i7ebq" alt=""><figcaption></figcaption></figure>

В выпадающем списке выберите бизнес-портофолио и нажмите *«Продолжить».*

<figure><img src="/files/gZxJZmSEipG6Nh8soRqh" alt=""><figcaption></figcaption></figure>

В открывшихся настройках, в разделе «Обмен сообщениями» нажмите на выпадающий список с номерами и выберите «*+ Добавить номер телефона».*

<figure><img src="/files/YT5ojeBRwDuhwjCG3CNI" alt=""><figcaption></figcaption></figure>

Для добавления номера введите отображаемое имя, выберите часовой пояс и категорию, по желанию добавьте описание компании, затем нажмите *«Далее»*.

<figure><img src="/files/VgAVbjmXjTLWmpO4OtlO" alt=""><figcaption></figcaption></figure>

Введите номер телефона, выберите подтверждение через SMS и нажмите *«Далее»*.

<figure><img src="/files/7lnClByIN3rvIKiKEy1Q" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Если вы видите ошибку «This number is registered to an existing WhatsApp account…», используйте другой номер или удалите аккаунт WhatsApp привязанный к данному номеру телефона.
{% endhint %}

Введите код подтверждения из SMS и нажмите *«Далее»*.&#x20;

<figure><img src="/files/hyFabqTU4qAeWaBCDWIo" alt=""><figcaption></figcaption></figure>

После добавления номера сохраните ID номера телефона и ID аккаунта, они понадобятся при настройке в личном кабинете Selarti.&#x20;

<figure><img src="/files/MSVtZJrux1AZzF5a8sEH" alt=""><figcaption></figcaption></figure>

### Шаг 4. Подключение Webhook

В личном кабинете Meta\* for Developers, в верхнем правом углу перейдите на страницу *«*[*Мои приложения*](https://developers.facebook.com/apps)*»*.

<figure><img src="/files/1dWGmvThSLV622fuVp5u" alt=""><figcaption></figcaption></figure>

Выберите созданное приложение.&#x20;

Слева перейдите в *WhatsApp > Настройка*. В разделе «Webhook» нажмите *«Редактировать»*.&#x20;

<figure><img src="/files/W2rh0T0HiQdKEBvpAv3y" alt=""><figcaption></figcaption></figure>

Заполните форму:

* В поле «URL обратного вызова» вставьте ссылку: <https://api.selarti.com/waba>.&#x20;
* В поле «Подтверждение маркера» введите: selarti\_is\_the\_best\_service.

Нажмите «*Подтвердить и сохранить».*&#x20;

<figure><img src="/files/FexyrLN5gRWzKYbQPCb8" alt=""><figcaption></figcaption></figure>

В том же разделе нажмите *«Настроить»*, чтобы отредактировать поля Webhook.&#x20;

<figure><img src="/files/6y3vGO2VHCUdqliwNYpb" alt=""><figcaption></figcaption></figure>

В открывшемся окне поставьте чекбокс напротив *«messages»,* затем нажмите *«Готово».*

<figure><img src="/files/0Kwd6I1f1bzSUehboWQP" alt=""><figcaption></figcaption></figure>

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

В разделе *«*[*Настройки компании*](https://business.facebook.com/settings/)*»* перейдите в *Пользователи > Системные пользователи* и нажмите *«Добавить»*.

<figure><img src="/files/hSLYWB09qm0PGKzDu763" alt=""><figcaption></figcaption></figure>

Введите имя системного пользователя, выберите из выпадающего списка роль *«Admin»* и нажмите *«Create system user»*.

<figure><img src="/files/rb750SCxQW3CDNE69ZQB" alt=""><figcaption></figcaption></figure>

### Шаг 6. Создание маркера доступа

В разделе *«*[*Настройки компании*](https://business.facebook.com/settings/)*»* перейдите в *Пользователи > Системные пользователи*. Выберите ранее созданного пользователя и нажмите *«Создать новый маркер»*.

<figure><img src="/files/NCbytMUAZ8tQcWXMUeAj" alt=""><figcaption></figcaption></figure>

Выберите приложение из выпадающего списка, срок действия метки и разрешения:&#x20;

* whatsapp\_business\_management.
* whatsapp\_business\_messaging.

Нажмите *«Сгенерировать маркер»*.

<figure><img src="/files/8kiWZbBZlJ61Yt9Wx0Y9" alt=""><figcaption></figcaption></figure>

Откроется окно с токеном. Скопируйте его и нажмите *«OK»*.

<figure><img src="/files/Bin9yLQoroWc3df5UuTE" alt=""><figcaption></figcaption></figure>

### Шаг 7. Подключение оплаты

В [настройках компании](https://business.facebook.com/settings/) перейдите в *Аккаунты > Аккаунты WhatsApp*.  Выберите нужный аккаунт в списке и нажмите *«Настройки оплаты»*.&#x20;

<figure><img src="/files/z8nKpiLHOKksVmeuQRsu" alt=""><figcaption></figcaption></figure>

Выберите страну, валюту и часовой пояс, нажмите *«Далее»*.

<figure><img src="/files/ZYsgfIcFp9NrIZmI22Xx" alt=""><figcaption></figcaption></figure>

Введите данные карты, нажмите *«Сохранить»*.

<figure><img src="/files/o4IxOhPYe8gQb5pniiyZ" alt=""><figcaption></figcaption></figure>

## Подключение WhatsApp business API в кабинете Selarti <a href="#podklyuchenie-whatsapp-cloud-api-v-kabinete-chatapp" id="podklyuchenie-whatsapp-cloud-api-v-kabinete-chatapp"></a>

Откройте личный кабинет Selarti, перейдите в раздел *«*[***Каналы***](https://selarti.com/panel?menu=channels)***»*** и нажмите *«Добавить канал»*.

<figure><img src="/files/HmLUvOcjOJ6yGP1uEorg" alt=""><figcaption></figcaption></figure>

В выпадающем меню выберите тип канала *«WhatsApp business API»* и заполните поля:&#x20;

* **Service user access token** — маркер токена из [шага 6](#shag-6.-sozdanie-markera-dostupa).&#x20;
* **WhatsApp phone ID** — ID номера телефона из [шага 3](#shag-3.-sozdaite-akkaunt-whatsapp).&#x20;
* **WhatsApp Business ID** — ID аккаунта из [шага 3](#shag-3.-sozdaite-akkaunt-whatsapp).&#x20;

Нажмите *«Get Template».*

<figure><img src="/files/BCy5syaX0XH1DPTycBEZ" alt=""><figcaption></figcaption></figure>

Выберите шаблон в поле *«Select template»* — для работы только по входящим можно выбрать шаблон hello\_world.&#x20;

Для работы по исходящим нужно создать отдельный шаблон в личном кабинете [Meta\* for developers](https://developers.facebook.com/).

После выбора шаблона нажмите *«Добавить канал».*

<figure><img src="/files/ab9QTlGeMgyFxh63ubWc" alt=""><figcaption></figcaption></figure>

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