# happ_conversations_analyze

Глубокий анализ реальных диалогов компании: берёт последние N чатов/звонков по фильтрам, отдаёт их полные расшифровки сильной модели (gpt-4.1) вместе с задачей пользователя ДОСЛОВНО и возвращает готовый отчёт в markdown. Подходит для: «на какие вопросы ИИ отвечает плохо и как поправить промпт», «почему клиенты уходят», «найди диалоги, где просили скидку», «что чаще всего спрашивают», «как менеджеры перехватывают чаты» — любые вопросы, где надо ПРОЧИТАТЬ диалоги, а не посчитать цифры (цифры — happ_analytics). Читает только сообщения за запрошенный период (dateFrom/dateTo), а не всю историю чата; scope=full — вся история. Списывает LLM-кредиты компании по фактическим токенам. Маленькая выборка отвечается сразу; большая уходит в фоновую задачу — тогда в ответе jobId и status=queued, результат забирается happ_analysis_job_get (в копайлоте платформа продолжит разговор сама, вызывать ничего не нужно). Перед вызовом — happ_conversations_analyze_estimate. prompt — задача человека его словами, ничего не сокращай и не переформулируй; при необходимости добавь контекст (какой ассистент, что считать плохим ответом) отдельным предложением. (POST /conversation-analytics/ad-hoc)

Agent View of the PolicyLayer registry record for `happ_conversations_analyze`. HTML page: https://policylayer.com/tools/happ-ai-platform-mcp/happ-conversations-analyze

## Facts

- Tool: `happ_conversations_analyze`
- Server: Platform (`@happ-ai/platform-mcp`) — https://policylayer.com/tools/happ-ai-platform-mcp.md
- Install: `npx -y @happ-ai/platform-mcp`
- Homepage: https://www.npmjs.com/package/@happ-ai/platform-mcp
- Risk category: Read (Low risk)
- Registry record: grade F, identity unverified
- Server rate-limited: no
- Parameters: 12 (2 required)
- Recommended policy verdict: Allowed

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | Что читать: все / только чаты / только звонки (по умолчанию все) |
| `limit` | integer | no | Сколько последних диалогов взять (по умолчанию 50, максимум 200) |
| `scope` | string | no | period (по умолчанию при заданных датах) — только сообщения за период; full — вся история каждого диалога |
| `dateTo` | string | no | ISO-дата конца периода |
| `prompt` | string | yes | Задача для аналитика словами пользователя (что найти, что оценить, что предложить) |
| `search` | string | no | Поиск по контакту (имя, телефон, ник) |
| `agentId` | string | no | Только диалоги этого ассистента |
| `channel` | string | no | Канал: telegram, whatsapp, instagram, widget, phone… |
| `outcome` | string | no | Исход звонка (сужает выборку до звонков): failed — упавшие, no_answer — без ответа |
| `dateFrom` | string | no | ISO-дата начала периода |
| `companyId` | string | yes | ID компании |
| `durationMax` | integer | no | Макс. длительность звонка, сек |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "happ_conversations_analyze",
    "arguments": {
      "prompt": "<prompt>",
      "companyId": "<companyId>"
    }
  }
}
```

## Why happ_conversations_analyze is rated Low

Even though happ_conversations_analyze only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.

Risk signals: High parameter count (15 properties)

## Use case

AI agents call happ_conversations_analyze to retrieve information from Platform without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

## Recommended policy (PolicyLayer)

Verdict: **Allowed**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches Platform:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "happ_conversations_analyze": {}
  }
}
```

## Other tools on Platform (274)

- `happ_access_token_revoke` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-access-token-revoke.md
- `happ_assistant_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-assistant-delete.md
- `happ_assistant_integration_unbind` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-assistant-integration-unbind.md
- `happ_call_queue_cancel` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-call-queue-cancel.md
- `happ_call_queue_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-call-queue-delete.md
- `happ_call_reply_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-call-reply-delete.md
- `happ_chat_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-chat-delete.md
- `happ_company_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-company-delete.md
- `happ_company_leave` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-company-leave.md
- `happ_company_remove_user` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-company-remove-user.md
- `happ_crm_pull_source_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-crm-pull-source-delete.md
- `happ_folder_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-folder-delete.md
- `happ_integration_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-integration-delete.md
- `happ_invitation_revoke` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-invitation-revoke.md
- `happ_knowledge_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-knowledge-delete.md
- `happ_message_style_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-message-style-delete.md
- `happ_notification_channel_mute` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-notification-channel-mute.md
- `happ_phone_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-phone-delete.md
- `happ_playground_reset` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-playground-reset.md
- `happ_quick_reply_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-quick-reply-delete.md
- `happ_report_cancel` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-report-cancel.md
- `happ_sheets_pull_source_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-sheets-pull-source-delete.md
- `happ_test_case_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-test-case-delete.md
- `happ_text_campaign_cancel` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-text-campaign-cancel.md
- `happ_tool_delete` — Destructive — https://policylayer.com/tools/happ-ai-platform-mcp/happ-tool-delete.md
- `happ_analysis_run` — Execute — https://policylayer.com/tools/happ-ai-platform-mcp/happ-analysis-run.md
- `happ_call_queue_start` — Execute — https://policylayer.com/tools/happ-ai-platform-mcp/happ-call-queue-start.md
- `happ_crm_call_trigger_create` — Execute — https://policylayer.com/tools/happ-ai-platform-mcp/happ-crm-call-trigger-create.md
- `happ_crm_call_trigger_delete` — Execute — https://policylayer.com/tools/happ-ai-platform-mcp/happ-crm-call-trigger-delete.md
- `happ_crm_call_trigger_setup` — Execute — https://policylayer.com/tools/happ-ai-platform-mcp/happ-crm-call-trigger-setup.md
- …and 244 more: https://policylayer.com/tools/happ-ai-platform-mcp.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=happ-ai-platform-mcp · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/happ-ai-platform-mcp