Лицензии и пробный период

Каждому номеру WhatsApp нужна активная лицензия, чтобы отправлять и принимать сообщения через API. Бесплатного тарифа нет, но на каждый новый номер действует бесплатный пробный период — 7 дней.

Цены

Одна цена в долларах США за номер в месяц — одинаковая и для подключения qr, и для подключения cloud_api, и независимо от того, что вы через него отправляете.

Мы не берём плату за места, лимиты сообщений или отдельные запросы. Собственные платежи Meta за диалоги по номерам cloud_api Meta выставляет вашему аккаунту WhatsApp Business, а не мы. Активация и счета находятся по адресу https://developers.wasync.app/billing.

Слоты

Слот — это ёмкость, а не номер телефона, и он не привязывается к конкретному клиенту:

• Слот закрепляется, когда номер действительно подключается к WhatsApp. Создание записи о подключении слот не занимает до этого момента.
• Когда вы удаляете подключение, его слот возвращается в общий пул вместе с оставшимся на нём временем. Следующий подключаемый номер займёт его автоматически.
• Благодаря этому вы можете перенести оплаченный слот от ушедшего клиента к новому, не платя дважды и не обращаясь ни к кому за помощью.

Прежде чем обещать кому-то свободную ёмкость, проверьте GET /account: slots.available — это то, что POST /connections ещё может занять при активной лицензии, а slots.nextExpiry — дата, до которой нужно продлить лицензию.

Удаление номера и закрытие рабочего пространства

И то и другое вы можете сделать сами: на экране Billing консоли разработчика или через API.

• Удалить номер — DELETE /v1/connections/{id} или кнопка Delete в строке подключения. Его сессия WhatsApp закрывается, все сохранённые для него сообщения удаляются, а оплаченный слот возвращается в пул, как описано выше.
• Закрыть рабочее пространство — кнопка Close workspace у рабочего пространства, в котором не осталось подключений. Вместе с ним удаляются его API keys и настройки webhook, поэтому всё, что продолжает обращаться к API с этими ключами, перестанет работать.

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

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

Пробный период

Новый номер начинает 7-дневный пробный период в момент подключения — неважно, подключили ли вы его сканированием QR-кода или вводом кода сопряжения. Подключение по коду ничего дополнительно не расходует: тот же слот, тот же пробный период.

Когда лицензия истекает, подключение становится недоступным: оно пропадает из GET /connections, события перестают доставляться, а отправка возвращает 402.

Ограничения прогрева для новых номеров qr

У только что подключённого номера qr в течение 72 часов прогрева действуют ограничения на количество сообщений в час. При превышении возвращается 429 warmup_limited — это почасовое ограничение, поэтому повторите запрос через несколько минут и не отправляйте запросы в бесконечном цикле.

Это отдельный ограничитель, не связанный с ограничителем злоупотреблений, который возвращает 429 rate_limited. Учитывайте Retry-After, если он есть, но всегда задавайте собственную паузу по умолчанию: заголовок возвращается не при каждом ответе 409/429.