Zalo-бот
Как подключить бота Zalo к Lalexi: создать его в Zalo Bot Creator на телефоне и вставить токен.
Zalo подключается ботом: вы создаёте его в приложении Zalo и отдаёте Lalexi токен. Личных аккаунтов Zalo мы не подключаем.
Что нужно
- Приложение Zalo на телефоне: бота создают только в нём.
- Верифицированный аккаунт Zalo — без подтверждения личности бот не создастся.
- Свободный слот в лимите подключений.
Создайте бота
- На телефоне откройте zalo.me/s/botcreator — ссылка запускает Zalo Bot Creator внутри приложения Zalo.
- Следуйте подсказкам на экране. Если аккаунт ещё не проходил верификацию, Zalo попросит подтвердить личность — пройдите её и вернитесь к созданию.
- Задайте имя бота. Zalo требует, чтобы оно начиналось со слова
Bot— например,Bot LalexiDemo. - Готового бота и токен пришлёт в чат аккаунт Zalo Bot Manager.
Токен выглядит как длинная строка вида
1234567890123456789:AbCd....
Ссылка на бот-креатор работает только на телефоне: она ведёт в приложение, и браузер на компьютере вместо бот-креатора предложит установить Zalo. Бот уже есть — токен лежит в чате с Zalo Bot Manager, в сообщении о его создании.
Как подключить
- Скопируйте токен из чата с Zalo Bot Manager.
- В Lalexi откройте Главная → Подключения и нажмите Zalo Bot — откроется вкладка с формой.
- Вставьте токен и нажмите Connect.
- Когда появится «Connected», закройте вкладку и вернитесь в Lalexi: подключение появится со статусом Подключено.
Токен — это полный доступ к боту: кто им владеет, тот и пишет от имени бота. Lalexi хранит его в зашифрованном виде и использует только для приёма и отправки сообщений. Если токен утёк — перевыпустите его в Zalo Bot Manager и подключите бота заново.
Что бот умеет и чего не умеет
Ограничения тут не наши, а самой платформы Zalo:
- Отвечает только тем, кто написал первым — бот не может начать разговор. Поэтому канал недоступен в «Начать диалог», рассылках и прогреве.
- Нет списка чатов и истории. Диалог появляется в Lalexi сам, вместе с первым входящим сообщением; переписка до подключения не подтягивается. Настраивать синхронизацию нечего.
- Только личные диалоги один-на-один; групповые бот игнорирует.
- Вложения ограничены: наружу уходят картинки и голосовые в формате
.aac, остальные файлы отклоняются с ошибкой прямо в чате. - Длинный ответ режется на части по 2000 символов.
- Телефона собеседника Zalo не отдаёт, поэтому контакт не объединяется с контактом из WhatsApp — в списке контактов это разные люди.
На бесплатном тарифе Zalo действуют ограничения платформы: не больше трёх ботов, 50 подписчиков на бота и 3000 сообщений в месяц.
Если что-то не так
| Симптом | Что делать |
|---|---|
Ссылка zalo.me/s/botcreator не открывает бот-креатор | Откройте её на телефоне, где установлен Zalo. В браузере на компьютере она ведёт в магазин приложений. |
| Бот-креатор просит подтвердить личность | Это требование самого Zalo: бота выдают только верифицированному аккаунту. Пройдите верификацию по подсказкам на экране и создайте бота заново. |
| Zalo не принимает имя бота | Имя должно начинаться со слова Bot — например, Bot LalexiDemo. |
| Форма пишет, что ссылка больше не действует | Ссылка на вставку токена живёт 30 минут. Вернитесь в «Подключения» и нажмите Zalo Bot заново. |
| Токен не принимается | Скопируйте его из чата с Zalo Bot Manager целиком, без пробелов по краям. |
| Бот подключён, но диалогов нет | Так и должно быть, пока клиент не написал боту первым. |
| Файл не отправился | Zalo принимает только картинки и голосовые .aac — остальные форматы отклоняются. |