> For the complete documentation index, see [llms.txt](https://docs.ixkio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixkio.com/modules/tapai/adding-tapai-to-direct-response.md).

# Adding TapAI to Direct Response

TapAI is only available with Direct Response. You cannot use TapAI with Redirect or via the API Response Mode.

## TapAI Text and TapAI Voice

TapAI is available in two different formats - TapAI Text and TapAI Voice. You can add one or both to your Direct Response pages. 

<div data-with-frame="true"><figure><img src="/files/bm5ZsQEuAI8ymKcETUHx" alt="" width="218"><figcaption></figcaption></figure></div>

## Using TapAI Text

TapAI text is the most common method and integrates seamlessly into most pages like this :&#x20;

<div data-with-frame="true"><figure><img src="/files/9g8bmAAMpKTDpjw2smSt" alt="" width="176"><figcaption></figcaption></figure></div>

Drag the TapAI Text Element onto your Direct Response Template to use. When users scan your tags, they will see the question box but not the response box. After typing a question, the response box will appear and provide the answer.&#x20;

<div data-with-frame="true"><figure><img src="/files/Mk5DpR4y2jZTXiMyOrP8" alt="" width="375"><figcaption></figcaption></figure></div>

You can modify the design as you require including changing the colour of the submit button and font styles of both the question and answer boxes.&#x20;

#### Question Box Text vs. Question Box Follow-Up Text

The 'Question Box Text' is what the user will see on first scan. If you have [Conversation Mode](/modules/tapai/tapai-settings.md) disabled, then after the first question, this input box will be disabled.&#x20;

If you have Conversation Mode enabled, then you can change the message in the text box to prompt the user for a follow up question.&#x20;

## Using TapAI Voice

If you drag the TapAI Voice Element to your Direct Response Template, you can add the Voice feature.&#x20;

<div data-with-frame="true"><figure><img src="/files/8treHO2Wkkw7u549QGFc" alt="" width="178"><figcaption></figcaption></figure></div>

If your user taps the 'Ask a question' button, they will be prompted to use the microphone to ask a question. Note that in both iOS and Android, the user does need to give permission - there's no way around this.&#x20;

TapAI will then do it's best to understand the question, find the answer within your Reference Material and respond.&#x20;

It's possible style the TapAI Voice button by changing the colour, the font and button style. We will be adding more style options and designs in updates to TapAI coming soon.&#x20;

<div data-with-frame="true"><figure><img src="/files/iN8E2SDkolJ2SV5uuqN6" alt="" width="375"><figcaption></figcaption></figure></div>

#### Button Text vs. Button Text Follow-Up

The 'Button Text' is what the user will see in the button on first scan. If you have [Conversation Mode](/modules/tapai/tapai-settings.md) disabled, then after the first question, this button will be disabled.&#x20;

If you have Conversation Mode enabled, then you can change the wording in the button to prompt the user for a follow up question.&#x20;

#### Changing the TapAI Voice Output

In the TapAI Voice Element settings, you can change the output after the user has asked the question. You can choose voice only, text or voice and text :&#x20;

**Voice Only**\
The answer to the question will be spoken to the user.&#x20;

{% hint style="info" %}
It's currently only possible to use the standard voice (a well spoken British-English Male). We will be providing options to change the voice in updates to the TapAI Module coming later in 2026.&#x20;
{% endhint %}

**Text Only**\
With this setting, the user can ask a question using voice, but the answer will be written out into the answer box. You must also include the TapAI Text Element for this option.&#x20;

**Text and Voice**\
In this case, TapAI will speak the answer as well as writing it out into the box. The answers will be identical. You must also include the TapAI Text Element for this option.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ixkio.com/modules/tapai/adding-tapai-to-direct-response.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.