# HƯỚNG DẪN TÍCH HỢP eSMS và HARAVAN

{% hint style="success" %}
**Mục đích kết nối:**

Giúp người dùng dễ dàng thông báo tình trạng đơn hàng đến khách hàng trên nền tảng Haravan bằng tin SMS thông thường, tin ZNS hoặc Voice.
{% endhint %}

{% hint style="success" %}
**Lợi ích:**

Tiết kiệm thời gian: thông báo tình trạng đơn hàng mà không cần các theo tác làm thủ công.

Quản lí Tin nhắn và chi phí một cách dễ dàng và chính xác nhất.

Có thể tùy chỉnh được nội dung gửi một cách dễ dàng.

Có nhiều sự lựa chọn để tiếp cận với khách hàng như thông qua gửi tin SMS thông thường, ZNS hoặc Voice.
{% endhint %}

**📝 Danh sách các các hook có thể sử dụng được:**

| Tên biến                  | SMS                | ZNS                   |
| ------------------------- | ------------------ | --------------------- |
| Danh xưng                 | Tạo khách hàng mới | <p>Tạo khách hàng mới |
| <br>Đặt hàng thành công   |                    |                       |
| <br>Đang giao hàng        |                    |                       |
| <br>Đã giao hàng          |                    |                       |
| <br>Hủy đơn hàng          |                    |                       |
| <br>Thanh toán thành công |                    |                       |

</p> |
| Tên khách hàng                             | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Tạo khách hàng mới</p> | <p>Tạo khách hàng mới
<br>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p> |
| Mã đơn hàng                                | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                        | <p>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p>                        |
| Giá tiền                                   | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                        | <p>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p>                        |
| Mã vận chuyển                              | <p>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                                                                   | <p>Đang giao hàng
<br>Đã giao hàng</p>                                                                                            |
| Ngày thực hiện                             | <p>Đặt hàng thành công
<br>Tạo khách hàng mới</p>                                                                                | <p>Tạo khách hàng mới
<br>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p> |
| Mã khách hàng                              | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Tạo khách hàng mới</p> | <p>Tạo khách hàng mới
<br>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p> |
| SĐT người nhận                             | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Tạo khách hàng mới</p> | <p>Đặt hàng thành công
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công
</p>                        |
| Ghi chú                                    | Tạo khách hàng mới                                                                                                               | Tạo khách hàng mới                                                                                                                |
| Thời gian thanh toán                       | <p>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                                                                 | <p>Cập nhật đơn hàng
<br>Thanh toán thành công</p>                                                                                |
| Phương thức thanh toán                     | <p>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                                                | <p>Cập nhật đơn hàng
<br>Đang giao hàng
<br>Đã giao hàng
<br>Hủy đơn hàng
<br>Thanh toán thành công</p>                           |
| Mã giảm giá                                | <p>Đặt hàng thành công <br>Hủy đơn hàng</p>                                                                                      | <p>Đặt hàng thành công
<br>Hủy đơn hàng</p>                                                                                       |
| Số tiền giảm giá tương ứng với mã giảm giá | <p>Đặt hàng thành công
<br>Hủy đơn hàng</p>                                                                                      | <p>Đặt hàng thành công
<br>Hủy đơn hàng</p>                                                                                       |
| Đơn vị vận chuyển                          | <p>Đang giao hàng
<br>Đã giao hàng</p>                                                                                           | <p>Đang giao hàng
<br>Đã giao hàng</p>                                                                                            |
| Thời gian giao hàng                        | Đã giao hàng                                                                                                                     | Đã giao hàng                                                                                                                      |
| Tình trạng giao hàng                       | <p>Đang giao hàng
<br>Đã giao hàng</p>                                                                                           | <p>Đang giao hàng
<br>Đã giao hàng</p>                                                                                            |
| Ngày đặt hàng                              | Đặt hàng thành công                                                                                                              | Đặt hàng thành công                                                                                                               |
| Địa chỉ nhận hàng                          | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                        | <p>Đặt hàng thành công
<br>Hủy đơn hàng
<br>Thanh toán thành công
<br>Đang giao hàng
<br>Đã giao hàng</p>                         |

{% hint style="warning" %}

#### Lưu ý trước khi kết nối:

Có 2 trường hợp

Trường hợp 1: Khách hàng đã có tài khoản trên hệ thống eSMS&#x20;

Trường hợp 2: Khách hàng chưa có tài khoản trên hệ thống eSMS
{% endhint %}

#### <mark style="background-color:green;">TRƯỜNG HỢP 1: KHÁCH HÀNG ĐÃ CÓ TÀI KHOẢN TRÊN HỆ THỐNG ESMS NẾU MUỐN KẾT NỐI VÀO ĐÚNG TÀI KHOẢN ĐÓ TRÊN HỆ THỐNG HARAVAN</mark>

#### Bước 1: Vào cửa hàng HARAVAN -> Cấu hình -> Tài khoản

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2F06nZcBMUTyGuLqmMZSdm%2Fimage.png?alt=media\&token=3438bc1d-194d-4de4-ab16-49e82ff35999)

#### Bước 2: Thay "Tài khoản email" và "Điện thoại" là tài khoản và số điện thoại đã đăng ký trên hệ thống eSMS nếu KH đồng ý

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FBYQKIZsUQnx0TrDEzrbr%2Fimage.png?alt=media\&token=084b1d26-93ef-4570-8216-878a278baabc)

#### **Bước 3: Nhấn "Lưu" và tiếp tục kết nối**

#### <mark style="background-color:green;">TRƯỜNG HỢP 2: KHÁCH HÀNG CHƯA CÓ TÀI KHOẢN TRÊN ESMS. KHI KẾT NỐI ỨNG DỤNG ESMS TRÊN HARAVAN SẼ TỰ ĐỘNG TẠO TÀI KHOẢN BÊN ESMS.</mark>

## **HƯỚNG DẪN KẾT NỐI**

#### Bước 1: Vào cửa hàng **HARAVAN** -> Chọn ỨNG DỤNG -> Chọn "Đến kho ứng dụng Haravan"

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FbT87S6r57ALtVBV9Q4gt%2Fimage.png?alt=media\&token=f4664266-bf5a-4968-9859-a904cb4b29e6)

#### Bước 2: Tìm kiếm ứng dụng "eSMS"

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FAkg9r6deve3rQyN97kAH%2Fimage.png?alt=media\&token=1bf3b66e-ebfb-4951-a09e-4c460a286d0b)

#### Bước 3: Nhấn "Cài đặt ứng dụng"

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FPsVk4ATQg7Pso3kcMzET%2Fimage.png?alt=media\&token=85214b89-4f6d-4eee-b043-dc65dacca271)

#### Bước 4: Nhấn "Đồng ý" để hoàn thành kết nối

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FTzTSPfoKiE8uraJ74inc%2Fimage.png?alt=media\&token=a71afcc1-700e-4828-8125-f53403a23951)

### <mark style="color:green;">⚙ TÍCH HỢP GỬI TIN ZNS TRÊN HARAVAN</mark>

#### **Bước 1:** Tạo shop trên Haravan và liên kết với eSMS.

#### **Bước 2:** Đăng nhập vào tài khoản eSMS đã liên kết vào tab "Đối tác" -> Chọn "Haravan".

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2Fz4fjYBjp7ApXUjzoEX4Z%2Fimage.png?alt=media\&token=ecbe525b-1c4a-478d-9d62-54798a7deba8)

#### **Bước 3:** Chọn cửa hàng đã kết nối -> Nhấn "Thiết lập cấu hình".

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2F8qsk1GAh6kVGXmngiBqj%2Fimage.png?alt=media\&token=f2a80a98-e1c1-4405-b729-e8c21912cbe8)

#### Bước 4: Chọn "Cài đặt ZNS đơn hàng" -> Chọn "ZNS OA" -> Chọn "WebhookSend".

{% hint style="warning" %}

#### Những biến đã đăng ký nhưng không khớp với biến mặc định thì khách có thể nhập luôn nội dung cố định vào.

Ví dụ: Biến payment\_date của template đăng ký bên Zalo, hiện chưa có biến này ở cấu hình Haravan thì khách có thể nhập nội dung cố định là ngày nào đó vào.
{% endhint %}

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FyCXAYEjdYObK7BpW05uH%2Fimage.png?alt=media\&token=55b94758-3bc6-4639-8ee1-5a79a806a1b7)

#### Bước 5: Thiết lập kịch bản cho các template đã đăng ký với Zalo -> Có 3 trạng thái đơn hàng&#x20;

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FeujbNqYlnl5eGuapQaiO%2Fimage.png?alt=media\&token=8d5afcad-d5e5-4a4a-862c-ba7cb3a9259c)

#### Bước 6: Thiết lập giá trị cho biến ứng với mỗi template

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FUPoBX8WkcWNfOIXAm5PY%2Fimage.png?alt=media\&token=281cfb57-b8f1-4a39-8c8f-c089aed5b6db)

#### **Bước 6:** Bấm "Lưu" và lên đơn.

### <mark style="color:green;">⚙ TÍCH HỢP GỬI SMS THÔNG THƯỜNG TRÊN HARAVAN</mark>&#x20;

#### Các bước vào tương tự như phần ZNS

#### **Bước 1:** Chọn Cài đặt Tin nhắn đơn hàng à Tích vào trạng thái đơn hàng muốn cấu hình

{% hint style="info" %}
Ví dụ: Tích hợp gửi tin nhắn ở trạng thái đơn là “Thông báo đặt đơn hàng thành công”
{% endhint %}

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FuC5SPd2Cu61i4iUngzwy%2Fimage.png?alt=media\&token=e09046e8-b7e4-4d60-a7fc-7346eb213e34)

#### Các phần còn lại:

#### + Chèn: các biến lấy được để cấu hình vào phần nội dung.

#### + Gửi đến:   Khách hàng: số điện thoại của khách đặt đơn.

#### &#x20;                    Chủ shop: số điện thoại đã đăng ký Store Haravan.

#### + Không gửi cho các kênh bán hàng: ví dụ khi chọn kênh fb thì các đơn lên từ kênh fb sẽ không nhận được tin nhắn thông báo trạng thái “Thông báo đặt đơn hàng thành công”.

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FJl4gbSjz4rkC8lrVCIvb%2Fimage.png?alt=media\&token=f2be80f3-0b80-4cf9-8f79-86269bf9a26c)

#### &#x20;+ Không gửi cho các cổng thanh toán: ví dụ khi chọn “Chuyển khoản qua ngân hàng” thì tất cả các đơn hàng được tạo ra chọn hình thức thanh toán là “Chuyển khoản qua ngân hàng” thì tin nhắn sẽ không gửi đi.

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FNzuRFisH5MkaOYD71Cdh%2Fimage.png?alt=media\&token=565423c7-f74b-4c62-b206-fb0ed1d36bad)

#### **Bước 2:** Bấm "Lưu".

### <mark style="color:green;">⚙ TÍCH HỢP GỌI VOICE TRÊN HARAVAN</mark>

#### **Các bước vào tương tự phần ZNS**

#### **Bước 1:** Chọn Cài đặt gọi tự động đơn hàng à Thực hiện các bước theo thứ tự.

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FlCfTvPuL7ZWtkzJZkyfD%2Fimage.png?alt=media\&token=d83eaae8-a7c6-42cd-83fa-21b36ee82b0d)

{% hint style="info" %}
Kịch bản cuộc gọi được khách hàng tạo ở enduser trên giao diện của eSMS phần Gọi tự động -> Kịch bản cuộc gọi. Cấu hình như 1 kịch bản cuộc gọi bình thường với nội dung và phần biến tương ứng.
{% endhint %}

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2Fr7eN0mMrJ226AnoLmXyb%2Fimage.png?alt=media\&token=9a9459ef-cdb2-41d1-b605-9805252bfda4)

{% hint style="info" %}
Ví dụ: Cấu hình một kịch bản cơ bản nhất từ file ghi âm đã tạo ở tài khoản
{% endhint %}

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2FCjDm514wEhgIC1hMxaqd%2Fimage.png?alt=media\&token=b9a7966f-a3ee-45a7-84c6-8ec5ffc4c3e0)

#### Sau khi bấm Lưu, sẽ có được một kịch bản cuộc gọi mới.

![](https://2439056124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mkl-OfWTN1PASLeoOyn%2Fuploads%2F5sYrPSplzMkb1dA0wLlx%2Fimage.png?alt=media\&token=fec7947f-3671-44d7-8a44-f100c541e26d)

#### Mẫu kịch bản đã tạo ở bước 2 có bao nhiêu biến thì sẽ hiển thị bấy nhiêu ở chỗ này để khách chọn biến tương ứng điền vào.

#### **Bước 2:** Bấm "Lưu" là hoàn thành các bước cấu hình kịch gọi voice.

{% hint style="warning" %}
**Lưu ý:**

Chỉ có thể cấu hình 1 thời điểm là 1 loại (hoặc ZNS hoặc SMS hoặc Voice). Không cùng lúc cấu hình cả >1 được.

Để biết là đang cấu hình loại nào thì khi bấm vào tên shop đã kết nối sẽ dẫn đến cấu hình đang được lưu.

Các WebhookSend là các template Zalo đã được đăng ký và được CS add vào bảng ZNS Template.

Khi cấu hình gọi tự động voice đơn hàng khách hàng phải tạo cho mình 1 kịch bản cuộc gọi trước.

Khi chuyển cấu hình từ voice sang ZNS hoặc SMS vui lòng bỏ dấu tick.
{% endhint %}

{% hint style="danger" %}
**TÀI LIỆU CHỈ ĐƯỢC SỬ DỤNG NỘI BỘ**
{% endhint %}