Ir al contenido

Queues and human agents

Markdown

Esta página aún no está disponible en tu idioma.

Queues, skills, wrap-up codes, canned responses and coverage.

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

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

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

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

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: "".

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

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.

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

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).

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.

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

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

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