---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/extension/bat-dau/init-and-deploy
title: Khởi tạo và Phát triển ZOA Extension
---
# Khởi tạo và Phát triển ZOA Extension


Zalo OA command-line interface (ZOA-CLI) cho phép nhà phát triển (ED) phát triển và triển khai sản phẩm lên Zalo OA Extension Hub. Hướng dẫn này sẽ giúp bạn bắt đầu với ZOA-CLI và phát triển Extension của mình.

## Cài đặt ZOA-CLI

Bạn có thể cài đặt ZOA-CLI bằng npm hoặc yarn:

```bash
# Sử dụng npm
npm i -g zoa-cli

# Hoặc sử dụng yarn
yarn global add zoa-cli
```

Sau khi cài đặt, kiểm tra phiên bản đã cài đặt:

```bash
zoa --version
```

![](/assets/OA/img/extension/zoa-version.png)


## Khởi tạo Dự án

1. Chuyển vào thư mục bạn muốn tạo dự án.
2. Chạy lệnh sau để khởi tạo project:

```bash
zoa init
```

3. Nhập Zalo App ID của bạn khi được yêu cầu.


![](/assets/OA/img/extension/zoa-init.png)

4. Chọn **Login via QR code with Zalo App** để xác thực tài khoản và lấy access token.


![](/assets/OA/img/extension/login-via-qr-code-with-zalo-app.png)

5. Chọn **Create a new ZOA Extension project** và điền thông tin liên quan để tạo project mới.

## Phát triển Dự án

1. Mở project bằng IDE và tiến hành coding.
2. Lưu lại thông tin thay đổi.
3. Chạy lệnh sau để build dự án:

```bash
zoa build
```


## Triển khai (Deploy)

Để triển khai dự án của bạn:

1. Chạy lệnh sau để sync code lên hệ thống quản lý phiên bản:

```bash
zoa deploy
```

2. Kiểm tra kết quả tại trang quản lý phiên bản.

:::info Thông tin
Lệnh `zoa deploy` sẽ đẩy code lên trang quản lý phiên bản. Sau khi deploy thành công, bạn cần truy cập Trang quản lý phiên bản để tiến hành các bước tiếp theo.
:::

## Tài liệu tham khảo

- [NPM Package ZOA-CLI](https://www.npmjs.com/package/zoa-cli)
- [Mẫu dự án đơn giản](https://github.com/zaloplatform/zoa-extension/tree/master/examples/simple-sample)


:::warning Lưu ý:
Trong giai đoạn POC, chỉ có Zalo APP_ID được cấp quyền mới có thể truy cập trang quản lý phiên bản của Extension.
:::