> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unleashx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kwiqreply

> Send WhatsApp text, link-preview, button, and list messages through Kwiqreply, and read/write UnleashX datasource records.

# Kwiqreply

> **In one line:** Connect Kwiqreply so your UnleashX agent can send rich WhatsApp messages (text, link previews, reply buttons, and interactive lists) and read or write your UnleashX datasource records in the same flow.

|                    |                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| **Category**       | Communication                                                                                                            |
| **Authentication** | API Key (Kwiqreply gateway token)                                                                                        |
| **Setup time**     | \~5 minutes                                                                                                              |
| **Difficulty**     | Easy                                                                                                                     |
| **Best for**       | Teams using Kwiqreply for WhatsApp who want their agent to send interactive messages and sync data with UnleashX objects |

## 1. Overview

Kwiqreply is a WhatsApp messaging gateway that lets businesses send rich, interactive WhatsApp messages — plain text, link previews, reply-button menus, and selectable lists — through a single API.

Once connected to UnleashX, your agent can send all of those message types to your customers, and also read and write records in your **UnleashX datasource objects** — so a single request can both message a customer and log or update the related record.

Connecting Kwiqreply to UnleashX is ideal for conversational workflows: present a customer with button or list choices over WhatsApp, then record their details or look up their status against your UnleashX data — all driven by natural language.

## 2. What you'll need

* A **Kwiqreply** account with WhatsApp messaging enabled.
* Your **Kwiqreply API token** (the bearer token used to authenticate with the Kwiqreply gateway).
* An UnleashX account with the datasource **objects** you want to read from or write to (each has an `object_id`).

<Note>
  If you don't have access to your company's Kwiqreply token, ask your Kwiqreply account admin to generate or share it. You won't be able to send messages without it.
</Note>

## 3. Get your credentials

Kwiqreply authenticates with a single **API token** (a bearer token). You'll get it from your Kwiqreply dashboard.

<Steps>
  <Step title="Sign in to Kwiqreply">
    Go to [app.kwiqreply.io](https://app.kwiqreply.io) and sign in to your account.
  </Step>

  <Step title="Open API / Developer settings">
    In the dashboard, open the **API** / **Developers** / **Settings** area where your access token is shown.
  </Step>

  <Step title="Generate or copy your API token">
    Copy the **API token** (used as `Authorization: Bearer <token>` for the messaging endpoint).
  </Step>
</Steps>

<Warning>
  Treat your Kwiqreply token like a password. If it is shown only once on generation, **copy it now** and store it somewhere safe — you may not be able to view it again.
</Warning>

**Credentials UnleashX needs and why:**

| Credential                     | Why UnleashX needs it                                                                                    |
| ------------------------------ | -------------------------------------------------------------------------------------------------------- |
| Kwiqreply API token (bearer)   | Authenticates every WhatsApp send to the Kwiqreply gateway                                               |
| UnleashX object `object_id`(s) | Identifies which UnleashX datasource object to read or write (provided per request, not at connect time) |

<Note>
  The datasource tools (Get List Data, Insert Datasource, Get Datasource, Update Datasource) read and write your UnleashX objects. These calls use UnleashX's own platform token — you don't supply a separate key for them.
</Note>

## 4. Connect on UnleashX

<Steps>
  <Step title="Open your agent">
    Sign in at [tryunleashx.com](https://www.tryunleashx.com) and open the agent you want to connect.
  </Step>

  <Step title="Go to Data Connectors">
    Open **Data Connectors** inside the agent.
  </Step>

  <Step title="Find Kwiqreply and Configure">
    Locate **Kwiqreply** and click **Connect** / **Add** / **Configure**.
  </Step>

  <Step title="Paste your API token">
    Enter your **Kwiqreply API token** from Section 3 and save.
  </Step>

  <Step title="Confirm it's connected">
    The connector shows a **Connected** badge once your token is accepted. You're ready to send.
  </Step>
</Steps>

### Use Kwiqreply in a Workflow

Once connected, you can add **Kwiqreply** to any automation from the **Workflows** builder. Its triggers and tools appear in the Apps panel, marked with an **MCP** badge.

<Steps>
  <Step title="Add a trigger or action node">
    Open **Workflows → New Workflow**. On the canvas, click **+ Add Trigger** (or the **+** below any node) to add a step.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/05-add-trigger.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=449a0c03b0c7b40e571ec02373a85259" alt="Add a trigger on the workflow canvas" width="1390" height="722" data-path="images/mcp/workflows/05-add-trigger.png" />
  </Step>

  <Step title="Pick Kwiqreply from the Apps panel">
    In the **Paths** panel, open the **Apps** tab and select **Kwiqreply**. Use the search box if you have many connectors.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/06-apps-list.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=bbb8bb6e668c4f8e1f6fd5e4955a45f0" alt="Choose your app from the Apps list" width="2446" height="1550" data-path="images/mcp/workflows/06-apps-list.png" />
  </Step>

  <Step title="Choose a trigger or tool">
    Pick the trigger or action you want. Configure its fields — required fields are marked with a red asterisk (\*).
  </Step>

  <Step title="Add or select your account">
    Under **Selected account**, choose an already-connected account, or click **Add Account** to connect one now.
  </Step>

  <Step title="Save and test">
    Fill in the remaining fields and click **Save**. Use **Test** to verify the step, then toggle **Publish** when the workflow is ready.
  </Step>
</Steps>

<Note>
  The steps are the same for every connector. For the full workflow builder guide, see [Using MCP in Workflows](/mcp/workflows).
</Note>

## 5. Available tools

| Tool                       | What it does                                                     | Changes data? |
| -------------------------- | ---------------------------------------------------------------- | ------------- |
| Get List Data              | Fetch object data counts by conditions from UnleashX             | No            |
| Insert Datasource          | Insert a new datasource record into UnleashX                     | ✏️ Yes        |
| Get Datasource             | Fetch datasource records from UnleashX by where-conditions       | No            |
| Update Datasource          | Update an existing UnleashX datasource record                    | ✏️ Yes        |
| Send Text Message          | Send a plain WhatsApp text message via Kwiqreply                 | ✏️ Yes        |
| Send Text Message with URL | Send a WhatsApp text message with link preview enabled           | ✏️ Yes        |
| Send Button Message        | Send a WhatsApp interactive reply-button message (max 3 buttons) | ✏️ Yes        |
| Send List Message          | Send a WhatsApp interactive list message with selectable rows    | ✏️ Yes        |

## 6. Example usage

**"Ask 9876543210 over WhatsApp whether they want Plan A, Plan B, or Plan C, with tappable buttons."**
Behind the scenes: Send Button Message (three reply buttons).

**"Save this lead — name Priya, phone 98765 43210 — to our Leads object, then text her a welcome message."**
Behind the scenes: Insert Datasource (write the record) → Send Text Message (welcome message).

## 7. Permissions & data access

**UnleashX CAN:**

* Send WhatsApp text, link-preview, reply-button, and interactive list messages via Kwiqreply.
* Read counts and records from your UnleashX datasource objects.
* Insert and update records in your UnleashX datasource objects.

**UnleashX CANNOT:**

* Delete records (no delete tool is exposed by this server).
* Send message types beyond those listed (e.g. media/templates are not part of this connector).
* Access Kwiqreply account settings or billing.

**How to disconnect:** In UnleashX, open **Data Connectors → Kwiqreply → Disconnect**. To fully cut messaging access, also revoke or regenerate the API token in your Kwiqreply dashboard. Disconnecting takes effect immediately.

## 8. Troubleshooting

| Problem                                     | What it means                                                               | How to fix it                                                                          |
| ------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| 401 — Missing Authorization                 | No Kwiqreply token was sent or it's blank                                   | Reconnect and re-enter your Kwiqreply API token                                        |
| 401 / 403 from gateway                      | The token is invalid, expired, or revoked                                   | Generate a fresh token in Kwiqreply and reconnect                                      |
| "At most 3 reply buttons" error             | A button message included more than 3 buttons                               | Reduce to 3 or fewer buttons, or use Send List Message instead                         |
| "At least one section/row is required"      | A list message had no rows                                                  | Provide at least one section with at least one row                                     |
| Datasource call fails / UNLEASHX\_URL error | The UnleashX datasource endpoint isn't reachable or the object\_id is wrong | Verify the `object_id` exists; contact support if the platform endpoint is unavailable |

For general connector issues, see [/mcp/integrations](/mcp/integrations).

## 9. Frequently asked questions

**Can this connector delete records?**
No. It can read (Get List Data, Get Datasource), insert (Insert Datasource), and update (Update Datasource) UnleashX records, but it exposes no delete operation.

**What's the difference between text and list/button messages?**
Text messages are plain (optionally with a link preview). Button messages show up to 3 tappable reply buttons; list messages show a menu of selectable rows grouped into sections — useful for letting customers pick an option.

**How do I rotate my Kwiqreply token?**
Generate a new token in your Kwiqreply dashboard, then reconnect in UnleashX with the new value. Revoke the old one in Kwiqreply.

**Do the WhatsApp messages come from my own number?**
Yes — they're sent through your Kwiqreply account, which is tied to your configured WhatsApp sender.

## 10. References

* Kwiqreply: [https://app.kwiqreply.io](https://app.kwiqreply.io)
* Kwiqreply website / docs: [https://kwiqreply.io](https://kwiqreply.io)
* UnleashX dashboard: [https://www.tryunleashx.com](https://www.tryunleashx.com)