# Interaction APIs

The **Interaction APIs** enable real-time, dynamic interaction between users and your AI characters.\
Once your characters are live, these APIs handle conversational input and contextual responses.

With these APIs, you can:

* **Engage in live conversations** — send user text or voice inputs and receive contextual, natural replies.
* **Retrieve responses in text and/or audio form**, enabling both text-based chat and voice dialogue modes.
* **Send and process audio input** (e.g., `.wav` mono files with supported sample rates) to enable real-time speech recognition.

The Interaction APIs bridge your characters and users, enabling seamless, responsive communication across both textual and voice channels.

{% content-ref url="/pages/NOI4Ph3RXtXVmdFcNVoU" %}
[Interaction API](/api-docs/api-reference/core-api-reference/interaction-apis/interaction-api.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/api-reference/core-api-reference/interaction-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.