# 🔌 Zapier / Make / n8n integration — что нужно для попадания в их marketplaces

> Создано 2026-05-07. Цель — превратить GuardLabs Care/Guardian/Anti-Fraud в подключаемые модули в каталогах автоматизации.

---

## Зачем это вообще

| Платформа | DR | DAU | Если попасть в маркетплейс |
|---|---|---|---|
| **Zapier** | 92 | ~10M | beat-search «website monitor», «server alert» — наш коннектор показывается рядом с UptimeRobot |
| **Make** (Integromat) | 88 | ~2M | менее конкуренция чем Zapier, шанс попасть в featured |
| **n8n** | 76 | ~500K | open-source — наш коннектор ставится локально, разработчики любят |

**ROI:** один коннектор живёт в каталоге **годы**, и приносит inbound лидов которых ты не «купил» — они нашли тебя через поиск автоматизации.

---

## Что нужно от Стаса (UI signup, по 5 минут каждый)

### 1. Zapier Developer account
- https://developer.zapier.com/
- Login через Stas Google/Email
- Click "Create New Integration" → нужно App Name (`GuardLabs Guardian`), description, logo (готов: `/files/ph_assets/guardian_logo_1080.png`)
- **Я заполняю** всё остальное — endpoints, fields, sample payloads
- Submit на review (Zapier может потребовать 30+ дней для public listing, но **private link** работает сразу)

### 2. Make Developer account
- https://www.make.com/en/help/apps/about-developing-apps
- Login → Apps → Create Custom App
- Те же поля. Сначала private, потом public review

### 3. n8n Community node
- https://docs.n8n.io/integrations/creating-nodes/
- Это open-source — **просто публикуем npm package** `n8n-nodes-guardlabs`
- Нужен npm account (`npm login` под аккаунтом Стаса) → publish → пакет автоматом появляется в n8n Community Nodes
- **Это самый быстрый путь — не требует review**

---

## Что я могу сделать автономно (когда Стас даст npm token и/или Zapier email/password)

### Архитектура коннектора

Каждая интеграция предоставляет 3 типа узлов:

**TRIGGERS (когда что-то произошло у нас):**
- `Site Down Detected` — наш Guardian обнаружил падение сайта клиента
- `Audit Report Ready` — наш Web-Audit закончил скан
- `Anti-Fraud Hold Triggered` — Anti-Fraud задержал подозрительный referral

**ACTIONS (что-то делаем по запросу):**
- `Run Site Audit` — клиент Zapier-а просит нас проверить URL
- `Add to Monitoring` — добавить URL в наш guardian
- `Check Referral Risk` — пробить реферал на фрод

**SEARCH:**
- `Find Site Status` — текущее состояние мониторинга для URL

### Endpoints на нашей стороне

**Уже есть (нужно расширить):**
- `POST /webhook/inbound` (mailersend)
- `POST /webhook/whop` (Whop payments)

**Нужно добавить:**
- `POST /api/external/audit` — клиент шлёт URL → возвращаем audit report
- `POST /api/external/monitor/subscribe` — клиент шлёт URL → ставим в guardian
- `POST /api/external/fraud/check` — клиент шлёт reference_id → checkfraud risk score
- `GET  /api/external/site/{url}/status` — current monitoring state

**Authentication:**
- Bearer token (1 token per Zapier user, generated on first connect via OAuth-style "Connect to GuardLabs" button)

---

## Roadmap

### Phase 1 — n8n Community Node (1 неделя, $0 cost)
**Самый быстрый — не требует review.**
- [ ] Я разрабатываю `n8n-nodes-guardlabs` локально (TypeScript node template)
- [ ] Implement 3 triggers + 3 actions
- [ ] Local testing → `npm publish` под Stas npm account
- [ ] Auto-discovery в n8n Community Nodes
- [ ] Документация в README + примеры flows
- [ ] Submit upstream PR в `n8n-io/n8n-docs` для попадания в featured list

### Phase 2 — Zapier Private App (2 недели + 30 дней review для public)
- [ ] Создать Zapier integration через UI
- [ ] Я заполняю API endpoints, fields, sample payloads
- [ ] Submit на review для public listing
- [ ] Параллельно — выдаём pre-prod ссылку клиентам (private мode работает сразу)

### Phase 3 — Make Custom App (1 неделя)
- [ ] Аналогично Zapier, но Make быстрее на review
- [ ] Featured potential выше т.к. меньше конкурентов в нише monitoring

---

## Что Стасу делать прямо сейчас

🟡 **Низкий приоритет — это большой проект, сначала закроем PH/HARO.**

Но если хочется быстро — **n8n npm publish можно сделать за 1 день** (не требует UI review). Скажи и я начну с n8n.

Альтернативный быстрый ход — добавить ОДИН webhook endpoint в наш Flask и **public документировать его как "GuardLabs Webhook API"**. Это уже даёт техническим клиентам возможность дёргать нас из любого Make/Zapier/n8n flow без специального коннектора. Setup: 30 минут моей работы, $0.

---

## Конкуренты в маркетплейсах (на что мы похожи и чем отличаемся)

| В Zapier | DR | Наше отличие |
|---|---|---|
| UptimeRobot | 89 | у них только uptime, у нас полный audit + maintenance + fraud |
| Pingdom | 91 | enterprise pricing — у нас $79-249/yr |
| Better Uptime | 71 | хорошие, но без аудита и Anti-Fraud |
| StatusGator | 65 | агрегатор — мы делаем работу |

**Позиционирование коннектора:** "When you don't just want to know it's down — you want it fixed."