Ticketsv4

Answer the assistant

POST/tickets/{ticketId}/resolution

Answers the support assistant. Send exactly one of answered and choice. answered: true closes the ticket. answered: false asks whether to escalate or keep chatting and leaves the ticket open. choice: "continue" keeps the assistant on the ticket. choice: "escalate" hands the ticket to a person. Sending both fields, neither field, or a value that is not one of those returns 422 invalid_body. A ticket that is not waiting on that choice returns 409 assistant_choice_stale. The response is the ticket, including assistant. OAuth apps need tickets:write.

Path parameters

ticketIdRequiredstring

Ticket id (tkt_...), returned when the ticket is opened.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON
answeredoptionalboolean

true closes the ticket. false asks whether to escalate or keep chatting.

choiceoptionalstring

continue keeps the assistant going. escalate hands the ticket to a person. continue is valid only while the escalate question is the latest comment. escalate is also valid after the customer has kept chatting.

"escalate""continue"

Returns

dataoptionalTicket
idoptionalstring

Ticket id (tkt_...).

typeoptionalstring
"purchase""purchase_failure""support""billing""technical""feature_request""call_forwarding""system"
statusoptionalstring

open: not picked up yet. in_progress: Blooio support is working on it. waiting_on_customer: support needs a reply from you. closed: resolved.

"open""in_progress""waiting_on_customer""closed"
priorityoptionalstring

Read-only. Tickets open at medium; only Blooio support changes it.

"low""medium""high""urgent"
contentoptionalstring | null

The request as it was opened.

forwardingoptionalTicketForwarding | null

Progress of a call_forwarding ticket; null for every other type.

TicketForwarding
stateoptionalstring

pending: not started yet. in_progress: Blooio is setting up forwarding with the carrier. completed: calls now forward. failed: the last attempt failed, and the ticket stays open with Blooio support. A closed ticket always reads completed.

"pending""in_progress""completed""failed"
source_numberoptionalstring | null

E.164 number whose calls are forwarded.

destination_numberoptionalstring | null

E.164 number calls are forwarded to.

completed_atoptionalinteger | null

When forwarding completed; for a ticket closed without a recorded completion, when it was closed. null until state is completed.

null
can_commentoptionalboolean

Whether this ticket type takes replies. A closed ticket also refuses them.

assistantoptionalTicketAssistant
reply_pendingRequiredboolean

A reply to the latest customer comment is in flight. Poll the ticket until this is false, then read the comments.

can_confirm_answerRequiredboolean

The second answer is waiting for yes or no. Another comment returns 409 until the resolution route is called.

can_choose_escalationRequiredboolean

The customer is choosing between a person and more chat. Another comment returns 409 until the resolution route is called.

can_escalateRequiredboolean

The customer already chose to keep chatting and can still escalate with choice: "escalate".

created_atoptionalinteger
updated_atoptionalinteger

Response codes

200The ticket after the choice
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this ticket (blocked key or plan limit).
404No ticket was found with the provided `ticketId`.
409`assistant_choice_stale`: this ticket is not waiting on that confirmation or escalation choice.
422`invalid_body`: send either `answered` (boolean) or `choice` (`escalate` or `continue`), not both and not neither.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X POST https://api.blooio.com/v4/tickets/obj_a1b2c3d4/resolution \
Body object
Response objectexample
{  "data": {    "id": "obj_a1b2c3d4",    "type": "purchase",    "status": "open",    "priority": "low",    "content": "Hello from Blooio!",    "forwarding": {      "state": "pending",      "source_number": "string",      "destination_number": "string",      "completed_at": 0    },    "can_comment": false,    "assistant": {      "reply_pending": false,      "can_confirm_answer": false,      "can_choose_escalation": false,      "can_escalate": false    },    "created_at": 0,    "updated_at": 0  }}