# Free Invoice Generator

{% embed url="<https://youtu.be/XFqBlbuQ3JY>" %}

The **Invoice Generator Mini App** allows you to generate PDF invoices directly from chatbot flows in your Rapidbott workspace. It connects with [invoice-generator.com](https://invoice-generator.com) and uses their API to automate invoice creation and delivery.

#### ⚙️ Step 1: Prerequisites

* A [**Rapidbott**](http://app.rapidbott.cloud/) account
* A [**Invoice Generator**](https://invoice-generator.com) account
* An **active S3 storage** setup in your workspace\
  → [How to set up S3 storage](https://youtu.be/JGVSH-mCTjs?si=1QRg1wd0jVwXtbbo)

***

#### 🔑 Step 2: Get Your API Key

1. Sign in at [invoice-generator.com](https://invoice-generator.com)
2. Go to your **Account Settings**
3. Generate your **API key**
4. Copy and save the key securely

***

#### 🧩 Step 3: Install the Mini App

1. Navigate to your Rapidbott workspace
2. Go to **Mini Apps → Browse → Invoice Generator**
3. Click **Install**
4. Paste your **API key** when prompted
5. Ensure S3 is enabled for file storage and link access

***

#### 💬 Step 4: Use in Chatbot Flows

* Add the Mini App to your chatbot flow
* Collect customer details (e.g., name, email, items, amount)
* Pass those variables into the Mini App fields
* On success, a downloadable PDF invoice link is generated

***

#### 📄 API Notes

* **API Base URL**: `https://invoice-generator.com`
* Refer to [developer docs](https://invoice-generator.com/developers) for:
  * Required payload structure
  * Rate limits
  * Supported fields and customizations

***

#### 📥 Output

* A downloadable **PDF invoice link**
* Stored and served via your S3 storage
* Can be sent directly to the customer via WhatsApp, email, etc.

***

#### 🛠 Example Fields in Flow

| Field Name   | Description                             |
| ------------ | --------------------------------------- |
| from         | Your company info                       |
| to           | Customer info                           |
| items        | List of products or services            |
| amount\_paid | Paid amount (used to calculate balance) |
| notes        | Extra comments (e.g. “Thank you!”)      |
| terms        | Invoice terms (e.g. refund policy)      |

***

#### 🧪 Testing

* Try a test invoice with dummy data before using in live flow
* Ensure the link is accessible (S3 properly set up)
* If invoice isn't generated, recheck API key and flow variables

***

#### 📬 Support

For any issues or questions, contact us at\
**📧 <support@rapidbott.com>**


---

# 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.rapidbott.com/help-center/platform/introduction/integrations/free-invoice-generator.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.