pachca-bots

Category: Tools & Productivity | Uploader: pachca | Downloads: 0 | Version: v1.0（Latest）

Bot management, incoming/outgoing webhooks, link unfurling. Use when: set up bot, handle webhook, handle button click, periodic digest, alerts, polling events, unfurl link.

Changelog: Source: GitHub https://github.com/pachca/openapi

Directory Structure

Current level: apps/docs/public/.well-known/skills/pachca-bots/

📁 references/
- 📄 handle-button-click-callback.md 605 B
- 📄 handle-incoming-webhook-event.md 477 B
- 📄 link-unfurling.md 494 B
- 📄 monitoring-and-alerts.md 478 B
- 📄 process-events-via-history-polling.md 454 B
- 📄 webhook-events.md 1.6 KB
📄 SKILL.md 3.3 KB

SKILL.md

---
name: pachca-bots
description: >
  Bot management, incoming/outgoing webhooks, link unfurling. Use when: set up
  bot, handle webhook, handle button click, periodic digest, alerts, polling
  events, unfurl link.
allowed-tools: Bash(npx:*), Bash(pachca:*), Bash(which:*), Bash(npm:*)
---

# pachca-bots

## Quick start

Ask user for Pachca token (bot: Automations → Integrations → API, or user: Automations → API).

Run commands with `npx @pachca/cli` and `--token` flag:

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

Or set `PACHCA_TOKEN` for multiple commands:

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

Help: `npx @pachca/cli --help` | Scenarios: `npx @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 user has a saved profile — check status:

       npx @pachca/cli auth status

   If OK — use commands without `--token`.

2. If profile is not configured — ask for token and use `--token` flag:

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

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

## Step-by-step scenarios

### Set up bot with outgoing webhook

1. Create bot in Pachca UI: Automations → Integrations → Webhook

2. Get bot `access_token` from "API" tab in bot settings

3. Set Webhook URL for receiving events

> Bot is created via UI, not API. The only bot endpoint is PUT /bots/{id} (update webhook URL). API is used to send messages on behalf of bot.


### Update bot webhook URL

1. Update bot webhook URL:
   ```bash
   pachca bots update <bot_id> --webhook='{"outgoing_url":"https://example.com/webhook"}'
   ```
   > Bot `id` (its `user_id`) can be found in "API" tab of bot settings

> Only users with bot edit permissions can update settings.


### Periodic digest/report

1. On schedule (cron/scheduler): collect data from your system

2. Compose message text with metrics or summary

3. Send message to channel:
   ```bash
   pachca messages create --entity-id=<chat_id> --content="Дайджест за сегодня: ..."
   ```

> No built-in scheduler — use cron, celery, sidekiq, etc. on your side.


## Constraints and gotchas

- Rate limit: ~50 req/sec. On 429 — wait and retry.
- `limit`: max 50
- Pagination: cursor-based (limit + cursor)

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| PUT | /bots/{id} | Редактирование бота |
| POST | /messages/{id}/link_previews | Unfurl (разворачивание ссылок) |
| GET | /webhooks/events | История событий |
| DELETE | /webhooks/events/{id} | Удаление события |

## Complex scenarios

For complex scenarios read files from references/:
  references/handle-incoming-webhook-event.md — Handle incoming webhook event
  references/link-unfurling.md — Link unfurling
  references/handle-button-click-callback.md — Handle button click (callback)
  references/monitoring-and-alerts.md — Monitoring and alerts
  references/process-events-via-history-polling.md — Process events via history (polling)

  references/webhook-events.md — Webhook event types

> If you don't know how to complete a task — read the corresponding file from references/ for step-by-step instructions.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

pachca-bots

Directory Structure

SKILL.md

Report

Notice