Bot
Moved to an optional plugin in 12.0, and deprecated.
Legacy bot behaviors now live in the cerb.behaviors.legacy plugin. On upgrade it
is enabled automatically only if active behaviors exist, so installations without them stay
clean. They will not be retired during 12.x, and gained improvements in 12.0. New work should use automations.
| Name (singular): | Bot |
| Name (plural): | Bots |
| Alias (uri): | bot |
| Identifier (ID): | cerberusweb.contexts.bot |
Records API
These fields are available in the Records API and packages:
| Req'd | Field | Type | Notes |
|---|---|---|---|
created_at |
timestamp | The date/time when this record was created | |
image |
image | The profile image, base64-encoded in data URI format | |
is_disabled |
boolean | Is this bot disabled? | |
links |
links | An array of record type:id tuples to link to. Prefix with - to unlink. |
|
mention_name |
text | (deprecated) | |
| x | name |
text | The name of this bot |
| x | owner__context |
context | The record type of this bot's owner: app, role, group, or worker |
| x | owner_id |
number | The ID of this bot's owner |
updated_at |
timestamp | The date/time when this record was last modified |
Dictionary Placeholders
These placeholders are available in dictionaries for automations, snippets, and API responses:
| Field | Type | Description |
|---|---|---|
_context |
text | Record type extension ID |
_label |
text | Label |
_type |
text | Record type alias |
config |
object | Configuration |
created_at |
date | Created |
id |
number | Id |
is_disabled |
boolean | Disabled |
mention_name |
text | @Mention |
name |
text | Name |
owner_ |
record | Owner |
record_url |
text | Record Url |
updated_at |
date | Updated |
These optional placeholders are also available with key expansion in dictionaries and the API:
| Field | Type | Description |
|---|---|---|
behaviors |
records | Behaviors |
comment_count |
number | Comment count on the record |
comments |
comments | Comments |
custom_<id> |
mixed | Custom Fields |
links |
links | Links |
watchers |
watchers | Watchers |
Search Query Fields
These filters are available in bot search queries:
| Field | Type | Description |
|---|---|---|
created: |
date | Created |
disabled: |
boolean | Disabled |
fieldset: |
record | Fieldset |
id: |
number | Id |
links: |
links | Record Links |
mentionName: |
text | @Mention |
name: |
text | Name |
owner: |
text | Owner Type |
owner.<type>: |
record | Owner |
updated: |
date | Updated |
watchers: |
record | Watchers |
Worklist Columns
These columns are available on bot worklists:
| Column | Description |
|---|---|
*_owner |
Owner |
cf_<id> |
Custom Field |
v_at_mention_name |
@Mention |
v_created_at |
Created |
v_id |
Id |
v_is_disabled |
Disabled |
v_name |
Name |
v_updated_at |
Updated |