# Lead API Backend

{% hint style="info" %}
**Page** : Tương đương 1 domain website. ( eg: abcd.com )

**Conversation** : Một cuộc hội thoại là một thông tin Khách hàng - Client (*client\_id*), gồm có Tên, email hoặc số điện thoại.

**Message** : Một tin nhắn hoặc một sự kiện được tạo ra.
{% endhint %}

## Hướng dẫn tạo kênh thu Lead.

{% tabs %}
{% tab title="1. ĐĂNG NHẬP" %}

* Đăng nhập : [**https://botbanhang.vn/page**](https://botbanhang.vn/page)
* Chọn "**Inbox Pages**"

![Chọn "Inbox Pages"](https://2705101742-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDfRuoSIcFsb2DjQjYD%2F-MDff8GsGQMC4L9bbTM3%2F-MDfiMtssk-tFYfY3jEE%2Fimage.png?alt=media\&token=078b0b98-67b4-4a43-acaa-836ab5faafe5)
{% endtab %}

{% tab title="2. THIẾT LẬP" %}
![Chọn biểu tượng thiết lập](https://2705101742-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDfRuoSIcFsb2DjQjYD%2F-MDff8GsGQMC4L9bbTM3%2F-MDfhb5XSvIA078qSSzv%2Fimage.png?alt=media\&token=4bbd76aa-4a1f-436e-a0ff-133af988708c)
{% endtab %}

{% tab title="3. TẠO MỚI" %}
![Chọn biểu tượng \[+\] để tạo mới](https://2705101742-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDfRuoSIcFsb2DjQjYD%2F-MDff8GsGQMC4L9bbTM3%2F-MDfip_IHMiZPwTEx0nD%2Fimage.png?alt=media\&token=b6417cc9-31e0-4053-8e5b-7dbca1a0a029)
{% endtab %}

{% tab title="4. NHẬP THÔNG TIN" %}
Điền thông tin phù hợp như hình dưới với tên miền của bạn.

![](https://2705101742-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDfRuoSIcFsb2DjQjYD%2F-MDfj0u8CapQSXCssXqZ%2F-MDfjXNRCfzvzhetLKHs%2Fimage.png?alt=media\&token=f3dbd940-47b5-45b1-8e37-ac693409dad5)
{% endtab %}

{% tab title="5. LẤY PAGE\_ID" %}

* Chọn website bạn vừa tạo ở cột bên phải.
* Chọn tab "**Thiết lập chung**" để lấy ID Page như hình bên dưới.

![Thông tin ID PAGE](https://2705101742-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MDfRuoSIcFsb2DjQjYD%2F-MDfj0u8CapQSXCssXqZ%2F-MDfjlrtbodPllAjlQEs%2Fimage.png?alt=media\&token=f87f14bc-93d6-4fde-8d28-ebf628610618)
{% endtab %}
{% endtabs %}

## Create or Update Conversation

<mark style="color:green;">`POST`</mark> `https://chatbox-public.botbanhang.vn/v1/app/conversation/create`

Tạo mới hoặc cập nhật cuộc hội thoại.

#### Request Body

| Name           | Type   | Description                |
| -------------- | ------ | -------------------------- |
| page\_id       | string | Page ID                    |
| client\_id     | string | Client ID                  |
| client\_phone  | string | Số điện thoại khách hàng   |
| client\_name   | string | Tên khách hàng             |
| client\_avatar | string | Url avatar của khách hàng. |
| client\_email  | string | Email của khách hàng.      |

{% tabs %}
{% tab title="200 API hợp lệ." %}

```
{
    "succes": true,
    "code": 200,
    "data": {
        "client_id": "<ID>"
    }
}
```

{% endtab %}

{% tab title="403 API không hợp lệ." %}

```
{
    "succes": false,
    "code": 403,
    "message": "<MESSAGE>"
}
```

{% endtab %}
{% endtabs %}

## Create or Update Message

<mark style="color:green;">`POST`</mark> `https://chatbox-public.botbanhang.vn/v1/app/message/create`

Tạo mới hoặc cập nhật tin nhắn. Limit : **5 Tin nhắn**

#### Request Body

| Name          | Type   | Description         |
| ------------- | ------ | ------------------- |
| page\_id      | string | ID của Page         |
| client\_id    | string | ID của conversation |
| message\_text | string | Nội dung tin nhắn   |

{% tabs %}
{% tab title="200 API hợp lệ" %}

```
{
    "succes": true,
    "code": 200,
    "data": "SUCCESS"
}
```

{% endtab %}

{% tab title="403 API không hợp lệ" %}

```
{
    "succes": false,
    "code": 403,
    "message": "<MESSAGE>"
}
```

{% endtab %}
{% endtabs %}