# REST API и вебхуки

Публичный REST API работает по токену проекта: `Authorization: Bearer mc_live_…`. Токен создаётся в кабинете «Интеграции» или выдаётся агенту через [Agent API](https://monochat.ru/docs/agent-api) после подтверждения email. База: `https://monochat.ru/api/public/v1`.

| Метод | Путь | Что делает |
|---|---|---|
| GET | `/me` | проект токена |
| GET | `/conversations` | список диалогов |
| GET | `/conversations/{id}` | диалог |
| GET | `/conversations/{id}/messages` | сообщения |
| POST | `/conversations/{id}/status` | сменить статус |
| GET | `/channels` | подключённые каналы (виджеты, email, Telegram, VK, MAX) |
| POST | `/forms/lead` | создать обращение из формы сайта: `{name, email, phone, message, source}` |

```bash
curl https://monochat.ru/api/public/v1/conversations -H "Authorization: Bearer $MONOCHAT_API_TOKEN"
```

Исходящие вебхуки (новый диалог, новое сообщение) настраиваются в кабинете: «Интеграции» → «Вебхук».