# OneBox

Подключите OneBox, чтобы агент находил клиентов, создавал процессы и логировал звонки

> Full REST + WebSocket API reference: https://api.happ.tools/reference

OneBox — CRM/ERP для продаж и заказов. После подключения агент находит клиента и его последний процесс по телефону, создаёт процессы (заказы или лиды), синхронизирует каталог и логирует звонки.

## Перед началом [#before-you-start]

* **Приложения «API v2» и «API»**, установленные из магазина приложений OneBox.
* **Отдельный сотрудник** для агента — OneBox допускает одну API-сессию на пользователя, и каждая сессия занимает одну пользовательскую лицензию. Сгенерируйте ключ сотрудника на странице **API v2 keys**.

## Подключение [#connect]

1. **Интеграции** > **Подключить интеграцию** > **OneBox**.
2. Заполните адрес OneBox, логин сотрудника и пароль REST API, затем нажмите **Подключить**.

| Поле             | Значение                                |
| ---------------- | --------------------------------------- |
| Адрес OneBox     | например `mybox.crm-onebox.com`         |
| Логин сотрудника | Логин отдельного API-сотрудника         |
| Пароль REST API  | Ключ сотрудника со страницы API v2 keys |

## После подключения [#after-connecting]

На карточке видны логин и адрес вашего OneBox.

**Я согласен, что Happ получает и хранит данные этой CRM** — необязательно. Если галочка стоит, Happ синхронизирует контакты, сделки, лиды и активности; если нет — ничего не хранится, и интеграция работает напрямую (инструменты агента, заметки о звонках). Отключение отзывает согласие и удаляет скопированные данные.

В меню карточки также есть **Звонки по событиям CRM**, **Скопировать адрес вебхука**, **Перевыпустить вебхук** и **Логи вебхука** — для звонков, которые запускаются событиями CRM.

Что агенту разрешено делать, задаётся для каждого агента отдельно: **Агенты** > агент > **Интеграции** > настройки интеграции.

* **Поиск клиента** — найти клиента по телефону по ходу разговора
* **Создание процессов** — с бизнес-процессом и статусом (обязательно)
* **Каталог** — искать товары во время ответа
* **Логирование звонков** — записывать каждый звонок в CRM, при желании с полным транскриптом

**API:** [api.happ.tools/reference](https://api.happ.tools/reference)

## Дальше [#next]

* [CRM](/docs/integrations/crm) — все CRM-интеграции
* [Инструменты](/docs/agents/tools) — что агент вызывает по ходу разговора