Готовые команды

Что спросить и что сделать одной строкой — от настройки до рассылки

интеграцииcliпримеры

Обновлено 17 октября 2026 г.

Подставьте свой ключ вместо gk_ВАШ_КЛЮЧ, идентификатор своего проекта вместо <проект> и идентификатор человека или рассылки вместо <id>.

Настроить всё одной командой

Эту строку можно отдать своему AI-агенту целиком — он поставит программу и подключится:

bash

curl -fsSL https://dev.api.geckochat.app/cli/install.sh | bash && geckochat login gk_ВАШ_КЛЮЧ

Ответ с адресом и числом команд означает, что всё готово.

Узнать идентификаторы

bash

geckochat project_list --table id,name
geckochat bot_list --table id,username,status

Идентификатор проекта — первый столбец project_list. Идентификатор бота, если он понадобится, — первый столбец bot_list.

Посмотреть, как идут дела

bash

geckochat bot_list --table username,usersCount,status
geckochat order_list --projectId <проект> --limit 100 --sum amount --by currency
geckochat broadcast_list --projectId <проект> --count-by status
geckochat user_list --projectId <проект> --limit 10 --table id,firstName,lastInteractionAt

Найти человека и открыть его историю

bash

geckochat user_list --projectId <проект> --search Мария --table id,firstName,username
geckochat user_chat_timeline --projectId <проект> --userId <id>

<id> — идентификатор пользователя из первого столбца. Именно он называет человека во всех командах; Telegram ID вместо него не подходит.

Рассылка: сначала тест, потом запуск

bash

geckochat broadcast_list --projectId <проект> --limit 5 --table id,name,status
geckochat broadcast_test --projectId <проект> --broadcastId <id> --recipientTelegramId <ваш telegramId>
geckochat broadcast_start --projectId <проект> --broadcastId <id>

Попросить агента проекта сделать работу

bash

geckochat agent_send --projectId <проект> --message "Собери рассылку по тем, кто открыл оффер и не оплатил"

Команда ждёт, пока агент закончит, и печатает его ответ — тот же агент и та же переписка, что в кабинете.

Разобраться, что вообще есть

bash

geckochat --help              # весь список
geckochat --help offer        # только про офферы
geckochat offer_list --help   # аргументы конкретной команды

Имена команд английские, поэтому и подстрока для поиска английская: offer, broadcast, user, flow.

Для скриптов

bash

geckochat order_list --projectId <проект> --limit 100 --json | jq '.items[] | select(.status=="OPEN")'

--json печатает ответ одной строкой. Код возврата говорит об исходе: ноль — получилось, ненулевой — нет, и по нему видно вид отказа, поэтому if/&& в скрипте работают как обычно.