ChatPlace Marketing & Sales — создание элементов воронки
Инструмент для создания/обновления двух типов сущностей в ChatPlace:
- Кодовые слова (Instagram keywords) — автоматика DM + публичный ответ под комментом
- AI-агент-продажник — единая сущность, отвечает в DM за клиента, ведёт к продаже воркшопа
Note: этот скилл покрывает только создание сущностей (keywords + AI-агент). Аналитика, реестры ссылок, сквозные отчёты — вне скоупа, делайте своим инструментом.
Главные правила (выучить до кода)
Правило 1: кодовое слово = 4 элемента за один проход
- Automation (
automations_quick_setup) — DM-воронка: welcome + URL-кнопка
- Comment auto-reply rule (
comments_create) — публичный ответ под комментом
- Case variants — минимум 7 форм: ALL_CAPS, Capitalized, lowercase, CamelCase + кириллица. equals case-sensitive.
- Оба языка (если переводимо): EN + RU. Пример: workshop, Workshop, WORKSHOP, WorkShop, воркшоп, Воркшоп, ВОРКШОП.
Почему сразу 4: без comment rule под постом молчание (теряется соцдоказательство). Без case variants триггер не ловит «Workshop» с большой.
Правило 2: AI-агент создаётся ТОЛЬКО через UI
Все ai_agent_* падают с "AI assistant not exists" пока агент не создан через UI ChatPlace. Увидел — попроси владельца аккаунта: ChatPlace → бот → AI-агент → Создать.
Правило 3: AI Pack должен быть оплачен
Публикация падает с "You have no active ChatPlace AI package" без AI-пакета. Попроси владельца: Connect AI tools → AI agent → оплата.
Правило 4: без Whisper-опечаток в продакшне
Перед заливом текстов (KB, шаблоны, rules) — grep на все Whisper-варианты имени клиента и заменять на каноническое. Voice transcripts often misspell names.
Connection
- MCP endpoint:
https://mcp.chatplace.io/mcp
- Auth:
Authorization: Bearer $CHATPLACE_API_KEY (НЕ x-api-key — Cloudflare 403)
- Key path:
~/.secrets/chatplace/env
- Bot (@your_instagram Instagram):
YOUR_BOT_ID
source ~/.secrets/chatplace/env
Workflow 1: создание кодового слова
Полный playbook — references/keyword-workflow.md. Короткая версия:
- Invite link — Telegram Bot API
createChatInviteLink + сохранить в свой реестр источников.
- Tag (
tags_create, name=kw_<keyword>) для сегментации.
- Automation (
automations_quick_setup): botId, commentEquals=7+ variants, messageEquals=те же, welcome + URL-кнопка.
- Action (
automations_actions_setup) — добавить тег на первое сообщение.
- Comment auto-reply rule (
comments_create): type=equals, startMessages=те же 7+, answers=3+ ротации без эмодзи и ссылок.
- Тест — вручную под постом и в DM.
Существующие keywords держите в своём реестре (БД / spreadsheet).
Workflow 2: AI-агент-продажник
Полный playbook — references/ai-agent-workflow.md.
Архитектура
| Компонент |
API |
Назначение |
| Global rules |
ai_agent_update_global_rules |
Тон, миссия, ссылки, запреты — на ВСЕ ответы |
| Topic rules |
ai_agent_topic_rules_add |
Ситуационные блоки |
| Knowledge base |
ai_agent_knowledge_base_add |
Q&A пары |
| Settings |
ai_agent_update_settings |
Задержка, silence, DM/comments on/off, auto-retrain |
| Publish |
ai_agent_publish |
Активация (требует AI Pack) |
Порядок настройки
ai_agent_status — проверить что создан.ai_agent_update_global_rules с enabled:true.ai_agent_update_settings — стартовый набор:
- answerOnMessageEnabled: true
- answerOnCommentEnabled: false (комменты — после обкатки)
- generateButtons: true
- autoRetrainOnDialogs: true
- responseDelay: 45 + responseDelayEnabled: true
- silenceAfterHumanReply: 240 + silenceAfterHumanReplyEnabled: true
- 4 topic rules через
ai_agent_topic_rules_add: Тёплый лид / Холодный интерес / Бесплатные гайды / Возражения.
- 30 Q&A через
ai_agent_knowledge_base_add пачкой.
- Тест на 5 сценариях через
ai_agent_test_question.
- Драфт владельцу на апрув (с примерами реальных ответов).
ai_agent_publish после явного апрува владельца.
Правила контента (Evergreen)
- НИКОГДА не называй конкретные даты старта. Пиши «3 дня», «3-дневный», «за 3 дня».
- ВСЕГДА UTM:
https://yourdomain.com/lp/?utm_source=instagram&utm_medium=chatplace&utm_campaign=agent. Суффиксы: agent_warm, agent_guides, agent_objection.
- НЕ шли
your-internal-url.example — внутренняя ссылка.
- Холодный канал:
https://t.me/+YOUR_CHANNEL_INVITE (your Telegram channel; track in your subscriber DB).
- Гайды:
https://yourdomain.com/guides — можно клиентам.
- Тон: на «ты», кратко, без эмодзи (редко 👍🏻/💌), без канцелярита, 1-3 предложения.
Обкатка
- 2-3 дня:
ai_agent_knowledge_base_questions (пропущенные вопросы) + ai_agent_analytics.
- Когда стабильно — включать
answerOnCommentEnabled + engageCommentUserEnabled.
- Плохой ответ → topic rule (приоритет) ИЛИ Q&A в KB ИЛИ global rules (жёстче).
Troubleshooting
| Симптом |
Причина |
Решение |
AI assistant not exists |
Не создан в UI |
Владелец → UI → Создать |
You have no active ChatPlace AI package |
Нет AI Pack |
Владелец → Connect AI tools → оплата |
| Cloudflare 403 HTML |
Неверный auth |
Только Authorization: Bearer |
| Агент не ловит опечатки «Cloude/Клоде» |
equals case-sensitive |
Варианты в KB как вопросы ИЛИ Message Recognition (UI) |
| Под комментом тишина |
Нет comment auto-reply rule |
comments_create |
| Whisper misspelling of name |
Upload without proofreading |
Grep for name variants → replace with canonical |
API Discovery
source ~/.secrets/chatplace/env
curl -s -X POST "https://mcp.chatplace.io/mcp" \
-H "Authorization: Bearer $CHATPLACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Группы (~120 tools): ai_agent_*, automations_*, comments_*, bots_*, chats_*, mailings_*, products_*, ref_links_*, tags_*, variables_*, virale_*, media_*.
Документация
Files
- references/keyword-workflow.md
- references/ai-agent-workflow.md
- references/ai-agent-current-config.md
1---2name: chatplace-marketing-sales3description: Создание новых элементов воронки в ChatPlace: кодовые слова с DM-автоматизацией и публичным ответом под комментом, AI-агент-продажник с knowledge base + topic rules + global rules. Use when: (1) adding new Instagram keyword that must trigger DM + public comment reply, (2) configuring or updating the ChatPlace AI sales agent (your account), (3) writing/editing global rules or topic rules for the AI agent, (4) adding Q&A entries to knowledge base, (5) testing agent answers before publishing, (6) troubleshooting ChatPlace setup (API limits, AI Pack subscription errors). NOT for analytics/reports (out of scope — keep in your own tracking system).4---56# ChatPlace Marketing & Sales — создание элементов воронки78Инструмент для создания/обновления двух типов сущностей в ChatPlace:91. **Кодовые слова** (Instagram keywords) — автоматика DM + публичный ответ под комментом102. **AI-агент-продажник** — единая сущность, отвечает в DM за клиента, ведёт к продаже воркшопа1112> **Note:** этот скилл покрывает только создание сущностей (keywords + AI-агент). Аналитика, реестры ссылок, сквозные отчёты — вне скоупа, делайте своим инструментом.1314---1516## Главные правила (выучить до кода)1718### Правило 1: кодовое слово = 4 элемента за один проход191. **Automation** (`automations_quick_setup`) — DM-воронка: welcome + URL-кнопка202. **Comment auto-reply rule** (`comments_create`) — публичный ответ под комментом213. **Case variants** — минимум 7 форм: ALL_CAPS, Capitalized, lowercase, CamelCase + кириллица. equals case-sensitive.224. **Оба языка** (если переводимо): EN + RU. Пример: workshop, Workshop, WORKSHOP, WorkShop, воркшоп, Воркшоп, ВОРКШОП.2324Почему сразу 4: без comment rule под постом молчание (теряется соцдоказательство). Без case variants триггер не ловит «Workshop» с большой.2526### Правило 2: AI-агент создаётся ТОЛЬКО через UI27Все `ai_agent_*` падают с `"AI assistant not exists"` пока агент не создан через UI ChatPlace. Увидел — попроси владельца аккаунта: ChatPlace → бот → AI-агент → Создать.2829### Правило 3: AI Pack должен быть оплачен30Публикация падает с `"You have no active ChatPlace AI package"` без AI-пакета. Попроси владельца: Connect AI tools → AI agent → оплата.3132### Правило 4: без Whisper-опечаток в продакшне33Перед заливом текстов (KB, шаблоны, rules) — grep на все Whisper-варианты имени клиента и заменять на каноническое. Voice transcripts often misspell names.3435---3637## Connection3839- **MCP endpoint:** `https://mcp.chatplace.io/mcp`40- **Auth:** `Authorization: Bearer $CHATPLACE_API_KEY` (НЕ x-api-key — Cloudflare 403)41- **Key path:** `~/.secrets/chatplace/env`42- **Bot (@your_instagram Instagram):** `YOUR_BOT_ID`4344```bash45source ~/.secrets/chatplace/env46```4748---4950## Workflow 1: создание кодового слова5152Полный playbook — [references/keyword-workflow.md](references/keyword-workflow.md). Короткая версия:53541. **Invite link** — Telegram Bot API `createChatInviteLink` + сохранить в свой реестр источников.552. **Tag** (`tags_create`, name=`kw_<keyword>`) для сегментации.563. **Automation** (`automations_quick_setup`): botId, commentEquals=7+ variants, messageEquals=те же, welcome + URL-кнопка.574. **Action** (`automations_actions_setup`) — добавить тег на первое сообщение.585. **Comment auto-reply rule** (`comments_create`): type=equals, startMessages=те же 7+, answers=3+ ротации без эмодзи и ссылок.596. **Тест** — вручную под постом и в DM.6061Существующие keywords держите в своём реестре (БД / spreadsheet).6263---6465## Workflow 2: AI-агент-продажник6667Полный playbook — [references/ai-agent-workflow.md](references/ai-agent-workflow.md).6869### Архитектура7071| Компонент | API | Назначение |72|-----------|-----|------------|73| Global rules | `ai_agent_update_global_rules` | Тон, миссия, ссылки, запреты — на ВСЕ ответы |74| Topic rules | `ai_agent_topic_rules_add` | Ситуационные блоки |75| Knowledge base | `ai_agent_knowledge_base_add` | Q&A пары |76| Settings | `ai_agent_update_settings` | Задержка, silence, DM/comments on/off, auto-retrain |77| Publish | `ai_agent_publish` | Активация (требует AI Pack) |7879### Порядок настройки80811. `ai_agent_status` — проверить что создан.822. `ai_agent_update_global_rules` с `enabled:true`.833. `ai_agent_update_settings` — стартовый набор:84 - answerOnMessageEnabled: true85 - answerOnCommentEnabled: false (комменты — после обкатки)86 - generateButtons: true87 - autoRetrainOnDialogs: true88 - responseDelay: 45 + responseDelayEnabled: true89 - silenceAfterHumanReply: 240 + silenceAfterHumanReplyEnabled: true904. 4 topic rules через `ai_agent_topic_rules_add`: Тёплый лид / Холодный интерес / Бесплатные гайды / Возражения.915. 30 Q&A через `ai_agent_knowledge_base_add` пачкой.926. Тест на 5 сценариях через `ai_agent_test_question`.937. Драфт владельцу на апрув (с примерами реальных ответов).948. `ai_agent_publish` после явного апрува владельца.9596### Правила контента (Evergreen)9798- **НИКОГДА не называй конкретные даты старта.** Пиши «3 дня», «3-дневный», «за 3 дня».99- **ВСЕГДА UTM:** `https://yourdomain.com/lp/?utm_source=instagram&utm_medium=chatplace&utm_campaign=agent`. Суффиксы: `agent_warm`, `agent_guides`, `agent_objection`.100- **НЕ шли `your-internal-url.example`** — внутренняя ссылка.101- **Холодный канал:** `https://t.me/+YOUR_CHANNEL_INVITE` (your Telegram channel; track in your subscriber DB).102- **Гайды:** `https://yourdomain.com/guides` — можно клиентам.103- **Тон:** на «ты», кратко, без эмодзи (редко 👍🏻/💌), без канцелярита, 1-3 предложения.104105### Обкатка106107- 2-3 дня: `ai_agent_knowledge_base_questions` (пропущенные вопросы) + `ai_agent_analytics`.108- Когда стабильно — включать `answerOnCommentEnabled` + `engageCommentUserEnabled`.109- Плохой ответ → topic rule (приоритет) ИЛИ Q&A в KB ИЛИ global rules (жёстче).110111---112113## Troubleshooting114115| Симптом | Причина | Решение |116|---------|---------|---------|117| `AI assistant not exists` | Не создан в UI | Владелец → UI → Создать |118| `You have no active ChatPlace AI package` | Нет AI Pack | Владелец → Connect AI tools → оплата |119| Cloudflare 403 HTML | Неверный auth | Только `Authorization: Bearer` |120| Агент не ловит опечатки «Cloude/Клоде» | equals case-sensitive | Варианты в KB как вопросы ИЛИ Message Recognition (UI) |121| Под комментом тишина | Нет comment auto-reply rule | `comments_create` |122| Whisper misspelling of name | Upload without proofreading | Grep for name variants → replace with canonical |123124---125126## API Discovery127128```bash129source ~/.secrets/chatplace/env130curl -s -X POST "https://mcp.chatplace.io/mcp" \131 -H "Authorization: Bearer $CHATPLACE_API_KEY" \132 -H "Content-Type: application/json" \133 -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'134```135136Группы (~120 tools): `ai_agent_*`, `automations_*`, `comments_*`, `bots_*`, `chats_*`, `mailings_*`, `products_*`, `ref_links_*`, `tags_*`, `variables_*`, `virale_*`, `media_*`.137138### Документация139- AI Agent: https://intercom.help/chatplace/en/articles/11869889-ai-agent140- Text Assistant: https://intercom.help/chatplace/en/articles/7016813141- Flow Enhancements: https://intercom.help/chatplace/en/articles/10989531142- Neural Network Queries: https://intercom.help/chatplace/en/articles/10894004143- Automation Creation: https://intercom.help/chatplace/en/articles/10003893144145---146147## Files148149- [references/keyword-workflow.md](references/keyword-workflow.md)150- [references/ai-agent-workflow.md](references/ai-agent-workflow.md)151- [references/ai-agent-current-config.md](references/ai-agent-current-config.md)
qwwiwi