💡 Зачем нужна эта интеграция
Прямой «кнопочной» интеграции между ЮKassa и WhatsApp в маркетплейсах обычно нет. Связка строится через платформы-коннекторы (Make, Zapier, APIX-Drive), через CRM с готовыми виджетами (например, amoCRM или Bitrix24 вместе с поставщиком WhatsApp Business API) либо через собственный обработчик HTTP-уведомлений. Для бизнеса это не критично: ЮKassa отдает события об оплате через API и webhook, а WhatsApp Business API принимает команды на отправку сообщений.
Связка нужна, чтобы клиент получал платежную информацию там, где ему удобнее всего общаться: в мессенджере. Менеджер больше не выставляет счета вручную. Автоматизация создает платеж в ЮKassa, отправляет клиенту в WhatsApp персональную ссылку на оплату, а после успешной оплаты сразу присылает подтверждение, детали заказа или доступ к цифровому товару. Если платеж отменен или не завершен, система напоминает о нем и помогает довести сделку до конца.
Это решает сразу несколько проблем: потерю заказов из-за долгого ожидания ответа, ошибки при ручном вводе сумм и реквизитов, лишние вопросы «Вы получили мой платеж?» и задержки между оплатой и выдачей товара. Для интернет-магазинов, онлайн-школ, сервисных компаний и студий это дает рост конверсии в оплату, снижение нагрузки на поддержку и прозрачную историю коммуникации по каждой транзакции. При подключении к CRM все события (создание платежа, оплата, возврат) автоматически попадают в карточку клиента.
🛠️ Как настроить интеграцию
- **Подготовьте доступы в обоих сервисах.** В личном кабинете ЮKassa возьмите `shopId` и создайте секретный ключ (раздел «Интеграция» → «Ключи API»). Для WhatsApp подключите официальный WhatsApp Business API: напрямую через Meta Cloud API или через провайдера (Wazzup, 360dialog, Twilio, Gupshup и др.). Зарегистрируйте и согласуйте в Meta шаблоны сообщений, например «Ваш заказ №{{1}} на сумму {{2}} ₽. Оплатить: {{3}}» и «Оплата заказа №{{1}} получена, спасибо!». Шаблоны нужны для первого сообщения клиенту вне 24-часового окна диалога. Убедитесь, что у вас есть согласие клиентов на получение сообщений в мессенджере.
- **Выберите платформу-коннектор и создайте сценарий.** В Make или Zapier создайте новый сценарий, а в APIX-Drive новое подключение. В качестве источника данных возьмите вашу CRM, форму заказа или таблицу, где появляется новая заявка с номером телефона в международном формате. Если в каталоге коннектора нет готового модуля ЮKassa, используйте универсальные блоки Webhooks и HTTP. Для WhatsApp применяйте готовый модуль (например, WhatsApp Business Cloud) или HTTP-запрос к API вашего провайдера.
- **Настройте создание платежа и отправку ссылки.** Добавьте HTTP-запрос `POST https://api.yookassa.ru/v3/payments` с авторизацией Basic (`shopId` и секретный ключ) и заголовком `Idempotence-Key` с уникальным значением для каждого запроса. В теле передайте сумму, валюту RUB, описание, `confirmation.type = redirect` с `return_url` и в `metadata` номер заказа и телефон клиента. Из ответа ЮKassa возьмите `confirmation.confirmation_url` и передайте его в модуль WhatsApp: выберите шаблон «Ссылка на оплату», подставьте имя, сумму и ссылку. Если платеж создается самим сайтом или CRM, этот шаг можно заменить получением готовой ссылки.
- **Подключите уведомления об оплате и отправку подтверждения.** В Make или Zapier создайте второй сценарий с триггером Custom Webhook и скопируйте его URL. В личном кабинете ЮKassa («Интеграция» → «HTTP-уведомления») вставьте этот URL и включите события `payment.succeeded`, `payment.canceled` и при необходимости `refund.succeeded`. В сценарии добавьте фильтры по типу события. Для безопасности запросите статус платежа через `GET /v3/payments/{id}`, чтобы убедиться, что он действительно оплачен. Затем по номеру из `metadata` отправьте в WhatsApp шаблон «Оплата получена». Дополнительно обновите статус сделки в CRM, а при отмене отправьте сообщение с предложением повторить оплату.
- **Протестируйте всю цепочку и запустите в работу.** Включите в ЮKassa тестовый магазин и пройдите полный путь на тестовых данных: создайте заказ, получите сообщение в WhatsApp на свой номер, откройте ссылку и оплатите тестовой картой. Проверьте три результата: сообщение со ссылкой пришло, webhook получен, подтверждение оплаты доставлено, а статус в CRM изменился. Затем проверьте сценарии отмены платежа, повторной отправки и некорректного номера, а также историю выполнения сценария в журнале коннектора на предмет ошибок. Когда все работает, замените тестовые ключи на боевые, включите сценарии и в первые дни контролируйте доставляемость сообщений и конверсию в оплату.