РусскийВопросы и ответы

Вопросы и ответы

Постбэки

Постбэк не отправляется

Проверьте по этому списку:

  1. Событие произошло в рамках окна отписки? Выход после окна (cancel / trash) постбэк не отправляет. Проверьте настройку окна отписки в вашей кампании.
  2. Кампания активна? Приостановленные кампании не создают новые лиды и не отправляют постбэки. При необходимости возобновите её.
  3. URL постбэка публично доступен? Мы блокируем приватные/локальные IP-адреса и схемы, отличные от http(s). Ваш трекер должен находиться на публичном хосте.
  4. В диплинке есть плейсхолдер {click}? Если диплинк не содержит макрос идентификатора клика вашего трекера, клик окажется пустым, и трекер не сможет сопоставить постбэк.
  5. Настроен глобальный постбэк? Если в кампании нет собственных постбэков, используются глобальные шаблоны из Профиля. Убедитесь, что хотя бы один из двух вариантов настроен.

Как работает трекинг


Трекер не находит клик / «неизвестный клик»

Либо:

  • Вы забыли заменить {click} в диплинке на собственный макрос идентификатора клика трекера (например, {subid} для Keitaro, {clickid} для Binom), либо
  • Трафик шёл прямо на диплинк, минуя редирект вашего трекера — идентификатор клика так и не был подставлен.

Убедитесь, что трафик поступает через ссылку кампании вашего трекера, которая подставляет идентификатор клика перед редиректом на диплинк.

Интеграция с трекером


Постбэки cancel и trash не приходят

Оба отправляются только в рамках окна отписки после вступления подписчика. Выход после окна всё равно переводит лид в cancel / trash, но постбэк не отправляется. Увеличьте окно отписки в редакторе кампании, если хотите более долгое (или бесконечное) окно.


Лиды и подписчики

Органические вступления не отображаются как лиды

По задумке. У подписчика, который вступил в ваш чат без запуска бота через диплинк, нет идентификатора клика — поэтому лид не создаётся и постбэк не отправляется. Такие органические вступления отображаются только в Журнале активности.


Подписчик вернулся — что происходит с лидом?

Существующий лид возвращается в статус approve, и постбэк approve отправляется снова. Если подписчик запустил бота ещё раз с новым кликом, идентификатор клика лида обновляется, и постбэк wait отправляется снова. Второй лид не создаётся.

Лиды


В чём разница между cancel и trash?

cancel — подписчик покинул добровольно (нажал «Покинуть» / отписался).
trash — подписчик был исключён или заблокирован администратором.

Оба учитывают окно отписки, оба переводят лид из approve.


Боты и чаты

Бот потерял права администратора — что делать?

Когда бот теряет права администратора в чате, он перестаёт получать события вступления/выхода для этого чата. Затронутые кампании помечаются (⚠️) и вы получаете уведомление от @altercpatopbot.

Для исправления: повысьте бота до администратора в Telegram-канале/группе. Кампании возобновятся автоматически после восстановления прав.

Боты


Чат не появляется в редакторе кампании

Ваш бот должен быть администратором чата. У Telegram нет API «список моих чатов» — мы узнаём о чате в момент добавления бота или повышения его до администратора. Повысьте бота в канале/группе, затем обновите редактор кампании.


Оплата и тарифы

Бесплатный vs платный — в чём реальная разница?

Тарифы отличаются только одним: количеством активных кампаний, которые вы можете вести.

ТарифАктивные кампанииЦена
Kitten1Бесплатно
Kitty15$24 / 30 дней
TigerБез ограничений$88 / 30 дней

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

Оплата и тарифы


Что происходит, когда тариф заканчивается?

  • Сразу: доступ к кабинету закрывается.
  • +7 дней: публичный API перестаёт работать (ошибка unpaid).
  • +7 дней: активные кампании автоматически приостанавливаются (но не удаляются).

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


API и профиль

Как сменить API-ключ?

Нажмите Обновить на странице Профиля. Старый ключ перестаёт работать немедленно. Обновите все скрипты и интеграции перед заменой.

Профиль и API-ключ


В чём разница между API-ключом и токеном передачи?

  • API-ключ — ваши учётные данные для User API. Используйте его в программных интеграциях.
  • Токен передачи — односторонний идентификатор, который вы делитесь с тем, кто хочет передать вам бота или кампанию. Он находится на странице Передача и не имеет отношения к доступу по API.