WhatsApp API для интернет-магазинов и продавцов Kaspi

Сценарии

Заказ принят

Событие — новый заказ на сайте или в кабинете продавца Kaspi. Сообщение: номер заказа, состав, когда соберёте и привезёте. Покупатель отвечает, если что-то не так: «можно на другой адрес?» или «добавьте ещё одну упаковку». Ответ приходит вебхуком — обработчик кладёт его в карточку заказа, а менеджер видит его на телефоне.

Нет нужного товара — предложить замену

Событие — при сборке выяснилось, что синего цвета нет. Вместо звонка, который покупатель может пропустить, уходит вопрос: «Синего нет, есть чёрный — заменить? Ответьте „да“ или „нет“». Короткий ответ легко разобрать программно, всё остальное — передать человеку.

Передан в доставку или готов к самовывозу

Событие — смена статуса в учётной системе. Для доставки — дата и окно, для самовывоза — адрес, часы работы и что взять с собой. Типичный ответ: «до скольки вы работаете в субботу?» — на такие вопросы может отвечать и ИИ-ассистент.

Счёт и документы для юрлиц

Событие — заказ от компании на сайте. Магазин отправляет счёт файлом PDF, после оплаты — накладную. Покупатель пишет «оплатили, ждём» — бухгалтер сверяет поступление. Как отправлять файлы и фото — в гайде о вложениях.

Вопросы до покупки

Здесь первым пишет покупатель: «есть 42 размер?», «сколько доставка в Шымкент?». Вебхук message передаёт вопрос в CRM или в рабочий чат менеджеров, ответ уходит через API или с телефона. Диалоги, которые начинают клиенты, к тому же повышают индекс доверия номера.

Как подключить

События берутся там, где живут заказы:

• Kaspi. Вебхуков для продавцов у Kaspi нет, поэтому заказы забирают по таймеру — раз в 5–10 минут запрашивают GET /orders в API Магазина с токеном из кабинета продавца. Пошагово — в гайде уведомления о заказах Kaspi.
• WooCommerce. В настройках магазина есть вебхуки на создание и обновление заказа — см. интеграцию с WooCommerce.
• 1С или CRM. При смене статуса документ или сделка вызывает HTTP-запрос: 1С, amoCRM.

Отправка — один запрос POST /messages/send. Счёт уходит так же, только вместо text — поле file со ссылкой, которая открывается без авторизации:

{
  "to": "77011234567",
  "file": { "url": "https://shop.kz/invoices/1209.pdf", "filename": "Счёт №1209.pdf", "caption": "Счёт на 45 000 ₸" }
}

Ответы покупателей приходят событием message, статусы доставки — message.ack (подробно — в документации по вебхукам). Код пишет ваш разработчик: нужен только HTTP, библиотеки не нужны. Без программиста связку собирают в n8n или Make: приём вебхука от магазина и HTTP-запрос к wapi.kz. Можно и оставить заявку в кабинете — типовую интеграцию настроим.

Что важно учесть

• Пишите только по заказу. Покупатель оставил телефон, чтобы узнать о покупке, а не получать рекламу. Для заказов с Kaspi это вдвойне важно: без рекламы и попыток увести покупателя с площадки — сверьтесь с правилами Kaspi для продавцов.
• Каждый новый покупатель — новый контакт. На базовом уровне номер отправляет до 150 первых сообщений новым людям в сутки и до 1 000 сообщений всего, первые сообщения новым — не чаще раза в 5 секунд. Первые две недели после подключения — прогрев: в дни 1–3 до 20 новых контактов в сутки, в дни 4–7 до 40, в дни 8–14 до 80. Подробно — в разделе о лимитах.
• Пиковые часы. Если за час появилось 40+ новых контактов, первые сообщения новым людям приостанавливаются на 24 часа. Для десятков заказов в день это не проблема, для сотен в час на распродаже — повод посмотреть на официальный API.
• Пусть покупатель напишет первым. Кнопка «Написать в WhatsApp» на сайте и в письме с заказом — и уведомления уходят в уже начатый диалог.
• Человек рядом с автоматикой. Если менеджер ответил с телефона, придёт событие message.out, а в истории у сообщения будет source: "phone". Не перебивайте его автоматическими сообщениями.
• Риск блокировки есть. Подключение неофициальное, и жалобы «это спам» — главная причина блокировок. Как снизить риск — в гайде как не получить бан.

Сколько стоит

9 900 ₸ в месяц за номер, списание по дням — 330 ₸ в сутки. Платы за сообщения нет: уведомления о десяти заказах и о тысяче стоят одинаково. Баланс пополняется через Kaspi или по счёту на ТОО/ИП от 1 000 ₸. Подробнее — на странице цен, подключить номер — после регистрации.