# Hướng dẫn cài đặt Webhook

Webhook giúp người dùng nhận thông báo theo thời gian thực từ TikTok khi có sự kiện quan trọng xảy ra. Nhờ đó, người dùng có thể tự động cập nhật thông tin mà không cần kiểm tra thủ công, đảm bảo tính kịp thời và chính xác. Người dùng có thể sử dụng webhook để theo dõi các sự kiện, cập nhật sản phẩm hoặc các hoạt động khác liên quan đến tài khoản và cửa hàng TikTok của mình. 

{% hint style="success" %}
Áp dụng cho người dùng sử dụng API DEV
{% endhint %}

## Hướng dẫn cài đặt Webhook

{% hint style="warning" %}
**Lưu ý:** Người dùng cần hoàn tất việc [**Tạo App & Service**](https://tailieu.tikcrm.net/tai-khoan/1.-ket-noi-shop/tao-app-and-sevice-va-lay-authorize-token-tren-tiktok-shop#id-1.-huong-dan-tao-app-and-sevice) để có thể thực hiện quy trình **cài Webhook**
{% endhint %}

{% hint style="success" %}
Nếu đang ở màn hình **Thông tin chi tiết của app đã tạo**, người dùng có thể chuyển sang thực hiện ngay **Bước 4** được hướng dẫn bên dưới.
{% endhint %}

**Bước 1:** Người dùng mở profile đã đăng nhập tài khoản Tiktok shop muốn tạo app.

**Bước 2:** Truy cập vào **TikTok Shop Partner Center** mở **Bảng điều khiển** để chọn app bằng cách thực hiện các thao tác dưới đây:

* Tại trang **Tiktok shop Seller Center** (link truy cập: [**https://seller-us.tiktok.com/homepage**](https://seller-us.tiktok.com/homepage)), nhấp vào **`App & Services (1)`** hiển thị trên màn hình Trang chủ Tiktok Shop, sau đó nhấp chọn **`Develope your own app (2)`** để chuyển hướng sang **Tiktok Shop Partner Center.**

<figure><img src="https://tailieu.tikcrm.net/~gitbook/image?url=https%3A%2F%2F2045924548-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FubfryrDHWEZL5FZTqqve%252Fuploads%252FPJDPLUvpoAOFLQ8TxpmO%252Fimage.png%3Falt%3Dmedia%26token%3Dc12ba8c3-6069-4acb-8dde-d48305998ee2&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=33e7d5ad&#x26;sv=2" alt=""><figcaption></figcaption></figure>

* Tại trang **Tiktok Shop Partner Center** (link truy cập: [**https://partner.us.tiktokshop.com**](https://partner.us.tiktokshop.com/)), nhấp chọn **`Tiktok shop Partner`** ở góc trên bên phải màn hình. **Nếu chưa đăng nhập**, người dùng đăng nhập lại tài khoản tương tự với đăng nhập Tiktok shop để truy cập vào Tiktok Partner. Sau đó, chọn **`Go to Console`** để mở **Bảng điều khiển.**

<figure><img src="https://tailieu.tikcrm.net/~gitbook/image?url=https%3A%2F%2F2045924548-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FubfryrDHWEZL5FZTqqve%252Fuploads%252FmRuLuQ0QP13Wv58x99wt%252Fimage.png%3Falt%3Dmedia%26token%3D03c3ec71-b346-42ac-b323-97cebeca003e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=19a90ce2&#x26;sv=2" alt=""><figcaption></figcaption></figure>

**Bước 3:** Tại **Bảng điều khiển** vừa được mở, người dùng tiếp tục chọn **`App & Services (3)`** sau đó nhấp chọn **App đã được Publish** (Status: **ON**) (4)

<figure><img src="https://tailieu.tikcrm.net/~gitbook/image?url=https%3A%2F%2F2045924548-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FubfryrDHWEZL5FZTqqve%252Fuploads%252FMKD7brhmN9MwReD036rf%252Fimage.png%3Falt%3Dmedia%26token%3D760a4b65-4a7b-4c89-93e5-e7b754011980&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=30d60586&#x26;sv=2" alt=""><figcaption></figcaption></figure>

**Bước 4:** Cài Webhook bằng cách thực hiện các thao tác sau:

* Trên màn hình **Thông tin chi tiết app** vừa hiển thị, người dùng nhấp chọn vào **`Manage Webhook`**

<figure><img src="/files/c7K4hbpqc006findLaIG" alt=""><figcaption></figcaption></figure>

* Một màn hình mới hiển thị, tại phần **Webhook URL** (5), người dùng dán link ở bên dưới. Nhấn **Save (6)**, sau đó **bật các quyền** (7) cho phép.

{% hint style="success" %}

```
https://tiktok-webhook.tikcrm.net/webhook/tiktok-shop
```

{% endhint %}

<figure><img src="/files/GTQtDnGOZfZAoxpXlYew" alt=""><figcaption></figcaption></figure>

**Các quyền cần bật:**

<table data-header-hidden><thead><tr><th width="256"></th><th></th><th></th></tr></thead><tbody><tr><td>1. Order Status Change</td><td>13. New conversation</td><td>22. FBT seller onboarding</td></tr><tr><td>2. Reverse Status Update</td><td>14. New message</td><td>23. Goods match</td></tr><tr><td>3. Recipient Address Update</td><td>15. Product information change</td><td>24. FBT inventory update</td></tr><tr><td>4. Package Update</td><td>16. Product creation</td><td>25. Opportunity Matching Status Change</td></tr><tr><td>5. Product Status Change</td><td>17. Shoppable content posting</td><td>27.  Inventory status change</td></tr><tr><td>6. Seller Deauthorization</td><td>18. Product category change</td><td>33. New message listener</td></tr><tr><td>7. Auth Expire</td><td>19. Size chart change</td><td>35. Tokopedia mirror status change</td></tr><tr><td>11. Cancellation status change</td><td>20. Creator deauthorization</td><td>36. Invoice status change</td></tr><tr><td>12. Order return status change</td><td>21. Inbound FBT order status change</td><td>37. Product audit status change</td></tr></tbody></table>


---

# 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://tailieu.tikcrm.net/tai-khoan/1.-ket-noi-shop/huong-dan-cai-dat-webhook.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.