bitrix24-agent

Bitrix24 Agent (Lean + Reliable)

Use this skill to deliver correct Bitrix24 integrations with low token usage and production-safe defaults.

Quick Start

Use this flow unless the user asks for a different one:

1. Pick intent + one minimal pack (core by default).
2. Run a read probe first.
3. For writes, use plan then execute with confirmation.

Read probe:

python3 skills/bitrix24-agent/scripts/bitrix24_client.py user.current --params '{}'

Safer write flow:

python3 skills/bitrix24-agent/scripts/bitrix24_client.py crm.lead.add \
  --params '{"fields":{"TITLE":"Plan demo"}}' \
  --packs core \
  --plan-only

python3 skills/bitrix24-agent/scripts/bitrix24_client.py \
  --execute-plan <plan_id> \
  --confirm-write

Runtime Prerequisites

Required environment:

• B24_DOMAIN
• B24_AUTH_MODE = webhook or oauth

Webhook mode:

• B24_WEBHOOK_USER_ID
• B24_WEBHOOK_CODE

OAuth mode:

• B24_ACCESS_TOKEN
• B24_REFRESH_TOKEN
• B24_CLIENT_ID and B24_CLIENT_SECRET (for --auto-refresh)

Useful safety/reliability flags:

• B24_REQUIRE_PLAN=1 for mandatory plan->execute on write/destructive calls
• B24_PACKS=core,... for default pack set
• B24_RATE_LIMITER=file with B24_RATE_LIMITER_RATE and B24_RATE_LIMITER_BURST

Default Mode: Lean

Apply these limits unless the user asks for deep detail:

• Load at most 2 reference files before first actionable step.
• Start from references/packs.md.
• Then open only one target file: references/catalog-<pack>.md.
• Open references/chains-<pack>.md only if the user needs workflow steps.
• Open references/bitrix24.md only for auth architecture, limits, event reliability, or unknown errors.

Response limits:

• Use concise output (goal + next action + one command).
• Do not retell documentation.
• Do not dump large JSON unless requested.
• Save your own tokens on reads: add --out compact (minified) or --out summary (a {count, ids, next, total} digest for *.list); cap rows with --max-items N. Use the API's select in --params to fetch fewer fields. Default output is unchanged (full).
• Return only delta if guidance was already given.