# 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="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FVKg9IubQ3LX4q71KrF23%2FsWABA1.png?alt=media&#x26;token=c36f2cc6-d558-47a8-bd56-05040a4396c0" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FQsmvf4jsqRC1x17o9Ug0%2FsWABA11.jpg?alt=media&#x26;token=e5eeaf3b-eb9f-4140-a596-6e306746bf05" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2Fl666LCqi8wGGAD94KObI%2FsWABA12.png?alt=media&#x26;token=d6ada5c4-3ccb-476b-9588-6d3249fc7330" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2F4LbK7HWo8nSWtp1jYLMK%2FsWABA3.png?alt=media&#x26;token=42ce04e5-fc39-4086-b311-c7795e2b067a" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FzLPmMrQ2BByqlCZbuChL%2FsWABA13.png?alt=media&#x26;token=475e1cc9-250c-406c-aa07-77dab203e393" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FV3n50caHECvSAMAvtZ1F%2FsWABA4.png?alt=media&#x26;token=750cd556-f287-4982-99ef-d15e08a909d4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2F08FyOxxFJL641NckHHU3%2FsWABA21.png?alt=media&#x26;token=c2175f90-0766-4781-9d04-742356eae2f8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FxoN2AdHkHW3iFUDgw8wD%2FsWABA22.png?alt=media&#x26;token=25a5ad12-e6fe-4824-a56d-7771db7f58b8" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2F0USpQuP6X3AkvTcRwyjw%2FsWABA23.png?alt=media&#x26;token=2cfdc9be-4bdf-44b4-bb4f-b74cf6873eb7" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FgTYHUSbeXjao6s1bPKxu%2FsWABA24.png?alt=media&#x26;token=a094c977-4828-4986-a469-c85c7a5f67bb" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FNhy5ZI0SajQAFroSqtm1%2FsWABA38.png?alt=media&#x26;token=741f3b41-8b51-4313-9d69-d01820f51eb8" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FtALIwTm1xq8ClDw9Dzqq%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-06-12%20%D0%B2%2009.35.07.png?alt=media&#x26;token=aca97b24-f252-4cd4-a5c7-bdc62b008fce" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FWh9HDCOUQAyluQPjE7Kt%2FsWABA25.png?alt=media&#x26;token=d91ea519-469d-4a4d-a515-8d0552069f1c" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FLyTUldXy8sVRriYqTN6S%2FsWABA26.png?alt=media&#x26;token=90e53bfa-82e9-490d-9caf-42984396dbed" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2Fr1d97aAcS0oH7fZmeVYy%2FsWABA27.png?alt=media&#x26;token=34f216b1-4255-48e1-9608-cc631c504c6d" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FxGtJEjsyFBSG0AQA8Aj3%2FsWABA28.png?alt=media&#x26;token=755c24dd-9719-4f59-b27b-4f35fc49ae75" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FQb59YX4UZiDuRPeZNRc9%2FsWABA29.png?alt=media&#x26;token=aa20e20c-16bc-4199-a2d6-4c0bb529e198" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2Fy2eK795112U5yHSam0YB%2FsWABA30.png?alt=media&#x26;token=75e1d63a-5277-4133-b7fe-279ce10bb628" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FKQH5aXKYsw8h8HJ9aGer%2FsWABA31.png?alt=media&#x26;token=71ca42cd-c1fa-4cc7-9344-a7872423489d" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2Fz9gYe7NSumoF8lG0zNGW%2FsWABA32.jpg?alt=media&#x26;token=eb0d4e88-d983-4b26-bf5d-e449e85060a6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FTvI9V96tyiprw52KmiVq%2FsWABA33.png?alt=media&#x26;token=8d21918c-459c-4909-bfe6-d4de32a30adb" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2Fri6yH9gfxGq1ANvtHJa2%2FsWABA34.png?alt=media&#x26;token=f1a8681c-a463-4b71-8c23-ab232997af58" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FVQLb3ZlXYO9mpq27r8ml%2FsWABA35.png?alt=media&#x26;token=48cf1bcf-4fef-4178-8075-988656ddceaa" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FZAhCdopv00veZtyvoP9S%2FsWABA36.png?alt=media&#x26;token=bea183cd-4785-43d8-b029-9c3c020ae1c6" 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="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FcpYxQbVkdjBYe2frSe9o%2FsWABA37.png?alt=media&#x26;token=d7929636-f5a2-4efc-959f-b0ebc21a8abf" 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="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2F0xKnIgYrHbCr0Bp0jsoK%2FsWABa41.png?alt=media&#x26;token=ba1dfab2-955b-4a93-910b-0218d4eae87a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FoRou6zTENXM1V2GVRub9%2FsWABa42.png?alt=media&#x26;token=d47c1792-9207-4d1a-885a-4a55232cc9bd" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.selarti.com/vneshnie-integracii/whatsapp-business-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.