[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fdiscovery\u002Fsearch":3,"docs-tabs-chats\u002Fdiscovery\u002Fsearch":6},{"content":4,"lastmod":5},"\n## Поиск чатов по тексту\n\n`GET \u002Fv1\u002Fchats\u002Fsearch`\n\nИщет чаты и диалоги по названию или тексту сообщений. Возвращает массив объектов чатов, соответствующих поисковому запросу.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `search` | string | да | Поисковая строка. При пустом значении возвращает результаты без фильтрации |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fsearch?search=%D0%A1%D0%B4%D0%B5%D0%BB%D0%BA%D0%B0\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fsearch?search=%D0%A1%D0%B4%D0%B5%D0%BB%D0%BA%D0%B0\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst query = new URLSearchParams({ search: 'Сделка' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fsearch?${query}`, {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Найдено чатов:', data.length)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst query = new URLSearchParams({ search: 'Сделка' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fsearch?${query}`, {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `data` | array | Массив найденных чатов |\n| `data[].id` | number | Числовой ID чата |\n| `data[].name` | string | Название чата |\n| `data[].description` | string | Описание чата |\n| `data[].type` | string | Тип чата: `chat`, `general`, `openlines`, `copilot`, `channel`, `crm`, `tasks` и другие |\n| `data[].owner` | number | ID владельца чата |\n| `data[].userCounter` | number | Количество участников |\n| `data[].messageCount` | number | Общее количество сообщений |\n| `data[].counter` | number | Количество непрочитанных сообщений |\n| `data[].unreadId` | number | ID первого непрочитанного сообщения |\n| `data[].lastMessageId` | number | ID последнего сообщения |\n| `data[].entityType` | string | Тип связанной сущности (`CRM`, `TASKS`, `GENERAL` и другие) |\n| `data[].entityId` | string | ID связанной сущности |\n| `data[].entityLink` | object | Ссылка на связанную сущность |\n| `data[].entityLink.type` | string | Тип ссылки |\n| `data[].entityLink.url` | string | Относительный URL сущности на портале |\n| `data[].entityLink.id` | string | ID сущности в строковом формате |\n| `data[].dateCreate` | string | Дата создания чата (ISO 8601) |\n| `data[].role` | string | Роль текущего пользователя: `owner`, `manager`, `member` |\n| `data[].extranet` | boolean | Является ли чат экстранет-чатом |\n| `data[].permissions` | object | Права участников по операциям |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 456,\n      \"name\": \"Чат по сделке\",\n      \"description\": \"Здесь обсуждаем детали сделки\",\n      \"type\": \"crm\",\n      \"owner\": 1,\n      \"userCounter\": 3,\n      \"messageCount\": 9,\n      \"counter\": 0,\n      \"unreadId\": 0,\n      \"lastMessageId\": 1450,\n      \"entityType\": \"CRM\",\n      \"entityId\": \"DEAL|42\",\n      \"entityLink\": {\n        \"type\": \"CRM\",\n        \"url\": \"\u002Fcrm\u002Fdeal\u002Fdetails\u002F42\u002F\",\n        \"id\": \"DEAL|42\"\n      },\n      \"dateCreate\": \"2026-03-03T15:07:38+03:00\",\n      \"role\": \"owner\",\n      \"extranet\": false,\n      \"permissions\": {\n        \"manageUsersAdd\": \"member\",\n        \"manageUsersDelete\": \"manager\",\n        \"manageUi\": \"member\",\n        \"manageSettings\": \"owner\",\n        \"manageMessages\": \"member\",\n        \"canPost\": \"member\"\n      }\n    },\n    {\n      \"id\": 789,\n      \"name\": \"Обсуждение сделки №5\",\n      \"description\": null,\n      \"type\": \"chat\",\n      \"owner\": 12,\n      \"userCounter\": 2,\n      \"messageCount\": 4,\n      \"counter\": 0,\n      \"unreadId\": 0,\n      \"lastMessageId\": 890,\n      \"entityType\": \"\",\n      \"entityId\": \"\",\n      \"entityLink\": {\n        \"type\": \"\",\n        \"url\": \"\",\n        \"id\": \"\"\n      },\n      \"dateCreate\": \"2026-02-26T15:56:08+03:00\",\n      \"role\": \"member\",\n      \"extranet\": false,\n      \"permissions\": {\n        \"manageUsersAdd\": \"member\",\n        \"manageUsersDelete\": \"manager\",\n        \"manageUi\": \"member\",\n        \"manageSettings\": \"owner\",\n        \"manageMessages\": \"member\",\n        \"canPost\": \"member\"\n      }\n    }\n  ]\n}\n```\n\n## Пример ответа при ошибке\n\n403 — нет скоупа `im`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'im' scope\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов Битрикс24 |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку (подробности в `message`) |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен или вернул ошибку сервера |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- Поиск выполняется по названию чата. Соответствие сообщениям зависит от возможностей портала и не гарантировано для всех типов чатов.\n- Результаты не поддерживают пагинацию через `limit` и `offset`. При необходимости получить большее число результатов уточняйте поисковый запрос.\n- Для поиска чата конкретной CRM-сущности используйте `GET \u002Fv1\u002Fchats\u002Ffind` — он принимает `entityType` и `entityId` и возвращает точное совпадение.\n\n## Смотрите также\n\n- [Последние диалоги](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Frecent)\n- [Найти чат CRM-сущности](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Ffind)\n- [Поиск чатов](\u002Fdocs\u002Fchats\u002Fdiscovery)\n","2026-06-23",{}]