Get a robot | ParsChat Docs

{
  "id": "rbt_8fK2mQ",
  "name": "Rose Flower Shop",
  "external_id": "shop_10422",
  "description": null,
  "is_active": true,
  "channels": [
    {
      "id": "chn_3pQ7xL",
      "type": "instagram",
      "is_active": true
    }
  ],
  "created_at": "2026-09-20T11:04:33Z",
  "settings": {
    "conversations": {
      "auto_close": {
        "enabled": true,
        "idle_minutes": 360,
        "max_idle_minutes": 21600
      },
      "operator_handover": {
        "message": "An operator will join you shortly.",
        "send_message": true
      },
      "offline": {
        "message": "در حال حاضر اپراتورهای ما آنلاین نیستند. پیام شما ثبت شد و به‌محض آنلاین شدن اولین اپراتور پاسخ داده می‌شود.",
        "send_message": false
      },
      "busy": {
        "message": "در حال حاضر اپراتورهای ما مشغول هستند. پیام شما ثبت شد و در اولین فرصت پاسخ داده می‌شود.",
        "send_message": false,
        "after_seconds": 300
      },
      "working_hours": {
        "enabled": true,
        "time_zone": "Asia/Tehran",
        "days": {
          "SAT": [
            {
              "start": "09:00",
              "end": "18:00"
            }
          ],
          "SUN": [
            {
              "start": "09:00",
              "end": "13:00"
            },
            {
              "start": "16:00",
              "end": "20:00"
            }
          ],
          "MON": [
            {
              "start": "09:00",
              "end": "18:00"
            }
          ],
          "TUE": [
            {
              "start": "09:00",
              "end": "18:00"
            }
          ],
          "WED": [
            {
              "start": "09:00",
              "end": "18:00"
            }
          ],
          "THU": [
            {
              "start": "09:00",
              "end": "13:00"
            }
          ],
          "FRI": []
        }
      },
      "offline_message": "در حال حاضر اپراتورهای ما آنلاین نیستند. پیام شما ثبت شد و به‌محض آنلاین شدن اولین اپراتور پاسخ داده می‌شود.",
      "ai_failure_message": null
    },
    "ai": {
      "enhanced_accuracy": false,
      "creativity": 50,
      "language": "auto",
      "topic": "Flower shop: roses and tulips, delivery inside Tehran only"
    },
    "ai_operator": {
      "enabled": true,
      "display_name": "Rose assistant",
      "start_mode": "on_first_message",
      "availability": "always",
      "wait_minutes": 3
    }
  }
}

Returns one robot, in the same shape as a list entry.

settings holds the robot’s settings, the same ones your customer sees in the panel. A robot that never changed one shows the value actually in force. settings.ai and settings.ai_operator are null for an account without an AI messages package.

Authentication

AuthorizationBearer

Your API key, issued by ParsChat sales. One key per account, spanning every robot you own. Send it as Authorization: Bearer pk_live_….

Path parameters

robot_idstringRequired

The robot's id, as returned by the create call.

Response

The robot.

idstringOptional

ParsChat identifier for the robot.

namestringOptional

Display name, shown in the panel.

external_idstring or nullOptional

Your own identifier for this customer. Returned on every webhook event, so you do not need a lookup table. null until you set one.

descriptionstring or nullOptional

Free text about the robot, up to 255 characters. null until you set it.

is_activebooleanOptional

false while the robot is deactivated: its channels are switched off. See PATCH /robots/{robot_id}.

channelslist of objectsOptional

Channels attached to this robot, in short form. Empty until you connect one. Call the channels endpoint for the full record.

created_atdatetimeOptional

When the robot was created.

settingsobjectOptional

A robot’s settings, the same ones your customer sees in the ParsChat panel. ai and ai_operator are null for an account without an AI messages package.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error