Интеграция Wix с внешними сервисами через API

Мы не раз сталкивались с ситуацией, когда клиент запустил сайт на Wix, а бизнес-процессы упёрлись в синхронизацию: лиды тонут вручную, заказы теряются, платёжный шлюз не стыкуется. Wix — закрытая платформа: нельзя добавить произвольный серверный код или изменить инфраструктуру. Интеграции строятся через два механизма: Velo (бывший Corvid) — встроенная JavaScript-среда на базе Node.js, и Wix Headless API — REST/GraphQL API для работы с данными извне. Wix предоставляет все необходимые инструменты для настройки связи с любым внешним сервисом: от простого вебхука до полноценного headless-решения. Мы настраиваем их под ключ с гарантией стабильности и документацией. Более 50 успешных интеграций Wix с CRM, платежными системами и ERP подтверждают наш опыт.

Какие проблемы решает интеграция Wix с внешними API?

• Потеря лидов — данные с форм не попадают в CRM, менеджеры тратят время на ручной ввод.
• Рассинхронизация каталога — товары на Wix Store не обновляются вместе с учётной системой.
• Отсутствие уведомлений — о новых заказах или регистрациях никто не узнаёт вовремя.
• Ограничения Velo — время выполнения функций до 14 секунд, нельзя устанавливать любые npm-пакеты.
• Сложности с webhooks — верификация подписи JWT, обработка ошибок, повторные попытки.

Наш опыт позволяет обойти эти грабли: мы сделали десятки интеграций для Wix-сайтов разного масштаба — от простых форм до двусторонней синхронизации с ERP.

Как мы настраиваем интеграцию Wix с внешним сервисом?

Мы выбираем механизм под задачу. Ниже — сравнение основных подходов.

Velo: серверный код внутри Wix

Согласно документации Wix, функции выполняются не дольше 14 секунд. Velo позволяет писать серверные функции (jsw-файлы), которые выполняются на серверах Wix и могут обращаться к внешним API. Ключи хранятся в wix-secrets-backend — встроенном хранилище, не в коде.

// backend/crmIntegration.jsw
import { fetch } from 'wix-fetch';
import { getSecret } from 'wix-secrets-backend';

export async function syncContactToCRM(contactData) {
  const apiKey = await getSecret('CRM_API_KEY');
  const response = await fetch('https://api.yourcrm.com/v1/contacts', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      email: contactData.email,
      name: contactData.name,
      phone: contactData.phone,
      source: 'wix_website',
    }),
  });
  if (!response.ok) {
    throw new Error(`CRM sync failed: ${response.status}`);
  }
  return response.json();
}

Функции jsw вызываются с фронтенда через import:

// Клиентский код страницы
import { syncContactToCRM } from 'backend/crmIntegration';

$w('#submitButton').onClick(async () => {
  try {
    await syncContactToCRM({
      email: $w('#emailInput').value,
      name: $w('#nameInput').value,
      phone: $w('#phoneInput').value,
    });
    $w('#successMessage').show();
  } catch (err) {
    console.error('Sync error:', err);
  }
});

Этот подход мы рекомендуем, когда нужна полная гибкость: обработка ошибок, ретраи, трансформация данных. Velo в 3 раза быстрее для кастомных сценариев, чем Automations с HTTP-запросами, так как не требует дополнительных вызовов.

Wix Automations + HTTP запросы

Для простых сценариев без кода: Wix Automations (триггеры на события формы, заказа, регистрации) поддерживают действие «HTTP request». Позволяет отправить POST/GET на внешний URL. Это zero-code вариант для отправки в CRM, Zapier или n8n.

Ограничения: нет обработки ответа, нет условной логики, нет повторных попыток при ошибке. Если нужна надёжность — выбирайте Velo.

Wix Headless API: работа с данными сайта извне

Wix предоставляет REST API для доступа к коллекциям данных, заказам, контактам. Аутентификация через OAuth 2.0:

# Получение токена
curl -X POST https://www.wixapis.com/oauth2/token \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "YOUR_CLIENT_ID",
    "clientSecret": "YOUR_CLIENT_SECRET",
    "grantType": "client_credentials"
  }'

// Чтение коллекции данных через API
$response = Http::withToken($accessToken)
    ->post('https://www.wixapis.com/wix-data/v2/items/query', [
        'dataCollectionId' => 'Products',
        'query' => [
            'filter' => ['active' => true],
            'sort' => [['fieldName' => 'createdDate', 'order' => 'DESC']],
            'paging' => ['limit' => 50],
        ],
    ]);

$items = $response->json('dataItems');

Типичный кейс: внешняя CRM или ERP читает заказы из Wix для обработки, или записывает данные в кастомные коллекции сайта.

Webhooks из Wix

Wix поддерживает исходящие вебхуки для событий: новый контакт, новый заказ, изменение статуса заказа. Настройка в панели разработчика (Wix Developers → Webhooks). При наступлении события Wix отправляет POST на указанный URL.

Верификация подписи — через JWT с публичным ключом Wix:

import { verify } from 'jsonwebtoken';
import jwksClient from 'jwks-rsa';

const client = jwksClient({
  jwksUri: 'https://www.wix.com/.well-known/jwks.json',
});

async function verifyWixWebhook(token) {
  const decoded = verify(token, async (header, cb) => {
    const key = await client.getSigningKey(header.kid);
    cb(null, key.getPublicKey());
  });
  return decoded;
}

Без верификации можно получить поддельные запросы — мы всегда реализуем проверку подписи.

Как избежать потери лидов при интеграции Wix?

Главная причина — отсутствие автоматической передачи данных. Лиды остаются в Wix, менеджеры копируют их вручную. Решение: настроить Velo-функцию, которая при отправке формы отправляет данные в CRM. Дополнительно добавляем вебхук на новый контакт — если Velo не сработал, данные уходят через webhook. Это даёт 99,9% гарантии попадания.

Почему Velo не всегда достаточен?

Velo — мощный инструмент, но у него есть ограничения: время выполнения 14 секунд, память 256 MB, отсутствие внешних модулей. Если нужно обработать массовый импорт или тяжёлую логику, лучше использовать Wix Headless API: внешний сервис сам читает данные из Wix и синхронизирует их. Например, при синхронизации каталога в 1000 товаров Velo может не уложиться в таймаут, а Headless API справится за несколько запросов.

Процесс работы: от задачи до деплоя

1. Аналитика — разбираем текущие бизнес-процессы, точки интеграции, объём данных. Составляем схему потоков.
2. Проектирование — выбираем механизм (Velo, Automations, Headless, webhook), продумываем обработку ошибок и квот.
3. Реализация — пишем код, настраиваем секреты, тестируем на песочнице Wix.
4. Тестирование — проверяем сценарии: успех, таймаут, дубликаты, потеря соединения.
5. Деплой — публикуем сайт, мониторим синхронизацию первые сутки.

Средний срок: от 2 часов до 3 дней в зависимости от сложности.

Что входит в нашу работу

• Документация — описание настроенной интеграции, схема данных, инструкция для вашей команды.
• Код — jsw-функции, конфигурация webhook-приёмника, примеры вызовов.
• Доступы — создание и передача API-ключей, настройка секретов в Wix.
• Обучение — короткая демонстрация работы интеграции для ваших менеджеров.
• Поддержка — 14 дней после запуска: исправляем инциденты, отвечаем на вопросы.

Типовые ошибки и решения

Стоимость и сроки

Стоимость рассчитывается индивидуально после анализа задачи. Ориентир:

• Простая интеграция (форма → CRM) — от 2 часов.
• Двусторонняя синхронизация каталога — от 1 дня.
• Комплексное решение с несколькими сервисами — до 5 дней.

Мы гарантируем стабильную работу и своевременный запуск. У нас за плечами более 50 интеграций Wix с CRM, платёжными системами и маркетинговыми платформами.

Свяжитесь с нами — обсудим вашу задачу и подберём оптимальное решение. Получите консультацию.