💡 Зачем нужна эта интеграция
Связка WhatsApp и ЮKassa превращает мессенджер в полноценный канал продаж и приема платежей. Клиент общается с менеджером или чат-ботом в привычном приложении и получает ссылку на оплату прямо в диалоге. После оплаты он сразу видит подтверждение, а компания не тратит время на ручную проверку поступлений. Это особенно полезно для онлайн-школ, сферы услуг, интернет-магазинов, студий и сервисов с записью, где решение о покупке часто принимается в переписке.
Автоматизация закрывает несколько типичных проблем. Менеджерам больше не нужно вручную выставлять счета, копировать ссылки и сверять платежи в личном кабинете ЮKassa. Клиенты получают напоминания о неоплаченных заказах, подтверждения успешной оплаты, информацию о доступе к курсу или дате доставки, а при необходимости уведомления о возврате. Это сокращает время между «согласен купить» и «оплатил», снижает долю брошенных заказов и уменьшает число ошибок, например когда оплату приняли, а клиенту забыли об этом сообщить. Все события по платежам попадают в CRM или таблицу, поэтому руководитель видит прозрачную воронку от первого сообщения до денег на счете.
Важно учитывать, что у WhatsApp и ЮKassa нет единой кнопочной интеграции «из коробки». Связь настраивается через платформы-коннекторы, такие как Make, Zapier или APIX-Drive, либо через виджеты и модули из маркетплейсов CRM (например, Bitrix24, amoCRM, Wazzup, GreenAPI). Если в выбранном коннекторе нет готового модуля ЮKassa, используют универсальные HTTP-запросы и вебхуки: ЮKassa поддерживает API и HTTP-уведомления, а WhatsApp Business API или сервисы-провайдеры принимают запросы на отправку сообщений. В итоге схема работает автоматически: создается платеж, клиенту уходит ссылка, а при смене статуса платежа отправляется уведомление.
🛠️ Как настроить интеграцию
- **Подготовьте доступы в обоих сервисах.** В личном кабинете ЮKassa подключите магазин и в разделе «Интеграция → Ключи API» получите `shopId` и секретный ключ. Для тестов используйте тестовый магазин. Для WhatsApp подключите WhatsApp Business API через официального провайдера (например, 360dialog, Twilio, Wazzup, Green API) или через CRM с поддержкой WhatsApp, а также получите токен или ключ доступа. Заранее создайте и согласуйте в WhatsApp шаблоны сообщений: «Ваша ссылка на оплату», «Оплата получена», «Платеж отменен». Без шаблонов нельзя писать клиенту первым или после 24 часов с его последнего сообщения.
- **Выберите платформу-коннектор и создайте сценарий.** Откройте Make, Zapier или APIX-Drive и создайте новый сценарий. Если нужна сквозная автоматизация, подключите CRM или источник заказов (amoCRM, Bitrix24, Google Sheets, форма на сайте) как триггер, например «новая сделка» или «клиент выбрал товар». В APIX-Drive ЮKassa можно выбрать как готовый сервис. В Make и Zapier, если нет нативного модуля, используйте HTTP-модуль (Make: HTTP → Make a request, Zapier: Webhooks by Zapier) и авторизацию Basic Auth с `shopId` и секретным ключом.
- **Настройте создание платежа и отправку ссылки в WhatsApp.** Первым действием отправьте в ЮKassa POST-запрос на `https://api.yookassa.ru/v3/payments` с суммой, валютой, описанием и параметром `confirmation` типа `redirect` с адресом возврата. Обязательно передайте заголовок `Idempotence-Key` с уникальным значением, чтобы избежать дублей платежей. Для чека по 54-ФЗ добавьте объект `receipt` с email или телефоном клиента и позициями заказа. В поле `metadata` сохраните номер телефона клиента и ID сделки: они понадобятся для уведомления об оплате. Из ответа возьмите `confirmation_url` и вторым действием отправьте его клиенту через WhatsApp: используйте шаблон с переменными (имя, сумма, ссылка) или обычное сообщение, если диалог открыт в пределах 24 часов.
- **Настройте обработку статусов оплаты через вебхуки.** В личном кабинете ЮKassa откройте «Интеграция → HTTP-уведомления» и укажите URL вебхука из вашего коннектора (модуль Webhooks в Make, Catch Hook в Zapier или приемник данных в APIX-Drive). Включите события `payment.succeeded`, `payment.canceled` и при необходимости `refund.succeeded`. Создайте второй сценарий. Он принимает уведомление, для надежности запрашивает актуальный статус платежа через `GET /v3/payments/{id}`, затем с помощью фильтра или роутера разделяет ветки по статусам. При успешной оплате отправьте клиенту подтверждение с номером заказа и дальнейшими шагами (доступ, доставка, время визита) и обновите статус сделки в CRM или таблице. При отмене отправьте сообщение с предложением повторить оплату или связаться с менеджером. Можно также добавить напоминание, если платеж не завершен через несколько часов.
- **Протестируйте сценарий целиком и запустите его в работу.** Сначала в тестовом магазине ЮKassa создайте платеж с тестовой картой и убедитесь, что `confirmation_url` приходит на ваш номер WhatsApp. Затем проведите оплату и проверьте, что вебхук сработал, статус в CRM изменился на «Оплачено», а клиент получил подтверждение. Отдельно проверьте отмену платежа, повторный вебхук (дубли не должны создавать вторую отправку), корректность подстановки имени и суммы в шаблон и поведение при некорректном номере телефона. Просмотрите журнал выполнения сценария в коннекторе и убедитесь, что нет ошибок авторизации и таймаут