Queues and human agents
MarkdownEsta página aún no está disponible en tu idioma.
Queues, skills, wrap-up codes, canned responses and coverage.
canned_response_create
Section titled “canned_response_create”Create a canned response · Changes data · can overwrite or remove · Reached with dakso_explore
Creates a canned response. Careful: agents send its text to the organization’s end customers, so write a message ready to send, with no internal data. label up to 80 chars, text up to 1000, category up to 40, order 0 to 999. The id is generated and returned. For safety the agent does not run it: because the text reaches customers, it returns a link to the admin screen (/admin/queue-settings) where a person confirms it.
| Argument | Type | Required | Description |
|---|---|---|---|
category |
string | Yes | |
label |
string | Yes | |
text |
string | Yes | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
order |
integer | No |
canned_response_list
Section titled “canned_response_list”List canned responses · Read only · Reached with dakso_explore
Lists canned responses (texts agents insert in the chat): items with id, label, text, category, order and updatedAt, and total. category filters by exact category.
| Argument | Type | Required | Description |
|---|---|---|---|
category |
string | No |
canned_response_update
Section titled “canned_response_update”Update a canned response · Changes data · can overwrite or remove · Reached with dakso_explore
Edits a canned response by id; only what you pass is sent (label, text, category, order). Careful: agents send text to end customers, so a change reaches them at once. With if_updated_at (the updatedAt from the list), if someone changed it since, nothing is saved and it returns stale: true. Changing text is not run by the agent: it returns a link to the admin (/admin/queue-settings) for a person to confirm; label, category and order are edited here.
| Argument | Type | Required | Description |
|---|---|---|---|
id |
string | Yes | |
category |
string | No | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
if_updated_at |
string | No | |
label |
string | No | |
order |
integer | No | |
text |
string | No |
queue_coverage
Section titled “queue_coverage”Check queue coverage · Read only · Reached with dakso_explore
Diagnoses queue coverage: per queue, agents (enabled agents serving it; one with empty queues counts for all), flows (flows active in prod that hand off to it) and tools (handoff tools using it). unknownNames are names someone uses that do not exist (usually a typo). name limits to one queue. Unreadable data appears in unavailable and as null, never 0. Queues chosen by expression are not counted.
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string | No |
queue_create
Section titled “queue_create”Create a queue · Changes data · can overwrite or remove · Reached with dakso_explore
Creates a support queue. name is unique in the organization (up to 64 chars). acw is the after-call work policy: {“mode”: “optional” | “mandatory” | “timeboxed”}; timeboxed adds “timeoutSeconds” (15 to 900) and “defaultWrapupCode” (an existing wrap-up code that applies to the queue). Default is optional. If the queue exists, returns created: false and the existing one. Deleting a queue is done in the admin (/admin/queue-settings).
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | |
acw |
object | No | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
description |
string | No | Default: "". |
queue_dependents
Section titled “queue_dependents”Check what depends on a queue · Read only · Reached with dakso_explore
Tells what depends on a queue before you touch it: exists, agents, flows and tools. Null = could not be read (unavailable). partial: true with warnings = the flow check is incomplete and an empty flows does not prove nobody depends on it. If exists is false, check the name.
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string | Yes |
queue_list
Section titled “queue_list”List queues · Read only · Reached with dakso_explore
Lists the organization’s queues: items with name, description, acw (after-call work policy: mode, timeoutSeconds, defaultWrapupCode), requireWrapupCode, createdAt and updatedAt (copy it into if_updated_at when editing), and total.
No arguments.
queue_update
Section titled “queue_update”Update a queue · Changes data · can overwrite or remove · Reached with dakso_explore
Edits a queue by name; only what you pass is sent (description and/or acw). if_updated_at = the updatedAt from queue_list (“” if never edited): if someone changed the queue since, nothing is saved and it returns stale: true with the current queue.
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | |
acw |
object | No | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
description |
string | No | |
if_updated_at |
string | No |
skill_create
Section titled “skill_create”Create a skill · Changes data · can overwrite or remove · Reached with dakso_explore
Creates a skill by name (unique in the organization, up to 64 chars). If it already exists, returns created: false and the existing one.
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string | Yes | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
skill_list
Section titled “skill_list”List skills · Read only · Reached with dakso_explore
Lists the organization’s skills (abilities assigned to agents and queues): items with name, description and createdAt, and total.
No arguments.
wrapup_code_create
Section titled “wrapup_code_create”Create a wrap-up code · Changes data · can overwrite or remove · Reached with dakso_explore
Creates a wrap-up code. code is stored uppercase with only A-Z, 0-9 and _ (up to 40 chars) and is unique; name is what the agent sees (up to 80); color in hex; queues = names of the queues where it applies (empty or absent = all). If it exists, returns created: false and the existing one.
| Argument | Type | Required | Description |
|---|---|---|---|
code |
string | Yes | |
name |
string | Yes | |
color |
string | No | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
description |
string | No | Default: "". |
queues |
array | No |
wrapup_code_list
Section titled “wrapup_code_list”List wrap-up codes · Read only · Reached with dakso_explore
Lists wrap-up codes (how an agent classifies a conversation when it ends): items with code, name, description, color, queues (empty = applies to all queues) and updatedAt, and total. queue filters by one queue.
| Argument | Type | Required | Description |
|---|---|---|---|
queue |
string | No |
wrapup_code_update
Section titled “wrapup_code_update”Update a wrap-up code · Changes data · can overwrite or remove · Reached with dakso_explore
Edits a wrap-up code by code; only what you pass is sent (name, description, color, queues; queues=[] makes it apply to all). It cannot be removed from a queue that uses it as the default code of a timeboxed after-call policy. With if_updated_at (the updatedAt from the list), if someone changed it since, nothing is saved and it returns stale: true with the current one.
| Argument | Type | Required | Description |
|---|---|---|---|
code |
string | Yes | |
color |
string | No | |
descripcion |
string | No | One short sentence: what this call changes and why (10-200 chars, no personal data). |
description |
string | No | |
if_updated_at |
string | No | |
name |
string | No | |
queues |
array | No |