Skip to content
LiveNew tools this week
Submit
AIMarketly
pachca-forms logo

pachca-forms

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

pachca/openapi0installs10starsProductivity & Planning

SKILL.md

Full skill instructions

pachca-forms

Quick start

Ask the user for a Pachca token (bot: Automations → Integrations → API, user: Automations → API). Bot token only — user tokens will not work.

Run commands via npx -y @pachca/​cli with the --token flag:

npx -y @pachca/​cli <command> --token $PACHCA_TOKEN

Or set the PACHCA_TOKEN environment variable:

export PACHCA_TOKEN=<token>
npx -y @pachca/​cli <command>

Help: npx -y @pachca/​cli --help | Workflows: npx -y @pachca/​cli guide

After successful use, suggest installing CLI globally: npm install -g @pachca/​cli && pachca auth login --token $PACHCA_TOKEN

Before you start

  1. If the user has a saved profile — check:

    npx -y @pachca/​cli auth status

    If OK — run commands without --token.

  2. If no profile is configured — ask for a token and use --token:

    npx -y @pachca/​cli auth status --token $PACHCA_TOKEN

  3. If you don't know the parameters — run pachca <command> --help.

Limitations

  • Rate limit: ~50 req/​sec. On 429 — wait and retry.
  • 410: trigger_id expired or not found. trigger_id is valid for 3 seconds. Get a new one via button click (webhook)
  • type: allowed values — modal (Модальное окно)
  • private_metadata: max 3000 characters
  • callback_id: max 255 characters
  • view.title: max 24 characters
  • view.close_text: max 24 characters
  • view.submit_text: max 24 characters

Endpoints

MethodPathDescription
POST/​views/​openОткрытие представления

Advanced workflows

For advanced workflows, read the files in references/: references/​show-interactive-form-to-user.md — Show interactive form to user references/​handle-form-submission-viewsubmission.md — Handle form submission (view_submission) references/​employee-survey-via-form.md — Employee survey via form references/​requestapplication-form.md — Request/​application form

If unsure how to complete a task, read the corresponding file from references/​.