[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fdiscovery\u002Ffind":3,"docs-tabs-chats\u002Fdiscovery\u002Ffind":6},{"content":4,"lastmod":5},"## Найти чат CRM-сущности\n\n`GET \u002Fv1\u002Fchats\u002Ffind`\n\nВозвращает идентификатор чата, привязанного к указанной CRM-сущности. Когда чата для сущности нет, возвращает `data: null` — не ошибку.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `entityType` | string | да | Тип CRM-объекта. Пример: `CRM` |\n| `entityId` | string | да | Составной идентификатор сущности. Формат: `\u003CТИП>\\|\u003CID>`. Пример: `DEAL\\|123` |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Ffind?entityType=CRM&entityId=DEAL%7C123\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Ffind?entityType=CRM&entityId=DEAL%7C123\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst params = new URLSearchParams({ entityType: 'CRM', entityId: 'DEAL|123' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Ffind?${params}`, {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\n\u002F\u002F data — объект { id } или null, если чат не создан\nconsole.log('ID чата:', data?.id ?? 'не найден')\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst params = new URLSearchParams({ entityType: 'CRM', entityId: 'DEAL|123' })\nconst res = await fetch(`https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Ffind?${params}`, {\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| `success` | boolean | Всегда `true` при успехе |\n| `data` | object \\| null | Объект `{ id }` с идентификатором чата, или `null` если чат не создан |\n| `data.id` | number | Идентификатор чата. Используется в `GET \u002Fv1\u002Fchats\u002F:dialogId` |\n\n## Пример ответа\n\nЧат найден:\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 456\n  }\n}\n```\n\nЧат для сущности не создан:\n\n```json\n{\n  \"success\": true,\n  \"data\": null\n}\n```\n\n## Пример ответа при ошибке\n\n400 — не переданы обязательные параметры:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"MISSING_PARAMS\",\n    \"message\": \"Required query params: entityType (e.g. \\\"CRM\\\") and entityId (e.g. \\\"DEAL|123\\\")\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 400 | `MISSING_PARAMS` | Не передан `entityType` или `entityId` |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- Параметр `entityId` передаётся в URL-кодировке: символ `|` кодируется как `%7C`. В JavaScript `URLSearchParams` выполняет кодирование автоматически.\n- Перед обращением к полю `id` проверяйте `data !== null`: у сущности без чата ответ успешный, но `data` пустой.\n\n## Смотрите также\n\n- [Поиск чатов](\u002Fdocs\u002Fchats\u002Fdiscovery)\n- [Информация о диалоге](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Fget)\n- [Последние диалоги](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Frecent)\n- [Сообщения](\u002Fdocs\u002Fchats\u002Fmessages\u002Flist)\n","2026-06-16",{}]