---
title: "Dialog"
method: POST
path: "/dialog/"
tags: ["Dialog"]
---

# Dialog

`POST /dialog/`

Dialog with a specific bot

## Request body

- Dialog
  - `skill_id` string, required
  - `lang` string, required
  - `event_name` 'NEW_INPUT' | 'NEW_DIALOG_SESSION' | 'END_SESSION', required
  - `input_type` 'text' | 'postback' | 'autocomplete' | 'voice' | 'event'
  - `input` string, required
  - `platform` 'messenger' | 'rcs' | 'skype' | 'sms' | 'slack' | 'telegram' | 'twitter' | 'viber' | 'whatsapp' | 'maxit' | 'application' | 'api' | 'other', required
  - `user_id` string, required
  - `user_data` object, required
  - `verbose` boolean
  - `streaming` boolean

## Response `200`

successful operation

- DialogGet
  - `answer` string
  - `input` string
  - `intent` string
  - `intent_id` string
  - `reprompt` string
  - `confidence` string
  - `confidence_threshold` string
  - `end_session` boolean
  - `payload` object
  - `rich_text` object[]
  - `lang` string
  - `master_bot` boolean
  - `muted` boolean
  - `need_help` boolean
  - `never_trained` boolean
  - `platform` string
  - `skill_id` string
  - `state_id` string
  - `state_name` string
  - `probabilistic_nlu_processing_time` integer
  - `rule_based_nlu_processing_time` integer
  - `input_type` string
  - `dialog_management_processing_time` integer
  - `handover_category_name` string
  - `show_answer_survey` boolean
  - `show_conversation_survey` boolean
  - `understood` boolean
  - `understood_nlu` boolean
  - `client_id` string
  - `client_session_id` string
  - `user_id` string
  - `error` object
    - `code` string — A unique error code representing the type of error.
    - `message` string — A human-readable message providing more details about the error.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `429` — Too many requests
- `460` — Code execution failed
- `470` — Error message generated by the LLM provider

---

[API](https://skmtc.net/smartly/apis/smartly-ai-apis.md) · [All operations](https://skmtc.net/smartly/apis/smartly-ai-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartly/smartly-ai-apis/revisions/1e26909d86c9/schema)