Send a message in a test conversation

curl --request POST \
  --url https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "message": "A golden retriever, 3 years old."
}
'

import requests

url = "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages"

payload = { "message": "A golden retriever, 3 years old." }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({message: 'A golden retriever, 3 years old.'})
};

fetch('https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'A golden retriever, 3 years old.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages"

	payload := strings.NewReader("{\n  \"message\": \"A golden retriever, 3 years old.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"A golden retriever, 3 years old.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"A golden retriever, 3 years old.\"\n}"

response = http.request(request)
puts response.read_body

{
  "conversation_id": "2b7c1d7e-5d1a-4c2e-9f0a-6a1d2e3f4a5b",
  "lead_id": "2b7c1d7e-5d1a-4c2e-9f0a-6a1d2e3f4a5b",
  "workflow_id": "8f14e45f-ceea-4e7a-9a8e-1c2b3d4e5f60",
  "channel": "webchat",
  "reply": "Hi Ana! I'm Sofia from PetsTable.\n\nWhat kind of pet do you have?",
  "messages": [
    {
      "type": "text",
      "text": "Hi Ana! I'm Sofia from PetsTable."
    },
    {
      "type": "text",
      "text": "What kind of pet do you have?"
    }
  ],
  "tool_calls": [
    {
      "name": "save_field",
      "args": {
        "field": "pet_type",
        "value": "dog"
      },
      "success": true
    }
  ],
  "status": "new"
}

POST

test-conversations

{conversation_id}

messages

Send a message in a test conversation

curl --request POST \
  --url https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "message": "A golden retriever, 3 years old."
}
'

import requests

url = "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages"

payload = { "message": "A golden retriever, 3 years old." }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({message: 'A golden retriever, 3 years old.'})
};

fetch('https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'message' => 'A golden retriever, 3 years old.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages"

	payload := strings.NewReader("{\n  \"message\": \"A golden retriever, 3 years old.\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"A golden retriever, 3 years old.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/test-conversations/{conversation_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"A golden retriever, 3 years old.\"\n}"

response = http.request(request)
puts response.read_body

{
  "conversation_id": "2b7c1d7e-5d1a-4c2e-9f0a-6a1d2e3f4a5b",
  "lead_id": "2b7c1d7e-5d1a-4c2e-9f0a-6a1d2e3f4a5b",
  "workflow_id": "8f14e45f-ceea-4e7a-9a8e-1c2b3d4e5f60",
  "channel": "webchat",
  "reply": "Hi Ana! I'm Sofia from PetsTable.\n\nWhat kind of pet do you have?",
  "messages": [
    {
      "type": "text",
      "text": "Hi Ana! I'm Sofia from PetsTable."
    },
    {
      "type": "text",
      "text": "What kind of pet do you have?"
    }
  ],
  "tool_calls": [
    {
      "name": "save_field",
      "args": {
        "field": "pet_type",
        "value": "dog"
      },
      "success": true
    }
  ],
  "status": "new"
}

Continues a test conversation you started by API or in Playground. You send what the lead writes next, and you get the agent’s answer for that turn.

Before you start

It runs on the channel you chose when you started the conversation.
Same rules as starting a conversation: secret API key only, workflows:write on MCP keys, always simulated.
Send one message at a time. While a turn is running, another message to the same conversation returns turn_in_progress. Wait for the answer, then send the next one.
If the agent refuses the turn on purpose, for example because the lead was escalated to a person or the AI is off for it, you get 409 turn_refused with the cause in reason, such as lead_in_support, human_takeover, or ai_not_enabled. Sending the same message again gets the same answer. A real failure returns turn_failed instead.
Only test conversations of your account are accepted. A real lead, or a conversation from another account, returns conversation_not_found.

What you send

Field	Detail
`conversation_id`	In the path. The ID you got when you started the conversation.
`message`	What the simulated lead writes. Up to 4000 characters.

What you get back

The same fields as when you start a conversation: conversation_id, channel, reply, messages, tool_calls, status, and no_reply_reason when the agent stayed silent on purpose.

Read a turn in detail

With the Nexor MCP, pass conversation_id as the lead ID to list_lead_turns and get_lead_turn to see the full reasoning of a turn.

Limits

30 turns per minute per API key, shared with starting conversations.
A turn that takes more than 90 seconds returns turn_failed with reason timeout.

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_.

Path Parameters

conversation_id

string<uuid>

required

The conversation_id you got when you started the conversation. Conversations started in Playground also work.

Body

application/json

message

string

required

What the simulated lead writes.

Required string length: 1 - 4000

Response

The agent answered.

conversation_id

string<uuid>

required

ID of the test conversation. It is the test lead's ID, so it also works with GET /test-conversations and GET /leads/{id}/turns.

lead_id

string<uuid>

required

Same value as conversation_id.

workflow_id

string<uuid>

required

Task ID (workflow in the API) the conversation runs on.

channel

enum<string>

required

Simulated channel the conversation runs on. The agent writes as it would on that channel; nothing is sent.

Available options:

whatsapp,

webchat,

sms,

imessage,

unsupervised-whatsapp,

email,

instagram,

messenger

string | null

required

The agent's text for this turn, bubbles joined by a blank line. null when the agent stayed silent on purpose.

messages

object[]

required

Every message the agent sent in this turn, in order, as the lead would receive them.

Show child attributes

tool_calls

object[]

required

Tools the agent called in this turn, in order. API keys and tokens in the arguments are masked.

Show child attributes

status

string | null

required

Key of the lead's stage in the task after this turn.

no_reply_reason

string

Only when the agent stayed silent on purpose, for example terminal_tool (it reacted with an emoji) or status_paused (the stage pauses the agent).

Last modified on October 9, 2026

Start here

Quickstart

API reference

Build and launch

WhatsApp

Channels

Agents

Meetings

Integrations

Account

Inbox

Insights

Developer tools

Support reference

Send a message in a test conversation

Before you start

What you send

What you get back

Read a turn in detail

Limits

Authorizations

Path Parameters

Body

Response

​Before you start

​What you send

​What you get back

​Read a turn in detail

​Limits

Authorizations

Path Parameters

Body

Response

Before you start

What you send

What you get back

Read a turn in detail

Limits