> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tin nhắn vị trí trên WhatsApp

> Hướng dẫn cấu hình và gửi tin nhắn vị trí tương tác trên WhatsApp qua Flow Builder ChatbotX giúp khách hàng xem bản đồ và nhận chỉ đường nhanh chóng.

Khi tư vấn khách hàng qua WhatsApp, việc gửi địa chỉ dạng văn bản thông thường thường buộc khách hàng phải tự sao chép rồi dán vào ứng dụng bản đồ để tìm đường. Với tính năng **Tin nhắn vị trí (Location Message)** của WhatsApp Business API trên ChatbotX, bạn có thể gửi trực tiếp một thẻ bản đồ tương tác với ghim tọa độ GPS chuẩn xác.

Khách hàng chỉ cần nhấp vào thẻ tin nhắn trên điện thoại để mở ngay Google Maps hoặc Apple Maps và nhận hướng dẫn đường đi chi tiết từng bước (Turn-by-turn navigation).

![Hiển thị tin nhắn vị trí trên ứng dụng WhatsApp](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_message_phone_view.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=6101fa511ae881a47a42a3449cbcb2c0)

> [!NOTE]
>
> Khối tin nhắn vị trí độc lập này là tính năng đặc thù của giao thức **WhatsApp Business API** và được thiết kế chuyên biệt cho kênh **WhatsApp** trong Flow Builder.

## Cấu trúc thẻ vị trí

Một tin nhắn vị trí gửi tới WhatsApp gồm 4 trường thông tin chính:

| Trường thông tin | Bắt buộc | Giới hạn | Chức năng và Hiển thị |
| :- | :- | :- | :- |
| **Name** | Tùy chọn | Tối đa 1000 ký tự | Tên địa điểm, hiển thị nổi bật bằng chữ màu xanh lục trên thẻ tin nhắn (ví dụ: tên công ty, chi nhánh, nhà hàng). Hỗ trợ chèn biến động qua biểu tượng `{}`. |
| **Address** | Tùy chọn | Tối đa 1000 ký tự | Địa chỉ chi tiết (số nhà, tên đường, phường/xã, quận/huyện, thành phố). Hiển thị ngay dưới tên địa điểm. Hỗ trợ chèn biến động qua biểu tượng `{}`. |
| **Latitude** | **Bắt buộc** | Số thập phân | Tọa độ vĩ độ GPS của địa điểm (ví dụ: `37.4220656` hoặc `10.7950346`). |
| **Longitude** | **Bắt buộc** | Số thập phân | Tọa độ kinh độ GPS của địa điểm (ví dụ: `-122.0840897` hoặc `106.7218322`). |

> [!TIP]
>
> Mặc dù hai trường **Name** và **Address** là tùy chọn, bạn nên luôn điền đầy đủ cả hai để khách hàng nhận diện rõ địa điểm trước khi bấm mở ứng dụng bản đồ.

## Hướng dẫn thiết lập trên Flow Builder

Bạn có thể thêm khối tin nhắn vị trí vào bất kỳ kịch bản tự động nào của kênh WhatsApp theo các bước sau:

**1. Chọn kênh WhatsApp trong khối tin nhắn**

Trong Flow Builder, mở khối **Send Message** mà bạn muốn cấu hình. Tại mục **Choose Channel** trên cùng, chọn kênh **Whatsapp**.

**2. Thêm khối nội dung Location**

Nhấp vào nút **+ Add** bên dưới nội dung văn bản. Menu các khối tin nhắn hỗ trợ trên WhatsApp sẽ xuất hiện. Cuộn xuống dưới cùng danh sách và nhấp chọn **Location**.

![Chọn Location từ menu khối nội dung WhatsApp](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_block_menu.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=871dd137d08bca3a0d99ede74050690f)

**3. Nhập thông tin và tọa độ GPS**

Cửa sổ pop-up **Location** sẽ hiển thị để bạn thiết lập thông số:

![Cửa sổ cấu hình thông số tin nhắn vị trí](https://mintcdn.com/chatbotx/NZTW5lLyvthzKBU1/images/whatsapp_location_modal_settings.png?fit=max\&auto=format\&n=NZTW5lLyvthzKBU1\&q=85\&s=41e2c3c3f4146830eb090d51750ca9fb)

1. **Name (optional):** Nhập tên địa điểm hoặc bấm biểu tượng `</>` để chèn trường tùy chỉnh (Custom Field) nếu muốn cá nhân hóa chi nhánh cho từng khách hàng.
2. **Address (optional):** Nhập địa chỉ cụ thể của cơ sở.
3. **Latitude:** Nhập tọa độ vĩ độ.
4. **Longitude:** Nhập tọa độ kinh độ.

Sau khi điền xong, nhấp nút **Continue** để lưu cấu hình khối.

**4. Xuất bản kịch bản**

Nối các nhánh hành động tiếp theo trong kịch bản (nếu có), sau đó nhấp **Publish** ở góc phải trên cùng để kích hoạt thay đổi trên luồng bot thực tế.

## Cách lấy tọa độ GPS chuẩn xác từ Google Maps

Để lấy tọa độ Latitude và Longitude chính xác tuyệt đối từ Google Maps:

1. Mở [Google Maps](https://www.google.com/maps) trên trình duyệt máy tính.
2. Tìm kiếm địa chỉ văn phòng, cửa hàng hoặc chi nhánh của bạn.
3. Nhấp chuột phải chính xác vào chấm đỏ vị trí trên bản đồ.
4. Nhấp chuột trái vào dòng đầu tiên hiển thị cặp tọa độ số (ví dụ: `21.028511, 105.854444`) để sao chép vào bộ nhớ tạm:
   * Số phía trước dấu phẩy là **Latitude (Vĩ độ)**: `21.028511`
   * Số phía sau dấu phẩy là **Longitude (Kinh độ)**: `105.854444`
5. Dán lần lượt từng giá trị vào hai ô tương ứng trong cửa sổ cấu hình của ChatbotX.

> [!NOTE]
>
> Không dán cả hai số kèm dấu phẩy vào cùng một ô. Vĩ độ và Kinh độ phải được nhập vào hai ô riêng biệt.

## Tình huống ứng dụng thực tế

### Chuỗi cửa hàng và điểm bán lẻ

Khi khách hàng gửi tin nhắn hỏi chi nhánh gần nhất, chatbot có thể hỏi khu vực của khách hoặc đọc trường tùy chỉnh lưu chi nhánh quen thuộc của khách, sau đó tự động gửi đúng thẻ vị trí cửa hàng để khách tiện ghé thăm.

### Nhà hàng, quán cà phê và đặt bàn

Sau khi khách hoàn tất đặt bàn ăn qua chatbot, gửi kèm một tin nhắn văn bản xác nhận cùng thẻ vị trí nhà hàng. Khách chỉ cần mở thẻ để xem chỉ đường khi di chuyển tới quán.

### Tổ chức sự kiện và hội thảo

Trước giờ khai mạc hội thảo từ 2 đến 3 tiếng, gửi tin nhắn nhắc lịch kèm thẻ vị trí trung tâm hội nghị để người tham dự không bị lạc đường hoặc tìm sai cổng vào.

### Điểm nhận hàng và kho vận

Gửi vị trí trạm nhận hàng hoặc kho hàng lưu kho khi khách hàng chọn hình thức tự đến nhận hàng (Click & Collect).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.