Инструмент: get_subscription_status
Инструмент get_subscription_status показывает статус вашей подписки: тариф, дату окончания, дату следующего списания 🧪, а также сколько активностей вы запустили за текущий период подписки и когда была последняя.
Зачем нужен именно этот инструмент#
В отличие от get_user_plan (общая карточка тарифа и лимитов, без отдельной статьи в базе знаний), get_subscription_status сфокусирован на самой подписке и её жизненном цикле - используется, когда речь идёт об истечении, продлении или о том, стоит ли что-то запускать до конца периода.
Что показывает#
| Поле | Описание |
|---|---|
| Тариф | Название плана и стоимость в 🧪/мес |
| Дата окончания | UserSubscription.EndDate, если задана |
| Следующее списание | UserSubscription.NextBillingDate, если задана |
| Запущено активностей за период | Считается с начала текущего периода подписки, только реально запущенные (не черновики) |
| Дата последней активности | Последняя запущенная активность (любой период) |
Стоимость называется только в 🧪 - рублей в ответе нет.
Как вызвать#
- «Когда у меня заканчивается подписка?»
- «Когда следующее списание за тариф?»
- «Сколько активностей я запустил в этом периоде?»
Требования#
- Авторизация: требуется.
Связанные механики#
Если подписка скоро продлится, а активностей за период не было ни одной, агент может предложить не скидку, а собрать первую активность за вас - это отдельный проактивный сценарий (скилл churn_save), а не ответ на прямой вопрос.