# Whats Line Integration Guide - Unofficial V1

Welcome to the developers' guide for the **Unofficial Integration**. This version (V1) provides a powerful API to link regular WhatsApp accounts and send messages using the Multi-Device system.

---

## 1. Getting Integration Keys

Before starting, you need to retrieve your integration keys from the dashboard:
1. Go to **Settings** in your account.
2. Select the **API Integration** section.
3. You will find two main values:
    *   **App ID**: A unique identifier for your application.
    *   **Header Token**: The security key for programming operations.
4. You can regenerate these keys at any time from the same page.

---

## 2. Authentication

All requests rely on the platform's authentication system. You must send the following headers in your requests:

```http
X-Header-App-Id: YOUR_APP_ID
X-Header-Authorization: YOUR_HEADER_TOKEN
Accept: application/json
```

---

## 3. Session & QR Code Management

### POST /api/v1/get-qrcode
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#f680e674-3735-4639-bf43-92a25ced88b1)

This request is used to start the process of linking a new device and generating a QR code.

*   **Parameters (Body):**
    *   `webhook_url` (optional): URL to receive updates (Status & Messages).
*   **Response:** You will receive a QR code in `base64` format to scan using the WhatsApp application.

### GET /api/v1/session-status/{session_id}
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6f12dad1-666f-40e4-956d-04ebd0bd264f)

Verify that the device is still connected and get its current status.

### DELETE /api/v1/delete-session/{session_id}
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#947237c1-7d04-4165-9ccd-b8ab621675e2)

Close the session and permanently delete the connection data from the system.

### POST /api/v1/reconnect-qrcode
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#d4a49cec-6dca-485c-94df-c92cdd177119)

If the session is disconnected, you can request a new QR code for the same device without creating a new session.

---

## 4. Device Management

### GET /api/v1/devices
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#4d3546c5-4fbc-4143-8e40-dc9532547839)

Display all connected devices under your account along with their detailed status.

---

## 5. Sending Messages

### POST /api/v1/send-message
[🔗 Try in Postman (Text)](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6bdb6654-2e5a-4ed8-bdb3-6efb30028e77) | [🔗 Try in Postman (Media)](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6ce3fa98-ad88-4bad-a57b-d76a61ed45e8)

The main endpoint to send messages (text, media, files) to individuals or groups.

*   **Parameters (Body):**
    *   `phone`: Recipient's phone number in international format.
    *   `group`: Group ID.
    *   `body`: Message text.
    *   `media_src`: Direct link to the file.

---

## 6. Groups & Contacts Management

### POST /api/v1/add-contact-numbers
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#d916dcf6-d7f1-47e1-9b6a-da4c7686b1a3)

Upload a list of phone numbers and organize them into a new or existing group.

### GET /api/v1/get-all-groups
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#676290c5-317c-4ca8-a057-b6a27320fa1b)

Get a list of all groups you created previously.

### DELETE /api/v1/delete-group/{group_id}
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#c5e59186-fe02-42a0-815c-ec7e3c83e8e8)

Delete a specific group from the system.

---

Thank you for using **Whats Line**!

# Whats Line Integration Guide - Official WABA

Welcome to the developers' guide for the **Official Integration via Meta (WABA)**. This system provides enterprise-grade stability and advanced features such as approved message templates and interactive buttons.

---

## 1. Getting Integration Keys

1. Go to **Settings** in your account.
2. Select the **API Integration** section.
3. Retrieve your **App ID** and **Header Token**.

---

## 2. Authentication

You must send the following headers in your requests:

```http
X-Header-App-Id: YOUR_APP_ID
X-Header-Authorization: YOUR_HEADER_TOKEN
Accept: application/json
```

---

## 3. Managing WABA Accounts (Devices)

### GET /api/integrate/official/v1/devices
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#701f95f5-a09c-4087-adac-a9687f7c5239)

Get all linked and active WABA accounts.

*   **Response:** List of registered official numbers along with their status.

---

## 4. Message Templates

### GET /api/integrate/official/v1/templates
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#50874bbc-af4b-4a34-ac80-d5bb01684938)

Retrieve all approved templates in your account. Each template includes its associated device ID (`session_id`) to simplify sending.

### GET /api/integrate/official/v1/templates/{id}
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#6b143fba-86f3-42be-bd41-6eb745cd8885)

Display the details of a specific template.

### DELETE /api/integrate/official/v1/templates/{id}
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#1f226775-8888-4936-86b2-689764be5d80)

Delete a template from the system.

---

## 5. Sending Messages using Templates

### POST /api/integrate/official/v1/send-message
[🔗 Try in Postman](https://documenter.getpostman.com/view/13972561/2sAYdimUUV#dc42e621-9682-4937-b755-ea146e78066d)

This endpoint is used to send official messages using templates.

*   **Parameters (Body):**
    *   `phone` (Required): Recipient's phone number (e.g. `2010XXXXXXXX`).
    *   `template_id` (Required): The template's numerical ID in the system.
    *   `device` (Optional): The device ID (`session_id`). If not provided, the system will use the first official device available in the account. **Note:** The template must belong to the selected device.
    *   `body_variables` (Optional): Array containing variable values for the template body (like `{{1}}`, `{{2}}`).
    *   `button_variables` (Optional): Array containing variable values for the buttons (like dynamic URL routes).
    *   `header_media_url` (Optional): Direct link to media file (image, video, document) if the template supports header media.
    *   `header_media_id` (Optional): Pre-uploaded media ID (optional alternative to link).

**Request Example (JSON):**
```json
{
    "phone": "2010XXXXXXXX",
    "template_id": 123,
    "body_variables": ["Dear Customer", "Order #500"],
    "button_variables": ["order_status_abc"],
    "header_media_url": "https://example.com/image.jpg"
}
```

---

Thank you for using **Whats Line - Official Section**!

Whats Line API (Unofficial)

Your technical guide to integrate regular WhatsApp accounts (Multi-Device) into your applications easily and professionally.