Skip to main content
POST
/
api
/
v1
/
agents
/
test
/
messages
Python (SDK)
import os
from syllable_sdk import SyllableSDK


with SyllableSDK(
    api_key_header=os.getenv("SYLLABLESDK_API_KEY_HEADER", ""),
) as ss_client:

    res = ss_client.agents.test.send_test_message(request={
        "service_name": "<value>",
        "source": "user@email.com",
        "text": "Hello",
        "test_id": "<id>",
        "agent_id": "<id>",
    })

    # Handle response
    print(res)
{
  "test_id": "<string>",
  "agent_id": "<string>",
  "response": "<unknown>",
  "text": "<string>",
  "response_text": "<string>"
}

Authorizations

​
Syllable-API-Key
string
header
required

Body

application/json

Message sent in a test chat with an agent.

​
service_name
string
required

Name of the service producing the message

​
source
string
required

Name of the source of the message - identifies the user, like an email or username.

Example:

"user@email.com"

​
test_id
string
required

Channel-manager-side ID of the session (see Session.channel_manager_sid)

​
agent_id
string
required

ID of the agent with which the chat is taking place

​
text
string | null

The text of the message

Example:

"Hello"

​
org_name
string | null
deprecated

Unused: Name of the organization associated with the agent

​
override_timestamp
string | null

Override for the timestamp of the message

​
session_start
boolean
default:false

Whether this message is the start of a new session

Response

Successful Response

Response from an agent in a test chat.

​
test_id
string
required

Channel-manager-side ID of the session (see Session.channel_manager_sid)

​
agent_id
string
required

ID of the agent with which the chat is taking place

​
response
any | null
required

The response from the agent

​
text
string

The text of the message that elicited the response

​
response_text
string

The text of the response