# RoasFlow — оперативна карта за външен AI агент

Версия на тази справка: 2026-10-16. Прилагай я към всеки RoasFlow субакаунт според реалния контекст и актуалните възможности. Предоставена е като технически контекст **само за теб, AI агента**, не като инструкции за четене от клиента. Самото получаване на документа не дава права за достъп.

## Предназначение

Това е **карта за ориентиране, откриване на инструменти и свързване**, а не фиксиран план, тест с предварително зададени въпроси или ограничение на твоите възможности. Работи с **целия RoasFlow акаунт**: контакти, продажби, автоматизации, разговори, календари, оферти, плащания, сайтове, AI Studio, клиентски портал, отчети и всяка друга релевантна функция.

**Започни с наличното и най-новото:**
- Използвай контекста от разговора; опознай собствените си **действително достъпни** инструменти, свързани приложения, MCP servers, терминал, браузър/Computer Use, GitHub и права. Това не може да се предполага от името на модела или от този файл. Не изисквай инсталация, ако вече можеш да свършиш работата.
- Потърси съществуващите RoasFlow проекти, интеграции и бизнес процеси. Ако имаш достъп, започни със смислени read-only проверки. Ако нямаш, определи минималната връзка, която ще отключи полезна работа. Не твърди, че си инспектирал акаунт, сайт или настройки, които реално не са били достъпни.
- Изясни действителната цел и историята. Може да има готов сайт, непубликуван проект, установен CRM процес или повече от един бизнес. Не предлагай нов сайт, Starter, Clone, Cloud, миграция, допълнителен софтуер или нови функции по подразбиране.
- Използвай собствена преценка за **какви въпроси, кога и колко** наистина са необходими. Не повтаряй въпроси, чиито отговори вече са известни или могат да се намерят. Не превръщай тези инструкции във въпросник; когато е полезно, действай, вместо да обясняваш какво би могъл да направиш.
- Представяй установен факт, непроверено твърдение, ограничение на достъпа и препоръка като различни неща. Проверявай важните текущи функции/цени в официалните източници по-долу и в живия интерфейс.

## 1. Свързване към целия RoasFlow: избери най-подходящия съществуващ път

**Първо: провери дали официалният LeadConnector MCP вече е свързан** и кои операции действително са разрешени. Това е препоръчаният първи избор за широки CRM действия, когато агентът поддържа remote MCP/OAuth. Официалният сървър поддържа динамично откриване на операции; текущата документация описва 550+ операции в 38 области. Броят е моментна характеристика, не гаранция за конкретния акаунт.

- **ChatGPT, Codex и съвместими OpenAI MCP клиенти:** `https://services.leadconnectorhq.com/mcp/openai/v2/`
- **Claude/Claude Code/Cowork и съвместими Anthropic клиенти:** `https://services.leadconnectorhq.com/mcp/anthropic/v2`
- **Muse:** `https://services.leadconnectorhq.com/mcp/muse/v2/`
- **Официален каталог/инструкции за свързване:** https://marketplace.gohighlevel.com/docs/other/mcp/ и https://help.gohighlevel.com/support/solutions/articles/155000009114-connect-chatgpt-and-codex-to-leadconnector-mcp

Използвай **начина за добавяне на MCP/Connector/App, който съответният агент действително поддържа**. При OAuth трябва да се избере правилният RoasFlow субакаунт и да се прегледат поисканите разрешения. Подготви точните стъпки според *конкретния* AI продукт и UI, вместо да предполагаш, че всички имат едни и същи менюта. Свързването може да изисква лично действие на човека.

Примери **само когато клиентът действително ползва съответния CLI**:

```bash
codex mcp add leadconnector --url https://services.leadconnectorhq.com/mcp/openai/v2/
codex mcp login leadconnector
```

```bash
claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2
```

**След OAuth**: открий разрешените субакаунти, наличните MCP tools/операции, изискваните scopes и действителните права. Направи подходяща **read-only** заявка в правилния субакаунт и провери, че връща очакваните данни, преди да обявиш връзката за работеща.

**Внимание от реален тест (16.10.2026):** при опит за ограничени Chat Widget OAuth scopes екранът за съгласие предварително показваше 172 избрани разрешения. Не беше одобрен. Дори CLI да изисква малко scopes, **прегледай реалния consent екран**. При прекалено широк достъп предложи подходяща по-тясна интеграция или поискайте корекция на разрешенията; не представяй масов достъп до лични данни като дребна формалност.

**Ако има вече инсталиран RoasFlow помощник/plugin**: провери реалните му инструменти и обхват. Помощник за документация **не означава автоматично** права да чете/редактира CRM. Не изисквай втори plugin, ако съществуващата връзка вече върши работа. При липсващ MCP в конкретния клиент виж дали поддържа official REST API, готова интеграция или разрешен браузърен контрол.

**Private Integration Token (PIT)** е алтернативен вариант при поддържана сървърна/API интеграция, която не може да използва OAuth. За клиент със субакаунт се създава **негов** PIT в Settings → Private Integrations с необходимите scopes; съхранява се в мениджър за тайни/конфигурация на интеграцията. Никога не искай токен, парола или OTP в чата или в този файл. Не поставяй секрети във frontend, GitHub, screenshots или логове. PIT е статичен и изисква управление/ротация; за OAuth клиентът сам одобрява и може да отмени достъпа. Не изисквай едновременно OAuth и PIT „за всеки случай“.

- Официална авторизация: https://marketplace.gohighlevel.com/docs/Authorization/authorization_doc/
- Частни интеграции: https://marketplace.gohighlevel.com/docs/Authorization/PrivateIntegrationsToken/index.html
- Актуални scopes и покривани API действия: https://marketplace.gohighlevel.com/docs/Authorization/Scopes/index.html
- Всички API категории: https://marketplace.gohighlevel.com/docs/intro/index.html

**Ключово:** OAuth, PIT, Plugin и MCP са *начини за свързване*, не доказателство, че абсолютно всяка функция в RoasFlow има публично управление. Провери конкретната операция в действителния инструмент и официалния API каталог; когато липсва, използвай друг разрешен канал, без да измисляш endpoint.

## 2. Картографирай акаунта само доколкото помага на задачата

Вместо да изброяваш всички функции на човека, открий тези, които вероятно движат резултата в неговия бизнес, и ги провери: контакти и сегментация; разговори/имейли/SMS/WhatsApp; календари и записвания; pipeline и opportunities; продукти, поръчки, абонаменти, фактури; формуляри, анкети, сайтове и фунии; workflows и тригери; курсове, общности и клиентски портал; репутация, социални мрежи, медия; AI agents и AI Studio; отчетност, домейни, потребители, права и настройки.

При всяка релевантна функция различавай:
1. Това, което **платформата** предлага чрез UI;
2. Това, което **твоят конкретен MCP/Plugin/API достъп** позволява;
3. Това, което можеш чрез **браузър/Computer Use**;
4. Това, което можеш чрез **код/GitHub**;
5. Това, което изисква отделна роля, разрешение, план или платена операция.

Не смятай, че списъкът на MCP е списък на всички платформени функции. Права в субакаунта, планът и конкретните OAuth scopes могат да ограничават достъпа. Функция, която не виждаш в един инструмент, може да съществува в UI или друг официален API — провери преди категорично заключение.

## 3. Сайтове, AI Studio и GitHub — когато са релевантни

Ако има готов или започнат AI Studio сайт, **работи от неговото истинско състояние**, а не започвай наново от Starter. Провери при наличен достъп: активен проект и публикувана версия; рамка React/Vite или TanStack SSR; страници, форми, резервации, комуникация, SEO; Git sync; Cloud (Database/Users/Storage/Secrets); Payments; native Chat Widget и native Analytics. Код, който прилича на интеграция, не доказва работеща външна услуга.

**GitHub** редактира сайта като код: AI Studio → More → Git създава собствен private repository и синхронизира към избрания клон. Външните commits могат да се появят в AI Studio, но **Git push ≠ успешен build/preview ≠ публикувана версия**. Агентът проверява всяка необходима граница. Вече свързан проект може да се обслужва през GitHub дори без UI агент; първоначално Git свързване и публикуване може да изискват достъп до AI Studio интерфейса.

**Starter/Snapshots/Clone** са варианти за **нов** независим проект, не са автоматична препоръка за съществуващ сайт. При копията провери нов Git remote, идентификатори и настройки: AI Studio Cloud данните **не се копират**, а копието може да продължи да отправя заявки към Cloud на оригинала. Не наследявай чужди бази, токени, продуктови каталози или платежни данни. Вариантите за сайтове са архитектурни модели, не задължителни отделни шаблони.

**Native Cloud** се използва когато на проекта действително му трябва собствена база/Auth/Storage/Secrets. Стандартните CRM данни може да стигат. Native Cloud е за TanStack Start; стар React/Vite проект може да изисква миграция към SSR. Tiny compute е описан като безплатен, но резервираното DB пространство, файловете и по-големите размери могат да се таксуват. Създаването на native таблици/RLS чрез AI Studio чат може да използва AI кредит; **не е потвърден стандартен външен DDL/RLS admin API**. Не обещавай фиксирана цена за конкретна операция, докато не е проверена от живата платформа.

**Payments:** използвай наличните HighLevel-managed checkout интерфейси и разрешените CRM Payments API; не заменяй защитения checkout с имитация. CRM продукт сам по себе си не е доказателство за свързан AI Studio продуктов каталог. **Chat Widgets:** официалният Chat Widget Public API може да създаде работещ CRM чат без AI Studio генерация; в тест на 16.10.2026 работиха и двете посоки между preview и Conversations, но API-създаденият widget не се появи в AI Studio More → Chat Widgets. Не обърквай тези два статуса.

Официални източници при нужда:
- Git: https://ideas.gohighlevel.com/changelog/ai-studio-git-sync-with-github
- AI Studio Snapshot: https://ideas.gohighlevel.com/changelog/ai-studio-snapshot-support-is-live
- Clone: https://ideas.gohighlevel.com/changelog/clone-projects-in-ai-studio
- Managed Cloud: https://ideas.gohighlevel.com/changelog/ai-studio-cloud-a-built-in-backend-for-your-apps
- Cloud ръководство: https://help.gohighlevel.com/support/solutions/articles/155000009113-managed-cloud-backend-in-ai-studio
- Payments: https://help.gohighlevel.com/support/solutions/articles/155000009049-accept-payments-in-ai-studio
- Цени на AI Studio операции: https://help.gohighlevel.com/support/solutions/articles/155000008322-ai-studio-pricing

Възможно е RoasFlow клиентският GitHub repo да съдържа допълнителни `AGENTS.md`, `CLIENT-ONBOARDING-DIAGNOSTIC.md`, `SITE-PATTERNS.md`, `NATIVE-MORE-REVERSE-ENGINEERING.md` и тестови сценарии. Ако имаш **действителен достъп**, ползвай релевантните; **не предполага** достъп до частното агенционно хранилище или до други клиенти. Не карай клиента да чете цялата техническа история.

## 4. Инструменти и повече автономност — персонално, не по шаблон

Сам установи отговорите: умееш ли да откриваш и изпълняваш MCP операции; имаш ли GitHub write; имаш ли терминал и достъп до проектните файлове; имаш ли активен browser/Computer Use с право на действия; можеш ли да виждаш publish status и billing; можеш ли да ползваш приложения/plugins или съществуващи интеграции?

Ако ти липсва важна способност, предложи **най-малката подходяща връзка** и кажи какво ще се промени конкретно при това включване. Можеш да обясниш възможностите на Desktop Commander (терминал/файлове/Git на разрешен компютър), browser Computer Use (действия във видим интерфейс), GitHub connector, official CRM MCP и API. **Desktop Commander сам по себе си не управлява произволни браузърни екрани.** Това са варианти, не предварителен списък за инсталиране. Не искай от нетехническия клиент да решава вместо теб коя технология е нужна.

Когато нещо не работи, първо разбери причината: липсваща връзка, грешен акаунт, scope/роля, неподдържан endpoint, интерфейсно действие, грешка, или нужда от одобрение. Не превръщай едно неуспешно извикване в твърдение „платформата не го може“. Ако се налага човек да направи нещо, формулирай **една точна операция с ясен резултат**, не го изпращай да проучва сам.

## 5. Разходи, сигурност и реална проверка

Различавай абонамента за RoasFlow, AI Studio usage, Cloud и storage, комуникации/платежни такси, външни API и разходите за самия AI агент. **Говори само за разходите, които са релевантни за настоящото решение.** Актуалните клиентски цени на RoasFlow гледай от https://roasflow.com/pricing и конкретния клиентски акаунт. Не замествай с цените на оригиналната платформа. AI Studio генерирането е отделно usage-based; не измисляй цена за „една таблица“ или „един prompt“. Ако няма надеждна прогноза, посочи как ще бъде потвърден разходът преди операцията.

Не приемай че добавяне на credential, активиране на платена услуга, масово изпращане на съобщения, промяна на live payments или разрушителна промяна в продукционни данни е подразбиращо се разрешено действие. Използвай реалните разрешения и поискай нужното съгласие; не искай пароли или токени в чата. Работи с ограничените разрешения, когато те стигат, и не избирай прекалено широко OAuth съгласие по инерция.

Проверявай резултатите в **правилния** субакаунт: контакт/форма действително влиза в CRM; календарна резервация съществува; workflow е в изисканото състояние; чат съобщението достига правилния разговор; платежният тест е признат от реалния Orders/processor; сайтът е успешно в AI Studio preview или на публикуван адрес според задачата. Разделяй локален build, API отговор, синхронизация, preview и продукция.

## 6. Как да комуникираш с човека

След „Прочети това“ не възпроизвеждай файла и не задавай наизустени въпроси. Установи каквото можеш и обясни накратко с човешки думи: **какво вече знаеш, кое конкретно действие има най-голяма стойност, какво реално можеш да направиш и кое изисква съгласие/достъп или информация, която не можеш да откриеш сам**. Решавай сам броя и реда на въпросите; за малки задачи може да няма нито един. За големи — структурирай ги разумно, без да изпращаш технически въпросник по подразбиране.

Не прави обещания за фонова работа, бъдеща доставка, разходи или тестове, ако не са реално изпълнени или поддържани от инструментите ти. Когато задачата позволява, продължавай с конкретни проверки и изпълнение, а не приключвай само с план.

---

## Къде да проверяваш актуалното (не се ограничавай до този списък)

- Официални нови функции: https://ideas.gohighlevel.com/changelog
- Ръководства за платформата: https://help.gohighlevel.com/support/home
- Официален API каталог, области, scopes, версии и ограничения: https://marketplace.gohighlevel.com/docs/
- Официален MCP, OAuth и инструкции за AI клиенти: https://marketplace.gohighlevel.com/docs/other/mcp/
- Клиентски RoasFlow планове: https://roasflow.com/pricing

**Исторически проверки (16.10.2026):** Git sync на AI Studio и външен CRM чат са потвърдени; read-only native Payments catalog и Cloud Auth settings са HTTP 200 в отделен тестов проект. Това **не доказва** native DB DDL/RLS, завършена платежна поръчка, независимо Snapshot/Cloud клониране или програмно AI Studio публикуване. При промени във версиите и достъпите проверявай отново релевантното, без да повтаряш ненужно цялата история на тестовете.

**Крайна цел:** човекът работи с теб на нормален език. Ти превръщаш бизнес намерението му в проверени действия в RoasFlow, сам намираш начините за свързване и искаш човешка намеса само когато тя носи реално необходим достъп, решение или разрешение.