Decide | SignalCore

import requests
url = "https://signalcore.ai/v1/conversations/conversation_id/decisions"
payload = {
    "request": "request",
    "approve": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "id",
  "agent_id": "agent_id",
  "trigger_id": "trigger_id",
  "handled_by": "agent",
  "pending": true,
  "test": true,
  "created_at": "2024-01-15T09:30:00Z",
  "run_id": "run_id",
  "handover": {
    "holder": "agent",
    "reason": "reason",
    "by": "by",
    "title": "title",
    "at": "2024-01-15T09:30:00Z"
  },
  "title": "title",
  "channel": {
    "id": "id",
    "kind": "kind",
    "name": "name"
  },
  "contact": {
    "id": "id",
    "name": "name",
    "address": "address",
    "muted": true
  },
  "reply_due_at": "2024-01-15T09:30:00Z",
  "last_inbound_at": "2024-01-15T09:30:00Z",
  "call": {
    "id": "id",
    "kind": "browser",
    "reason": "reason",
    "seconds": 1,
    "started_at": "2024-01-15T09:30:00Z",
    "ended_at": "2024-01-15T09:30:00Z",
    "recording": true
  },
  "person": {
    "kind": "host_person",
    "external_id": "external_id",
    "name": "name",
    "email": "email"
  }
}

The business’s yes or no on an action the conversation waits on for it (request, the call’s id, as waiting and the approval.requested webhook name it), from its backend or the app: the agent runs it, or hears it was declined, on its next turn. A person can’t decide for the business.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

conversation_idstringRequired

Request

This endpoint expects an object.

requeststringRequired1-64 characters

approvebooleanRequired

Response

Successful Response

idstring

agent_idstring

trigger_idstring or null

handled_byenum

Allowed values:

pendingboolean

testboolean

created_atdatetime

run_idstring or nullOptional

handoverobject or nullOptional

A change of who answers a conversation: to whom, why, who set it and when.

titlestring or nullOptional

channelobject or nullOptional

The channel a conversation is on, as a list draws it.

contactobject or nullOptional

The person a conversation on a channel is with, or a person of a host’s page (on no channel).

reply_due_atdatetime or nullOptional

last_inbound_atdatetime or nullOptional

callobject or nullOptional

The call a conversation is (VOICE.md): the owner’s in the browser or a phone call, when the worker took it and when it ended, why and how long.

personobject or nullOptional

Who a conversation is with (people).

Errors

422

Conversations Decide Request Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors