The chatbot object

Shape of an embeddable chatbot, the widget config that customers embed on their site to expose a Macha agent.

A Chatbot is the embeddable widget configuration that customers paste onto their site to expose a Macha agent. Each chatbot binds one agent to one or more domains, with optional theme + welcome message.

Object shape

{
  "id": "chatbot_64f1c0ef2ec711ef6dc1dcf",
  "public_id": "cb_abc123xyz",
  "name": "Marketing Site Helper",
  "agent_id": "agent_64f1c0...",
  "is_active": true,
  "allow_write_tools": false,
  "allowed_domains": ["getmacha.com", "www.getmacha.com"],
  "theme": { "primaryColor": "#7C3AED" },
  "welcome_message": "Hi! How can I help you today?",
  "created_at": "2026-06-01T00:00:00.000Z",
  "updated_at": "2026-06-20T12:00:00.000Z"
}

Attributes

Field	Type	Notes
`id`	string	`chatbot_<24 hex>`.
`public_id`	string	Widget identifier embedded in customer sites. Safe to expose, visible in the embed script source.
`name`	string	Display name.
`agent_id`	string \| null	Which agent handles incoming chats.
`is_active`	boolean	If false, the widget shows "unavailable" to visitors. Auto-paused when the bound agent is deactivated.
`allow_write_tools`	boolean	Whether anonymous visitors can trigger write operations. Default: false. Enable only if you trust the agent's instructions to prevent abuse.
`allowed_domains`	array	Domain allowlist for embed. Empty array = no restriction.
`theme`	object \| null	Theme overrides. Free-form, current keys: `primaryColor`.
`welcome_message`	string \| null	First message shown when a visitor opens the chat.
`created_at`	ISO 8601
`updated_at`	ISO 8601

📘

Chatbot writes are planned

v1 is read-only for chatbots. Create / update / delete via the dashboard. POST/PATCH/DELETE endpoints are on the roadmap.