Pachca icon

Pachca

Interact with Pachca API

Bot → Create

AI-generated

Summary

Creates a Pachca bot with the supplied name and optional settings, including permissions, events, commands, webhook behavior, and token scopes. Requires a token with an owner, admin, or user role. Supports creating empty bots without tokens or incoming webhooks. Commands are used when Trigger On is set to Commands, with the combined comma-joined length restricted to 255 characters. The nickname must end with '_bot'. If scopes are omitted, the service assigns a default set; certain scopes like 'bot' and 'all' cannot be assigned, and some scopes are restricted to specific roles. The Single Chat option controls bot addition to chats and can be set only at creation.

Inputs

  • Name (required) — Bot name.
  • Additional Fields — Optional bot settings include: roles allowed to edit the bot apart from the creator; webhook verification challenge key; commands the bot reacts to; flags for creating empty bots (without token or incoming webhook); events the bot subscribes to; enabling event history; ignoring self-messages; kind of incoming webhook source; enabling link previews; bot nickname; OAuth client authorization settings; outgoing webhook URL; promotional catalog information; token scopes; limiting the bot to a single group chat; incoming webhook message template and template engine; outgoing webhook trigger condition; domains for link unfurling; and who can add the bot to chats. Commands must be comma-separated and combined length limited to 255 characters. Scopes not available to bots or restricted to certain roles will cause a 400 error if assigned. Single Chat restriction applies only at creation and limits the bot to one discussion or channel (personal chats and threads are excluded).

Output shape

A single bot record returned by the Pachca API.

The source shows the response is passed through without simplification. The exact fields depend on the API response.

Examples

Example 1: minimal

Provide the required name and omit Additional Fields.

Example 2: webhook command bot

Set Trigger On to Commands, provide comma-separated Commands and an Outgoing URL; configure other webhook or permission options as needed.

Links

Discussion