Что понадобится
- Сайт, подключённый к нашему сервису, на платном тарифе (Базовый, Стандарт, Элитный или Корпоративный). Если вы ещё этого не сделали, зарегистрируйтесь по e-mail и введите адрес своего сайта.
- API-ключ: в личном кабинете откройте раздел Мессенджеры и API, задайте ключу название (например, «AstrBot») и нажмите Создать API-ключ. Сразу скопируйте его: ключ показывается только один раз.
- Запущенный AstrBot (или другой инструмент), подключённый к вашему мессенджеру. Как установить AstrBot и подключить Discord, Telegram, Slack, WeChat или QQ, описано в его собственной документации.
Вот три значения, которые запрашивает любой инструмент:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantНастройка в AstrBot
- Откройте панель управления AstrBot и перейдите в Providers. На вкладке Chat Completion нажмите + Add рядом с Provider Sources.
- В окне New model provider выберите OpenAI Compatible.
- Задайте понятный вам ID, например
7x24hrs. Вставьте ключ в поле API Key, а в API Base URL укажитеhttps://7x24hrs.com/v1. - Нажмите Save And Fetch Models. В разделе Available Models нажмите + рядом с
7x24hrs-assistant. В открывшемся окне оставьте отмеченным только Text в Model capabilities (снимите отметки с Image, Audio и Tool use: ассистент отвечает текстом) и нажмите Save. - Сделайте её моделью вашего бота: в Config выберите её как модель чата по умолчанию (или выберите её для одного разговора переключателем моделей в Chat).
- Задайте вопрос на странице Chat в AstrBot или в подключённом мессенджере. Ответ придёт по данным вашего сайта.
Оставьте персону и системный промпт в самом AstrBot пустыми или сделайте их короткими: ассистент следует правилам и персонажу из личного кабинета 7x24hrs и не выполняет инструкции из системного промпта бота в мессенджере.
Dify, LobeChat и другие инструменты
Любой инструмент с провайдером «OpenAI-совместимый» или «собственный OpenAI» настраивается так же: Base URL https://7x24hrs.com/v1, ваш API-ключ и модель 7x24hrs-assistant.
- Dify: в Settings → Model Provider добавьте OpenAI-API-compatible, введите название модели, ключ и Base URL в качестве адреса API, затем выберите модель в своём приложении.
- LobeChat: в настройках, в разделе языковых моделей, включите провайдера OpenAI, введите ключ и укажите Base URL как адрес API-прокси, затем добавьте
7x24hrs-assistantв список моделей. - Собственный код: обращайтесь к API через любую клиентскую библиотеку OpenAI, указав base URL и ключ.
Проверить API из терминала:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'С "stream": true ответ приходит в виде server-sent events, так же как у OpenAI:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Как работают ответы в мессенджерах
| Кнопка чата на вашем сайте | Мессенджер через API | |
|---|---|---|
| Откуда берёт ответы | Данные вашего сайта, готовые ответы и персонаж | Оттуда же |
| Если не уверен | Говорит об этом и передаёт посетителя вам | Говорит об этом и указывает в ответе ваш контактный адрес |
| Уведомления вам | По e-mail, в Slack, Discord или Telegram | Так же, с пометкой «через API / AstrBot» |
| Ответить посетителю самому | Из вашего мессенджера или личного кабинета | Отсюда нельзя: ответьте по e-mail |
| Учёт разговоров | Один на посетителя и разговор | Так же, из того же месячного лимита |
В какие тарифы входят мессенджеры?
Во все платные: Базовый за $19 в месяц — 90 разговоров, Стандарт за $59 — 275, Элитный за $199 — 1 000 и Корпоративный за $1,099 — 6 000. Разговоры через API учитываются в том же месячном лимите, что и в кнопке чата. Бесплатный тариф не включает мессенджеры: созданные на нём ключи приостановлены, пока вы не выберете платный тариф. Подробнее — в разделе цены.
Что считается разговором?
Один посетитель в чате, сколько бы вопросов он ни задал, — точно так же, как в кнопке чата. Если инструмент передаёт с каждым запросом поле user, мы различаем посетителей по нему; иначе разговор определяется по первому сообщению.
Может ли системный промпт в AstrBot изменить ответы ассистента?
Нет. Системные промпты, которые присылает бот в мессенджере, не выполняются. Ассистент соблюдает ваши правила: отвечает только по данным вашего сайта, честно говорит, когда не знает, и не обещает ничего, чего нет на вашем сайте. Его персонаж — тот, что вы задали в личном кабинете.
Поддерживаются ли картинки, голосовые сообщения и вызовы инструментов?
Пока нет. Ассистент отвечает на текст; картинки и другие вложения из сообщения отбрасываются, а на сообщение без текста приходит понятная ошибка. Описания инструментов, присланные клиентом, игнорируются.
Что делать, если ключ утёк?
Отзовите его в разделе Мессенджеры и API: он сразу перестанет работать. Затем создайте новый и вставьте его в свой инструмент. Мы храним ключи только в виде отпечатка, поэтому и мы не можем показать ключ повторно.