Частые вопросы: технические

A: Возможные причины и решения:

1. Токен неверный: Убедитесь, что скопировали токен полностью, без пробелов. Токен выглядит как 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.
2. Бот заблокирован: Проверьте, не заблокирован ли бот в Telegram (напишите /start в чате с ботом).
3. Вебхук не настроен: Salebot автоматически настраивает вебхук. Проверьте статус подключения в личном кабинете Salebot.
4. Ограничения Telegram: Убедитесь, что бот не находится в стране, где Telegram заблокирован (используйте VPN или прокси).

Диагностика: В личном кабинете Salebot перейдите в "Интеграции → Telegram" и нажмите "Проверить соединение". Система покажет подробный отчёт.

A: Процесс состоит из 4 шагов:

1. Создание бизнес-аккаунта: В Facebook Business Manager создайте аккаунт WhatsApp Business.
2. Получение токенов: В разделе WhatsApp API получите Phone Number ID, Business Account ID и Permanent Access Token.
3. Настройка в Salebot: Введите эти данные в "Интеграции → WhatsApp".
4. Верификация шаблонов: Создайте и отправьте на модерацию шаблоны сообщений (занимает 1-3 дня).

Подробная инструкция: Интеграция с WhatsApp.

A: Да, Salebot поддерживает мультиканальность. Вы можете подключить один и тот же бот к нескольким мессенджерам одновременно. Пользователь может начать диалог в Telegram, продолжить в WhatsApp, а завершить на сайте — история диалога сохранится.

Настройка: Просто подключите все нужные каналы в разделе "Интеграции". Бот будет автоматически адаптировать сообщения под формат каждого мессенджера.

A: API-ключ генерируется в личном кабинете:

1. Перейдите: Настройки → API → Ключи доступа
2. Нажмите "Создать новый ключ"
3. Укажите название и выберите права:
   • Чтение — получение данных (боты, клиенты, статистика)
   • Запись — создание и изменение (отправка сообщений, создание ботов)
   • Управление — удаление, настройка вебхуков
4. Скопируйте ключ (он покажется только один раз!)

Подробнее: Аутентификация в API.

A: Лимиты зависят от тарифного плана:

• Бесплатный: 100 запросов в минуту
• Старт: 500 запросов в минуту
• Профессиональный: 2000 запросов в минуту
• Корпоративный: 10000 запросов в минуту

При превышении лимита возвращается ошибка 429 Too Many Requests. Рекомендуем реализовать exponential backoff при обработке этой ошибки.

Лимиты считаются по аккаунту, а не по ключу. Все ключи одного аккаунта делят общий лимит.

A: Вебхуки настраиваются через API или личный кабинет:

1. Перейдите: Настройки → API → Вебхуки
2. Нажмите "Добавить вебхук"
3. Укажите URL вашего сервера (должен быть HTTPS)
4. Выберите события:
   • message.received — новое сообщение от пользователя
   • message.sent — сообщение отправлено ботом
   • client.created — создан новый клиент
   • order.created — создан новый заказ
   • и другие
5. Нажмите "Сохранить"

Salebot будет отправлять POST-запросы с данными события на ваш URL. Подробнее: Вебхуки.

A: Пропускная способность зависит от тарифа и типа сообщений:

• Бесплатный: до 10 сообщений в секунду
• Старт: до 50 сообщений в секунду
• Профессиональный: до 200 сообщений в секунду
• Корпоративный: до 1000 сообщений в секунду

Эти лимиты включают входящие и исходящие сообщения. Если вы ожидаете пиковые нагрузки (например, массовая рассылка), рекомендуется использовать асинхронную отправку и дозирование.

Пример: При рассылке 100 000 сообщений отправляйте партиями по 500 в секунду, а не все сразу.

A: Нет, Salebot не ограничивает количество клиентов или сообщений. Вы можете хранить:

• Неограниченное количество клиентов
• Полную историю всех диалогов
• Все заказы и транзакции

Однако для производительности рекомендуется:

1. Архивировать старые диалоги (более 2 лет) если они не нужны для повседневной работы
2. Использовать фильтры и поиск вместо полного перебора
3. Экспортировать данные в вашу аналитическую систему для долгосрочного хранения

A: Salebot использует горизонтальное масштабирование и автоматическое увеличение ресурсов при нагрузке. Однако рекомендуем:

1. Заблаговременно: Уведомить поддержку о планируемых пиковых нагрузках
2. Оптимизировать диалоги: Упростить сложные сценарии, убрать тяжёлые API-запросы
3. Использовать кэширование: Кэшировать ответы на частые вопросы
4. Настроить fallback: При высокой нагрузке показывать сообщение "Сервис временно перегружен, попробуйте позже"

Корпоративные клиенты могут заказать выделенные серверы для гарантированной производительности.

A: Эта ошибка означает, что в процессе выполнения сценария произошла непредвиденная ошибка. Действия:

1. Проверьте логи: В личном кабинете перейдите "Аналитика → Логи ошибок". Там будет подробная информация.
2. Посмотрите на сценарий: Возможно, в конструкторе есть блок, который пытается обратиться к недоступному API или использует несуществующую переменную.
3. Упростите сценарий: Если ошибка происходит в сложном сценарии, разбейте его на части и протестируйте каждую отдельно.
4. Обратитесь в поддержку: Если не можете определить причину, отправьте ID ошибки (указывается в логах) в поддержку.

Профилактика: Всегда тестируйте сценарии в "Песочнице" перед публикацией.

A: Задержки могут быть вызваны:

• Ограничения мессенджеров: Telegram, WhatsApp, VK имеют свои лимиты на отправку сообщений. Salebot соблюдает эти лимиты, чтобы не получить блокировку.
• Высокая нагрузка: Если вы отправляете много сообщений одновременно, они ставятся в очередь.
• Медленные API-запросы: Если в сценарии есть блоки, которые делают запросы к внешним API с большим временем ответа.
• Проблемы сети: Редко, но возможны задержки из-за проблем с интернет-соединением.

Решение: Проверьте статус мессенджеров (например, status.telegram.org), упростите сценарии, используйте асинхронные запросы.

A: Эта ошибка означает, что мессенджер не может доставить сообщение на вебхук Salebot. Причины:

1. Salebot недоступен: Редко, но возможно временное отключение серверов. Проверьте status.salebot.pro.
2. Firewall/антивирус: Блокирует исходящие соединения с серверов мессенджера. Попробуйте отключить на время тестирования.
3. Неверный URL вебхука: Убедитесь, что в настройках мессенджера указан правильный URL вебхука (должен быть HTTPS).
4. Просроченный SSL-сертификат: Если вы используете self-hosted Salebot, проверьте актуальность SSL-сертификата.

Решение: В личном кабинете Salebot перейдите в "Интеграции", выберите проблемный канал и нажмите "Переподключить". Salebot попытается восстановить вебхук.

A: Веб-виджет настраивается в личном кабинете:

1. Перейдите: Виджеты → Веб-чат
2. Настройте:
   • Цвета: основной цвет, цвет текста, цвет кнопки
   • Положение: слева/справа, отступ от края
   • Текст: приветственное сообщение, placeholder в поле ввода
   • Аватар: загрузите изображение для бота
   • Время работы: когда виджет активен
3. Скопируйте код и вставьте на ваш сайт перед закрывающим тегом

Изменения вступят в силу сразу после обновления страницы сайта.

A: Да, Salebot поддерживает мультиязычность несколькими способами:

1. Отдельные боты для каждого языка: Создайте копии бота с переведённым контентом.
2. Условные блоки по языку: В одном боте используйте блок "Условие" для определения языка пользователя и ветвления.
3. Динамическая подстановка: Храните переводы в переменных или внешней базе, подставляйте нужный вариант.

Рекомендация: Для простоты начните с отдельных ботов. Когда наберётесь опыта, переходите к условным блокам.

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

A: Есть несколько вариантов:

1. Автоматическая передача: Настройте условие (например, если пользователь написал "оператор" или 3 раза ответил "не понял").
2. Кнопка "Связаться с оператором": Добавьте в диалог кнопку, которая создаёт задачу в CRM и передаёт диалог оператору.
3. По расписанию: В нерабочее время бот может сказать "Сейчас операторов нет, оставьте заявку, и мы перезвоним утром".

Интеграция с CRM: При передаче оператору Salebot может:

• Создать задачу в CRM (Bitrix24, amoCRM)
• Отправить уведомление в Telegram оператору
• Передать всю историю диалога
• Указать приоритет (срочно/обычный)