SKILL.md
ChatPlace Marketing & Sales — создание элементов воронки
Инструмент для создания/обновления двух типов сущностей в ChatPlace:
- Кодовые слова (Instagram keywords) — автоматика DM + публичный ответ под комментом
- AI-агент-продажник — единая сущность, отвечает в DM за клиента, ведёт к продаже воркшопа
Note: этот скилл покрывает только создание сущностей (keywords + AI-агент). Аналитика, реестры ссылок, сквозные отчёты — вне скоупа, делайте своим инструментом.
Главные правила (выучить до кода)
Правило 1: кодовое слово = 4 элемента за один проход
- Automation (
automationsquicksetup) — 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
Все aiagent* падают с "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 $CHATPLACEAPIKEY(НЕ x-api-key — Cloudflare 403) - Key path:
~/.secrets/chatplace/env - Bot (@yourinstagram Instagram):
YOURBOT_ID
source ~/.secrets/chatplace/envWorkflow 1: создание кодового слова
Полный playbook — [references/keyword-workflow.md](references/keyword-workflow.md). Короткая версия:
- Invite link — Telegram Bot API
createChatInviteLink+ сохранить в свой реестр источников. - Tag (
tagscreate, name=kw<keyword>) для сегментации. - Automation (
automationsquicksetup): botId, commentEquals=7+ variants, messageEquals=те же, welcome + URL-кнопка. - Action (
automationsactionssetup) — добавить тег на первое сообщение. - Comment auto-reply rule (
comments_create): type=equals, startMessages=те же 7+, answers=3+ ротации без эмодзи и ссылок. - Тест — вручную под постом и в DM.
Существующие keywords держите в своём реестре (БД / spreadsheet).
Workflow 2: AI-агент-продажник
Полный playbook — [references/ai-agent-workflow.md](references/ai-agent-workflow.md).
Архитектура
| Компонент | API | Назначение |
|---|---|---|
| Global rules | aiagentupdateglobalrules |
Тон, миссия, ссылки, запреты — на ВСЕ ответы |
| Topic rules | aiagenttopicrulesadd |
Ситуационные блоки |
| Knowledge base | aiagentknowledgebaseadd |
Q&A пары |
| Settings | aiagentupdate_settings |
Задержка, silence, DM/comments on/off, auto-retrain |
| Publish | aiagentpublish |
Активация (требует AI Pack) |
Порядок настройки
aiagentstatus— проверить что создан.aiagentupdateglobalrulesсenabled:true.aiagentupdate_settings— стартовый набор:
- answerOnMessageEnabled: true - answerOnCommentEnabled: false (комменты — после обкатки) - generateButtons: true - autoRetrainOnDialogs: true - responseDelay: 45 + responseDelayEnabled: true - silenceAfterHumanReply: 240 + silenceAfterHumanReplyEnabled: true
- 4 topic rules через
aiagenttopicrulesadd: Тёплый лид / Холодный интерес / Бесплатные гайды / Возражения. - 30 Q&A через
aiagentknowledgebaseaddпачкой. - Тест на 5 сценариях через
aiagenttest_question. - Драфт владельцу на апрув (с примерами реальных ответов).
aiagentpublishпосле явного апрува владельца.
Правила контента (Evergreen)
- НИКОГДА не называй конкретные даты старта. Пиши «3 дня», «3-дневный», «за 3 дня».
- ВСЕГДА UTM:
https://yourdomain.com/lp/?utmsource=instagram&utmmedium=chatplace&utmcampaign=agent. Суффиксы:agentwarm,agentguides,agentobjection. - НЕ шли
your-internal-url.example— внутренняя ссылка. - Холодный канал:
https://t.me/+YOURCHANNELINVITE(your Telegram channel; track in your subscriber DB). - Гайды:
https://yourdomain.com/guides— можно клиентам. - Тон: на «ты», кратко, без эмодзи (редко 👍🏻/💌), без канцелярита, 1-3 предложения.
Обкатка
- 2-3 дня:
aiagentknowledgebasequestions(пропущенные вопросы) +aiagentanalytics. - Когда стабильно — включать
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): aiagent, automations, comments, bots, chats, mailings, products, reflinks, tags, variables, virale, media.
Документация
- AI Agent: https://intercom.help/chatplace/en/articles/11869889-ai-agent
- Text Assistant: https://intercom.help/chatplace/en/articles/7016813
- Flow Enhancements: https://intercom.help/chatplace/en/articles/10989531
- Neural Network Queries: https://intercom.help/chatplace/en/articles/10894004
- Automation Creation: https://intercom.help/chatplace/en/articles/10003893
Files
- [references/keyword-workflow.md](references/keyword-workflow.md)
- [references/ai-agent-workflow.md](references/ai-agent-workflow.md)
- [references/ai-agent-current-config.md](references/ai-agent-current-config.md)