Как не получить блокировку номера WhatsApp при работе через API

Почему гарантий нет

wapi.kz подключает ваш номер как связанное устройство — так же, как работает WhatsApp Web. Это неофициальный способ: без шаблонов, модерации и платы за сообщения, но с более высоким риском блокировки, если нарушать правила WhatsApp. Чем он отличается от официального WhatsApp Business API, разобрали в гайде официальный и неофициальный WhatsApp API.

Публичных лимитов у самого WhatsApp нет, а как устроены его внутренние проверки, снаружи никто не знает. Поэтому всё, что ниже, — практика: что заметно повышает риск и как вести себя, чтобы номер выглядел живой перепиской, а не рассылкой. Наши лимиты — это наши правила, они страхуют номер от самых частых ошибок.

Что повышает риск блокировки

• Холодные массовые рассылки. Сообщения людям, которые вас не знают и не оставляли вам номер, — главная причина блокировок.
• Одинаковый текст многим. Сотня одинаковых сообщений незнакомым людям за час — типичная картина спама.
• Жалобы. Любой получатель может нажать «Заблокировать» или «Пожаловаться». Чем чаще это происходит, тем хуже для номера.
• Резкий рост объёма на новом номере. Вчера номер молчал, сегодня отправил пятьсот сообщений — это выглядит подозрительно.
• Новая SIM-карта под отправку. У свежего номера нет истории переписки, и любая активность на нём заметнее.
• Сообщения без ответа. Если вы много пишете первыми, а вам почти не отвечают, номер похож на рассыльщика.
• Несуществующие номера. Ошибки доставки из-за старой базы контактов портят репутацию номера.
• Ссылки-сокращатели. Получатель не видит, куда ведёт ссылка, и чаще считает сообщение подозрительным. Давайте полную ссылку на свой сайт.

Что снижает риск

Пишите тем, кто ждёт сообщение

Статус заказа, напоминание о записи, ответ на заявку — такие сообщения человек ждёт и не жалуется на них. Готовые сценарии — в гайдах про уведомления о заказах Kaspi и напоминания о записи.

Сделайте так, чтобы клиенты писали первыми

Диалог, который начал клиент, — самый безопасный. Поставьте кнопку «Написать в WhatsApp» на сайт, в карточку магазина, в профиль соцсетей, на визитки и чеки. Как это сделать — в гайде WhatsApp на сайте. Доля диалогов, начатых клиентами, — один из главных факторов нашего индекса доверия.

Персонализируйте

Имя, номер заказа, время записи — сообщение должно быть понятно именно этому человеку. Менять слова ради того, чтобы обойти фильтры, бессмысленно: защита от рассылок смотрит и на число новых контактов, а ненужное сообщение получатель всё равно отметит как спам.

Дайте возможность отписаться

Добавьте в уведомления строку «Не хотите получать такие сообщения — ответьте „стоп“» и действительно перестаньте писать тем, кто так ответил. Пусть лучше человек напишет «стоп», чем нажмёт «Пожаловаться».

Отвечайте людям

Входящие сообщения — признак живого номера. Подключите вебхук, чтобы ответы клиентов сразу попадали в CRM или к ИИ-агенту, и не оставляйте вопросы без ответа.

Проверяйте номер перед первой отправкой

Метод POST /contacts/check показывает, есть ли номер в WhatsApp. До 200 проверок в сутки на номер, не чаще одной в секунду. Подробности — в документации.

curl -X POST https://wapi.kz/api/v1/contacts/check \
  -H "Authorization: Bearer $WAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"77011234567"}'

Если в ответе "exists": false, не отправляйте: сообщение всё равно не дойдёт, а ошибка доставки снизит индекс доверия.

Как устроены лимиты wapi.kz

Лимиты считаются для каждого номера отдельно:

• не чаще 1 сообщения в секунду с номера;
• первые сообщения новым людям — не чаще раза в 5 секунд;
• базово — 1 000 сообщений в сутки и 150 первых сообщений новым людям;
• сутки считаются по Алматы, лимиты обновляются в полночь.

Прогрев номера: первые 2 недели

Сразу после подключения лимиты ниже и растут ступенями. Резкий рост объёма — сигнал спама, поэтому новый номер не работает на полную с первого дня. Термин подробнее — в глоссарии.

Во время прогрева действует и множитель индекса доверия. Сообщения в чат с самим собой в лимит новых контактов не идут.

Индекс доверия

Индекс от 0 до 100 показывает, насколько работа номера похожа на нормальную переписку. Он считается по последним 14 дням и учитывает:

• долю диалогов, которые начали клиенты;
• отвечают ли люди на ваши первые сообщения;
• баланс входящих и исходящих;
• объём холодных первых сообщений;
• ошибки доставки;
• сколько номер уже работает у нас.

Пока сообщений меньше ~20, действуют стандартные лимиты. Дальше индекс меняет суточные лимиты номера:

Цифры в скобках — после прогрева. Подробнее — в статье глоссария про индекс доверия.

Защита от рассылок

Если один и тот же текст ушёл 25+ новым людям за час или за час появилось 40+ новых контактов, первые сообщения новым людям приостанавливаются на 24 часа. API вернёт ошибку cold_blocked или spam_detected (HTTP 429). Отвечать тем, кто пишет вам, в это время можно. До какого момента действует пауза, видно в поле cold_blocked_until.

Где смотреть индекс и лимиты

В кабинете — на карточке номера: индекс, уровень и сколько сообщений уже ушло сегодня. По клику открывается разбор индекса по факторам с подсказками, что улучшить.

Из программы — запрос GET /limits:

curl "https://wapi.kz/api/v1/limits?from=1" \
  -H "Authorization: Bearer $WAPI_KEY"

{
  "from": { "id": 1, "phone": "77010000000" },
  "rating": 74, "tier": "good", "tier_title": "Хороший", "enough_data": true,
  "limits": { "messages_per_day": 1000, "new_contacts_per_day": 150, "checks_per_day": 200, "messages_per_second": 1 },
  "used": { "messages": 312, "new_contacts": 18, "checks": 40 },
  "cold_blocked_until": null, "warmup": false
}

Удобно проверять индекс по расписанию и получать предупреждение, если он опустился до «Среднего»: это значит, что вы много пишете первыми и вам редко отвечают. Все поля — в документации по лимитам.

Что делать, если номер заблокировали

Шаг 1. Убедитесь, что это блокировка

Откройте WhatsApp на телефоне: при блокировке приложение прямо сообщает, что номер не может пользоваться WhatsApp. Если же номер просто отключился от сервиса — например, телефон около 14 дней был без интернета или связанное устройство удалили, — переподключите его по QR-коду. Такие случаи разобраны в гайде что делать, если API не работает.

Шаг 2. Запросите проверку

Обычно на экране блокировки в приложении есть кнопка «Запросить проверку». Коротко и честно опишите, как вы используете номер: кому пишете и почему люди ждут ваших сообщений. Решение принимает только WhatsApp — мы не можем на него повлиять, и результат никто не гарантирует.

Шаг 3. Найдите причину

Выгрузите историю за последние недели через GET /export — CSV открывается в Excel — и посмотрите, что уходило с номера: холодные первые сообщения, одинаковые тексты, номера, которые не отвечали. Пока причина не устранена, новый номер повторит судьбу старого.

Шаг 4. Подключите другой номер

Добавьте новый номер в кабинете и привяжите его — как в гайде подключение WhatsApp API. Заблокированный номер удалите: со следующего дня он перестанет списываться. Новый номер снова пройдёт прогрев. Лучше взять номер, которым давно пользуются для переписки, чем только что купленную SIM-карту.

Номер стоит 9 900 ₸ в месяц, без платы за сообщения — подробнее на странице цен. Подключить номер можно примерно за 5 минут.