aim-bot-domain

Integrate third-party Bots with token authentication and HMAC-signed webhook delivery.

4|Updated May 17, 2026
One-click install
npx skills add https://github.com/hellopoisonx/aim --skill aim-bot-domain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aim-bot-domain
Source: https://github.com/hellopoisonx/aim/tree/main/skills/aim-bot-domain
Command: npx skills add https://github.com/hellopoisonx/aim --skill aim-bot-domain

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It standardizes how third-party Bots authenticate, authorize action permissions, and receive verified webhook deliveries in AIM, reducing integration drift and operational risk.

Core Features & Use Cases

  • Bot identity and token lifecycle: Supports Bot tokens with SHA-256 hash storage, expiration/revocation, and enabled status checks for reliable access control.
  • Action-based authorization: Enforces scoped permissions via bot_actions, bot_token_permissions, and bot_event_actions so Bots can only call what they’re allowed to do.
  • Webhook subscription with safe delivery: Subscribes to message.created events, signs deliveries (HMAC), and handles retries with backoff to prevent callback loops and protect the archive pipeline.
  • Operational bot provision (DB double-write): Provides a provisioning workflow to create Bot users, memberships, and issue tokens using operator scripts.

Quick Start

Provision a Bot by running the operator script scripts/bot-provision/provision_bot.sh, then share the plaintext token with the Bot developer for Authorization: Bot <token> calls to /api/bot/v1/*.

Frequently Asked Questions about aim-bot-domain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate third-party bots to interact with REST APIs securely?

Third-party bots authenticate with REST APIs using provisioned tokens via the Authorization header. Token hashes are stored using SHA-256, enabling reliable access control with expiration, revocation, and enabled status checks for secure bot authentication.

How do I provision a bot and get an access token for API integration?

Bot provisioning is done by running an operator script that creates bot users, memberships, and issues tokens. The script outputs a plaintext token to share with developers for making authorized calls to the bot REST endpoints.

How does webhook delivery work for message created events in microservices?

Webhook delivery for message created events uses an isolated Kafka consumer group to subscribe to events. Deliveries are signed with HMAC signatures and include retry logic with backoff to prevent callback loops and protect the archive pipeline.

How do I enforce action-based authorization for bot API calls?

Action-based authorization enforces scoped permissions using bot actions, token permissions, and event actions. This ensures bots can only call approved endpoints by validating action checks through a dedicated bot service RPC.

Can I use Kafka for webhook consumers without causing callback loops?

Yes, webhook consumers use an isolated Kafka consumer group with retryable HMAC-signed dispatch. The backoff retry mechanism prevents callback loops and protects downstream archive pipelines during message created event delivery.

What is the best way to secure webhook deliveries for third-party bot integrations?

The best way to secure webhook deliveries is using HMAC-signed payloads processed by an isolated Kafka consumer group. This approach verifies delivery authenticity and uses retry backoff to safely manage message created events.