Test the live chat API without real visitors

Test keys run every check and never reach a visitor.

POST/v1/test/inbound

Simulate a visitor

Request

curl -X POST "https://api.iotabot.com/v1/test/inbound" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "website",
  "from": "sandbox-visitor-1",
  "name": "Priya",
  "text": "Where is my order?"
}'

Response · 201

{
  "data": {
    "livemode": false,
    "conversation": {
      "id": "6a4bc1…",
      "object": "conversation",
      "channel": "website",
      "status": "open",
      "mode": "ai"
    },
    "message": {
      "id": "6a4bc2…",
      "object": "message",
      "direction": "inbound",
      "text": "Hi, where is my order #1042?",
      "status": "received"
    }
  }
}

Errors

test_key_requiredchannel_not_allowedwebsite_not_allowed