> 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="https://4089339230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSciXxWqmoBx13cWpl1JJ%2Fuploads%2FVKg9IubQ3LX4q71KrF23%2FsWABA1.png?alt=media&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;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&amp;token=d47c1792-9207-4d1a-885a-4a55232cc9bd" alt=""><figcaption></figcaption></figure>

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