# 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>**