⚙️ Подключение через REST API
API коннектор позволяет интегрировать WazzaBee с любой вашей системой — CRM, ERP, сайтом, ботом или мобильным приложением. Через REST API можно отправлять и получать сообщения, управлять контактами и получать уведомления через вебхуки.
🔌 Как подключить
- Перейдите в «Коннекторы»
- Нажмите на карточку «API»
- Нажмите кнопку «Подключить»
- Подождите несколько секунд — система автоматически создаст интеграцию и сгенерирует API-ключ
- Появится ✅ «Интеграция подключена»
- Нажмите «Перейти к настройкам»
Никаких дополнительных данных вводить не нужно — всё генерируется автоматически!
🔑 API-ключ
После подключения вам доступен API-ключ — уникальный токен для авторизации запросов.
Как получить ключ
- В настройках API-коннектора найдите карточку «Ключ API»
- Нажмите иконку 👁️ (глаз) чтобы показать ключ
- Нажмите «Копировать» — ключ скопируется в буфер обмена
Важно: Никогда не делитесь API-ключом! Если ключ скомпрометирован — нажмите «Обновить» для генерации нового. Старый ключ перестанет работать.
📡 Привязка линий связи
Выберите какие мессенджеры будут доступны через API:
- В настройках найдите карточку «Линии связи»
- Вы увидите список ваших подключённых мессенджеров
- Для каждого — переключатель (вкл/выкл)
- Включите те линии, которые хотите использовать через API
📚 Как использовать API
Все запросы используют Bearer-токен в заголовке:
Authorization: Bearer ВАШ_API_КЛЮЧДоступные методы
| Метод | URL | Описание |
|---|---|---|
| GET | /v1/account | Информация об аккаунте |
| GET | /v1/channels | Список привязанных линий |
| GET | /v1/contacts | Список контактов |
| GET | /v1/conversations | Список диалогов |
| POST | /v1/messages/send | Отправка сообщения |
| PATCH | /v1/webhooks | Регистрация вебхука |
| DELETE | /v1/webhooks | Удаление вебхука |
Подробная документация: API-документация →
🔔 Вебхуки — получение событий
Настройте вебхуки чтобы получать уведомления о новых сообщениях в реальном времени:
| Подписка | Что приходит |
|---|---|
messages_incoming | Входящие сообщения от клиентов |
messages_outgoing | Исходящие сообщения (отправленные вами) |
contactsAndDealsCreation | Создание новых контактов и диалогов |
⚠️ Управление
- «Отключить» — API-ключ перестанет работать, но настройки сохранятся
- «Удалить» — полное удаление (сначала нужно отключить)
- «Обновить ключ» — генерация нового ключа (старый перестаёт работать)
Нужна помощь с интеграцией? Напишите в поддержку — поможем настроить!