E-commerce + CRM
Заказы с сайта в amoCRM/Bitrix24, статусы обратно, оплата Stripe/ЮKassa, склад МойСклад.
INTEGRATION HUB
API-интеграции, которые связывают данные и процессы
CRM, ERP, 1C, биллинг, Telegram и аналитика — не «склеить два REST-вызова», а надёжный pipeline с контрактами данных, очередями, ретраями и мониторингом. SolidWeb проектирует интеграции, которые не ломаются в пятницу вечером.
Работаем с amoCRM, Bitrix24, HubSpot, 1C, Stripe, МойСклад, кастомными ERP и webhook-источниками. Node.js, Python, очереди, idempotency keys, dead letter queues и dashboard здоровья интеграций — стандарт deliverables, не опция.
Контракты и source of truth
Webhooks, очереди, ретраи
Логи, алерты, idempotency
КОМУ ПОДХОДИТ
Когда нужны API-интеграции
Ручной перенос данных между системами, дубли лидов и «интеграция на Zapier упала» — сигналы, что пора строить pipeline.
SaaS + биллинг
Stripe webhooks → provisioning, subscription lifecycle, dunning, аналитика MRR в data warehouse.
1C и ERP
Синхронизация номенклатуры, остатков, счетов между 1C, сайтом и WMS без двойного ввода.
Маркетинг и ops
Leads → CRM → Telegram-уведомления → email, сквозная аналитика, сегментация без CSV-экспортов.
СЛОИ
Три слоя integration pipeline
Контракты → транспорт → наблюдаемость. Каждый слой изолирован и тестируется отдельно.
01
Контракты данных
Маппинг полей, source of truth, JSON Schema / OpenAPI, валидация на входе и версионирование при изменении API партнёра.
02
Транспортный слой
REST, GraphQL, webhooks, очереди (Redis, SQS, RabbitMQ), exponential backoff, timeout, circuit breaker, idempotency keys.
03
Operational visibility
Structured logs, trace id, алерты в Slack/Telegram, dashboard успех/ошибка/latency, dead letter queue для ручного разбора.
СЦЕНАРИИ
Типовые integration use cases
Шесть сценариев, которые закрываем чаще всего — от лидов до биллинга.
Lead → CRM
Форма сайта, квиз, chatbot → amoCRM/HubSpot с dedup, UTM, scoring и назначением менеджера.
Order → ERP
E-commerce заказ → 1C/МойСклад: резерв, счёт, статус отгрузки обратно на сайт и в email.
Payment webhooks
Stripe/ЮKassa события → обновление подписки, доступа, чека и CRM без polling.
Inventory sync
Двусторонняя синхронизация остатков ERP ↔ сайт с conflict resolution и audit log.
Telegram / Slack ops
Алерты о заказах, ошибках интеграций, SLA breaches — bot с кнопками acknowledge.
Analytics export
Server-side events в GA4, BigQuery, Mixpanel — без потери ad-block и с consent gate.
ПРОЦЕСС
Как строим интеграцию
Discovery → контракт → sandbox → production → мониторинг.
1
Discovery
Карта систем, source of truth, частота sync, объёмы, SLA и edge cases (refund, partial ship).
2
Data contract
OpenAPI/JSON Schema, маппинг полей, idempotency strategy, error codes.
3
Sandbox
Staging интеграция, mock webhooks, contract tests, нагрузочный smoke.
4
Transport
Очереди, workers, retry policy, DLQ, circuit breaker.
5
Production rollout
Feature flag, canary traffic, rollback plan, runbook для on-call.
6
Observability
Dashboard, алерты, документация для support, handover команде.
БЕЗОПАСНОСТЬ
Как защищаем pipeline
Практики безопасности, заложенные в каждый integration pipeline.
- Secrets в vault / env — не в коде и не в логах
- Webhook signature verification (HMAC, Stripe signing secret)
- OAuth2 / API keys с rotation policy и least privilege
- PII masking в логах, GDPR-ready retention
- Rate limiting и IP allowlist для inbound webhooks
- Audit trail изменений контрактов и конфигов
АРТЕФАКТЫ
Что вы получаете
Код, документация и мониторинг — интеграция не остаётся «чёрным ящиком».
- Integration service
Deployable код (Node/Python), Docker, CI/CD, env template.
- OpenAPI / Schema
Контракты endpoints и event payloads с версионированием.
- Health dashboard
Grafana/Custom UI: success rate, latency p95, DLQ depth, last sync.
- Runbook + handover
On-call инструкции, типовые ошибки, контакты API партнёров.
“«Интеграция без idempotency — это два счёта клиенту и один очень длинный созвон».”
— SolidWeb Integration Team
FAQ
Частые вопросы об интеграциях
Webhooks, idempotency, 1C, SLA и поддержка после запуска.
No-code подходит для прототипов и низких объёмов. При росте транзакций, сложной логике (1C, partial refund, dedup) и SLA нужен код: очереди, idempotency, contract tests, мониторинг. SolidWeb строит production pipeline, который вы контролируете и расширяете. Zapier можно оставить для некритичных потоков.
Webhook или retry может доставить одно событие дважды. Idempotency key гарантирует, что повторная обработка не создаст второй заказ, лид или списание. Мы проектируем keys на уровне контракта и храним processed ids в Redis/DB с TTL.
Да. REST/OData, CommerceML, файловый обмен — зависит от конфигурации 1C клиента. Discovery включает версию 1C, права, частоту sync и conflict resolution (кто master: 1C или сайт). Типичный срок two-system sync — 3–6 недель после доступов.
Retry с exponential backoff, circuit breaker (pause при серии 5xx), сообщения в DLQ для ручного replay. Алерт в Slack/Telegram. Критичные потоки — fallback queue с отложенной доставкой. SLA документируем в runbook.
По согласованию: ваш VPS, AWS, Vercel serverless (для webhook-light), или managed у SolidWeb. Secrets в env/vault. GDPR: EU region при необходимости. Не храним PII дольше retention policy.
Для inbound API (ваш сайт принимает webhooks) — да, публикуем OpenAPI и версионирование. Для outbound — документируем mapping и event schema. Contract tests в CI ловят breaking changes до prod.
Single connector — 1–2 недели. Two-system sync — 3–6 недель. Hub — 6–12 недель. Discovery и доступы к sandbox партнёров часто определяют critical path. Параллелим transport и contract work где возможно.
Hub включает 3 месяца support: мониторинг алертов, мелкие правки mapping. Дальше — retainer или T&M. Runbook и handover позволяют вашей dev-команде поддерживать сами.
Contract tests (Pact/schema), mock webhooks (Stripe CLI, Postman), staging end-to-end, нагрузочный smoke. Production rollout через feature flag/canary. Не «протестировали на prod».
Иногда — CSV/FTP scheduled import, RPA как крайний случай, или промежуточная DB. Честно оцениваем хрупкость. Предпочитаем официальный API или промежуточный middleware.
SolidWeb часто делает сайт на Next.js и интеграции в одном проекте: единый repo или monorepo, общие типы, один CI. Можем подключиться к существующему сайту другого подрядчика по OpenAPI.
Versioning в контракте, adapter layer, мониторинг deprecated endpoints. Retainer включает адаптацию к minor changes. Major breaking — change request с оценкой.
Нужна связка систем? Оставьте заявку.
ПОДРОБНЕЕ
API-интеграции от SolidWeb
Webhooks, очереди, idempotency и мониторинг — развёрнуто о pipeline.
API-интеграции — это не «написать скрипт на 50 строк». Это связь бизнес-процессов: лид из формы → CRM → менеджер → счёт в 1C → отгрузка → email. Один сбой без retry и idempotency — дубли, потерянные заказы, angry customers.
SolidWeb проектирует три слоя: контракты данных (кто source of truth, как валидировать payload), транспорт (REST, webhooks, очереди, retry, circuit breaker), наблюдаемость (logs, metrics, alerts, DLQ).
Webhooks предпочтительнее polling: Stripe, amoCRM, GitHub шлют события. Мы верифицируем signature, отвечаем 200 быстро, кладём job в очередь, обрабатываем async. Long processing не блокирует webhook timeout партнёра.
Idempotency — обязательна. Payment succeeded дважды из-за retry — финансовый и репутационный риск. Keys на order_id / event_id, store processed в Redis с TTL 7–30 дней.
1C и ERP: discovery версии, OData/CommerceML, conflict rules (остаток на складе — master ERP). Two-system sync часто bidirectional с audit log каждой записи.
Security: secrets не в git, webhook HMAC, OAuth refresh, PII mask в logs, rate limit inbound. GDPR retention policy согласуем на discovery.
Testing: contract tests ловят изменение поля partner API до prod. Stripe CLI, sandbox amoCRM, staging mirror. Canary deploy и rollback.
Deliverables: Docker service, OpenAPI, Grafana dashboard, runbook. Handover вашей team или retainer SolidWeb.
Отличие от автоматизации скриптов: там n8n, CRON и рутинные сценарии. API-интеграции — production-связка между продуктовыми системами с SLA и согласованными контрактами данных.