Update | SignalCore

import requests
url = "https://signalcore.ai/v1/conversations/conversation_id"
payload = { "holder": "agent" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.patch(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"
  }
}

Who answers it now, as the owner says, and why: the agent, a person of the business (the agent paused here), or nobody (ignored). Recorded as theirs; a turn on its way in this process stops when the agent no longer holds it.

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.

holderenumRequired

Allowed values:

reasonstringOptional<=500 charactersDefaults to

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 Update Request Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors