Інтеграції: три рівні Integrations: three tiers

Клієнт запитав список інтеграцій — і вийшов перелік з 30+ сервісів: Instagram, Facebook, Viber, WhatsApp, Telegram, Нова Пошта, Укрпошта, PROM, Rozetka, Shopify, Checkbox, LiqPay, Monobank, WooCommerce, Tilda, телефонія, SMS, email — і це ще не все.

Писати 30 окремих коннекторів руками — це місяці роботи. Є стратегія краща.

Правило: три рівні

Рівень 1 — Нативні коннектори (core платформи)

Пишемо вручну ті інтеграції, де потрібна глибока взаємодія: публікація медіа з chunked upload, webhook'и з валідацією підпису, refresh-токени, аналітика, специфічні rate limits.

Список «core»:

• Meta (Instagram + Facebook) — Graph API v21, публікація в IG Feed/Reels, FB Pages, читання інсайтів, коментарі. Вебхуки на FB Lead Ads.
• TikTok Content Posting API — OAuth, init → chunked upload → status polling. Окремо — Analytics API.
• Telegram Bot API — sendPhoto/sendVideo/sendMediaGroup, webhook для коментарів. Простіший за інших, але критичний канал.
• YouTube Data + Upload API — як джерело (імпорт відео для перевикористання) і приймач (Shorts).
• Google Ads API — для управління рекламою у Turnkey-клієнтів.
• Stripe + LiqPay/WayForPay — платіжні з webhook'ами, критичні для грошових потоків.

Оцінка роботи: кожен «core» коннектор — від 2 до 10 днів.

Рівень 2 — Zapier / Make.com / n8n bridge

Тут та сама ідея, що дозволяє отримати 80% всіх інтеграцій практично безкоштовно.

Як це працює:

1. Ми пишемо ОДИН коннектор — «Incoming Webhook» і «Outgoing Webhook» в форматі Zapier/Make app.
2. Клієнт заходить у свій Zapier (або Make.com, або n8n — всі сумісні за суттю), вибирає будь-який з 10 000+ сервісів як Trigger або Action.
3. Наприклад: «Новий рядок в Google Sheets → Публікація в OneClick Social» — клієнт налаштовує це одним Zap'ом за 5 хвилин. Без нашого коду.
4. Або навпаки: «Нова публікація опублікована → Відправити повідомлення в Slack» — теж Zap, без нашої роботи.

Вартість нам: кілька днів на реалізацію Zapier app (+ сертифікація в публічному маркеті Zapier, якщо хочемо візібельність).

Результат: клієнти отримують доступ до:

• Google Sheets, Notion, Airtable (планування контенту)
• Slack, Discord, Microsoft Teams (нотифікації)
• Mailchimp, SendGrid, ActiveCampaign (email-сінк)
• HubSpot, Pipedrive, Salesforce, monday (CRM-імпорт)
• Dropbox, Google Drive, OneDrive (джерела медіа)
• Calendly, Acuity (нотифікації про публікації)
• Shopify, WooCommerce, BigCommerce (для e-commerce-подій)
• ...ще 10 000 сервісів

Рівень 3 — Open API (наш REST)

Для кастомних випадків, де Zapier не підходить (складна логіка, високі об'єми, потрібен прямий API):

• REST endpoints — POST /api/v1/publish, GET /api/v1/posts, POST /api/v1/brands/[id]/media.
• Outgoing webhook subscriptions — клієнт підписується на наші події: publish.succeeded, publish.failed, comment.received, lead.created.
• API keys per Brand — з rate limiting і аудитом викликів.
• OpenAPI 3.0 spec — щоб клієнти могли автогенерувати SDK на будь-якій мові.

Робота: 1-2 тижні на перший стабільний реліз API. Далі — розширення за запитом.

Кому що підходить

Потреба клієнта	Рівень
«Публікувати в IG/FB/TikTok з одного місця»	Рівень 1 (нативно)
«Коли в Google Sheets з'являється рядок — публікувати»	Рівень 2 (Zapier)
«Наша старенька ERP хоче викликати ваш API»	Рівень 3 (Open API)
«Коли хтось залишає коментар — в Slack нашої команди»	Рівень 2 (Zapier) або 3 (webhook)
«Потрібно надсилати SMS по Turbo SMS коли статус змінюється»	Рівень 2 (Zapier має Turbo SMS)

Що це економить

Якби ми писали 30 інтеграцій нативно — це ~6 місяців роботи одного розробника. Через комбінацію трьох рівнів:

• Core 6 інтеграцій нативно = ~8 тижнів
• Zapier bridge = ~1 тиждень
• Open API = ~2 тижні

Разом ~11 тижнів замість 24+. І клієнти мають більше варіантів, ніж якщо б ми писали 30 нативних.

Категорії з повного списку, і куди що лягає

Інтеграція	Рівень
Instagram / Facebook Page / FB Leads	1
TikTok	1
Telegram Bot / Viber Bot	1
YouTube	1
Нова Пошта, Укрпошта, NovaPay	1 (нативно — легко, офіційні API)
LiqPay, Fondy, WayForPay, Stripe	1 (критичні платіжні)
Monobank / Privat24	1 (бізнес-операції)
PROM, Rozetka, Shopify, WooCommerce	2 (через Zapier) або 1 для преміум-клієнтів
Tilda, Weblium, Хорошоп	2 (Zapier + webhooks)
Checkbox, Вчасно.Каса	1 (нативно — вимагає договору з провайдером)
Телефонія (Binotel, Ringostat)	2 (webhook-based, Zapier підтримує)
SMS, Email провайдери	2 (Zapier), або Twilio/SendGrid нативно
Viber Private, WhatsApp Private, Telegram Private	Сіра зона — окремий пост
SitniksPay	Неможливо без партнерки

A client asked for an integration list and out came 30+ services: Instagram, Facebook, Viber, WhatsApp, Telegram, Nova Poshta, Ukrposhta, PROM, Rozetka, Shopify, Checkbox, LiqPay, Monobank, WooCommerce, Tilda, telephony, SMS, email — and that's not all.

Writing 30 separate connectors by hand is months of work. There's a better strategy.

The rule: three tiers

Tier 1 — Native connectors (core platforms)

We hand-write integrations where we need deep interaction: media publishing with chunked uploads, webhook signature verification, refresh tokens, analytics, specific rate limits.

"Core" list:

• Meta (Instagram + Facebook) — Graph API v21, publishing IG Feed/Reels, FB Pages, reading insights, comments. FB Lead Ads webhooks.
• TikTok Content Posting API — OAuth, init → chunked upload → status polling. Plus Analytics API.
• Telegram Bot API — sendPhoto/sendVideo/sendMediaGroup, comment webhooks. Simpler than others but critical channel.
• YouTube Data + Upload API — as source (import videos for repurposing) and destination (Shorts).
• Google Ads API — managing ads for Turnkey clients.
• Stripe + LiqPay/WayForPay — payments with webhooks, critical for money flow.

Work estimate: each "core" connector — 2 to 10 days.

Tier 2 — Zapier / Make.com / n8n bridge

This idea gets us 80% of all integrations practically for free.

How it works:

1. We write ONE connector — "Incoming Webhook" and "Outgoing Webhook" as a Zapier/Make app.
2. The customer goes into their Zapier (or Make.com, or n8n — all compatible in spirit), picks any of 10,000+ services as Trigger or Action.
3. Example: "New row in Google Sheets → Publish in OneClick Social" — the client configures this as one Zap in 5 minutes. Without our code.
4. Or the reverse: "New post published → Send message in Slack" — also a Zap, without our work.

Cost to us: a few days to implement the Zapier app (+ certification in the public marketplace if we want visibility).

Result: customers get access to:

• Google Sheets, Notion, Airtable (content planning)
• Slack, Discord, Microsoft Teams (notifications)
• Mailchimp, SendGrid, ActiveCampaign (email sync)
• HubSpot, Pipedrive, Salesforce, monday (CRM imports)
• Dropbox, Google Drive, OneDrive (media sources)
• Calendly, Acuity (publish notifications)
• Shopify, WooCommerce, BigCommerce (e-commerce events)
• ...10,000 more services

Tier 3 — Open API (our REST)

For custom cases where Zapier doesn't fit (complex logic, high volumes, direct API needed):

• REST endpoints — POST /api/v1/publish, GET /api/v1/posts, POST /api/v1/brands/[id]/media.
• Outgoing webhook subscriptions — customer subscribes to our events: publish.succeeded, publish.failed, comment.received, lead.created.
• API keys per Brand — with rate limiting and call audit.
• OpenAPI 3.0 spec — so clients can auto-generate SDKs in any language.

Work: 1-2 weeks for the first stable API release. Then extended on-demand.

Who gets what

Client need	Tier
"Publish to IG/FB/TikTok from one place"	Tier 1 (native)
"When a row appears in Google Sheets — publish"	Tier 2 (Zapier)
"Our legacy ERP wants to call your API"	Tier 3 (Open API)
"When someone comments — ping our Slack"	Tier 2 (Zapier) or 3 (webhook)
"Send SMS via TurboSMS on status change"	Tier 2 (Zapier has TurboSMS)

What this saves

Writing 30 integrations natively ≈ 6 months of one developer. With a three-tier mix:

• 6 native core integrations ≈ 8 weeks
• Zapier bridge ≈ 1 week
• Open API ≈ 2 weeks

Total ~11 weeks instead of 24+. And customers have more options than if we wrote 30 natively.