> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/product-docs/core-concepts/chatbot-editor-tools/keywords-and-functional-commands.md).

# Keywords & Functional Commands

The chatbot platform includes built-in **keywords, placeholders, and internal commands** that can be used inside Bot Reply units, API calls, or unit titles to control chatbot behavior and track specific points in the scenario.

These commands are not shown to the end user, but they can be used for actions such as ending a conversation, transferring to a live agent, displaying API results, generating dates, and tracking reporting points. 

### Available Commands

| Command                                 | Usage                                                                                                                                                                 |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{{survey1}}` to `{{survey10}}`         | Tracks when a user reaches a specific point in the scenario. The collected data can later appear in Live Chat reporting.                                              |
| `{{endChat}}`                           | Automatically ends the conversation from a Bot Reply.                                                                                                                 |
| `{{apiResult}}`                         | Displays the result returned from an API request. Intended mainly for testing during API integration.                                                                 |
| `{{live agent}}`                        | Transfers the conversation from the chatbot to a live human agent.                                                                                                    |
| `{{getToday}}`                          | Retrieves the current date.                                                                                                                                           |
| `{{getTomorrow}}`                       | Retrieves tomorrow’s date.                                                                                                                                            |
| `{{getAfterDay1}}` … `{{getAfterDay7}}` | Generates future dates dynamically.                                                                                                                                   |
| `afterCloseChat`                        | Indicates that the customer has exited Live Chat and returned to the chatbot, allowing the flow to continue to a specific scenario such as a survey or feedback path. |

### How to use them

These commands are added directly where the related action is needed.

For example:

* Add `{{endChat}}` inside a **Bot Reply** when the conversation should end.
* Add `{{live agent}}` when the user should be transferred to a human agent.
* Use `{{apiResult}}` while testing an API integration.
* Use `{{surveyN}}` to mark specific points in the scenario for reporting.
* Use the date commands when the chatbot needs to reference today or a future date. 

> ✅ **Note:** These commands are internal and are not intended to be displayed as normal text to the end user.