Plugin cho phép nhúng form báo phí bảo hiểm du lịch Liberty vào bất kỳ trang/bài viết WordPress nào. Khi khách hàng gửi form, dữ liệu được:

• Lưu vào database WordPress (bảng wp_liberty_travel_leads)
• Gửi thông báo qua Telegram Bot
• Tự động hoặc thủ công đẩy sang Mautic (marketing automation)
• Tự động hoặc thủ công đẩy sang EspoCRM (CRM)

Luồng dữ liệu

1. Upload plugin Giải nén file liberty-travel-quote-v1.4.0.zip, upload thư mục liberty-travel-quote/ vào /wp-content/plugins/
2. Kích hoạt Vào WP Admin → Plugins, tìm “Liberty Travel Quote” → Activate. Plugin sẽ tự tạo bảng DB khi activate.
3. Kiểm tra bảng DB Vào phpMyAdmin hoặc công cụ DB, kiểm tra bảng wp_liberty_travel_leads đã tồn tại.
4. Cấu hình (wp-config.php hoặc Admin Settings) Thêm constants Telegram / Mautic / EspoCRM vào wp-config.php hoặc điền trong trang cài đặt.

Bước 1 — Tạo Bot

1. Mở Telegram, tìm @BotFather
2. Gõ /newbot → đặt tên bot → nhận Bot Token

Bước 2 — Lấy Chat ID

1. Add bot vào group hoặc nhắn tin trực tiếp với bot
2. Truy cập URL: https://api.telegram.org/bot<TOKEN>/getUpdates
3. Tìm trường chat.id trong JSON trả về

Bước 3 — Khai báo vào wp-config.php

// Thêm trước dòng "That's all, stop editing!"
define('TELEGRAM_BOT_TOKEN', '123456789:ABCDEFabcdef...');
define('TELEGRAM_CHAT_ID',   '-1001234567890');PHP

Bước 1 — Bật API trong Mautic

1. Đăng nhập Mautic → Settings (⚙) → Configuration → API Settings
2. Bật API enabled? → Yes
3. Bật Enable HTTP basic auth? → Yes
4. Nhấn Save & Close

Bước 2 — Chuẩn bị tài khoản API

Sử dụng trực tiếp username + password đăng nhập Mautic (hoặc tạo user riêng với role có quyền API). Không cần tạo OAuth2 credentials.

Bước 3 — Test API

curl -u "admin:matkhau" \
     https://mt.growstep.vn/api/contacts?limit=1BASH

Nếu trả về JSON danh sách contacts → API đã sẵn sàng.

Bước 4 — Khai báo

Chọn một trong hai cách:

Cách A — wp-config.php (ưu tiên cao hơn):

define('LTQ_MAUTIC_BASE_URL',  'https://mt.growstep.vn');
define('LTQ_MAUTIC_USERNAME',  'admin');
define('LTQ_MAUTIC_PASSWORD',  'matkhau');PHP

Cách B — WP Admin Settings: vào Liberty Leads → Cài đặt, điền Mautic Base URL / Username / Password → Lưu.

Custom fields cần tạo trong Mautic

Bước 1 — Tạo API Key

1. Đăng nhập EspoCRM → Admin → API Keys
2. Nhấn Create API Key
3. Đặt tên (vd: liberty-plugin) → chọn User → Save
4. Copy chuỗi API Key được tạo ra

Bước 2 — Khai báo

Cách A — wp-config.php:

define('LTQ_ESPO_BASE_URL', 'https://crm.example.com');
define('LTQ_ESPO_API_KEY',  'your_api_key_here');PHP

Cách B — WP Admin Settings: vào Liberty Leads → Cài đặt, điền EspoCRM Base URL / API Key → Lưu.

Custom fields cần tạo trong EspoCRM

Sau khi cài đặt và cấu hình xong, chèn shortcode vào trang/bài viết WordPress:

  

    

      
Báo phí bảo hiểm du lịch – Liberty

      

        

          Thời gian
          
            1–3 ngày
            4–6 ngày
            7–10 ngày
            11–14 ngày
            15–18 ngày
            19–22 ngày
            23–27 ngày
            28–31 ngày
            32–38 ngày
            39–45 ngày
            46–52 ngày
            53–59 ngày
            60–66 ngày
            67–73 ngày
          
        

        

          Chương trình
          
            Classic
            Executive
            Premier
          
        

        

          Khu vực
          
            Đông Nam Á
            Châu Á – TBD
            Toàn cầu
          
        

        

          

            
Phí Liberty
            
—
          
        
      


      

        Ngoài Liberty còn có PVI, Hùng Vương, MIC.
        Để so sánh & chọn gói phù hợp, vui lòng để lại SĐT — mình gọi lại tư vấn nhanh.
      

      

        

          
        
        

          
        
        

          
            Gửi thông tin tư vấn
          
        
      


      


      

        * Giá hiển thị là Liberty. Các hãng khác (PVI, Hùng Vương, MIC) sẽ được báo khi gọi lại.
      

      

        
✨ 3 quyền lợi nổi bật của bảo hiểm du lịch:
        

          
🏥 Bảo vệ chi phí y tế khi ốm đau, tai nạn ở nước ngoài.
          
✈️ Hỗ trợ khi trễ, hủy chuyến hoặc hành lý thất lạc.
          
⚖️ Bồi thường trách nhiệm dân sự khi xảy ra sự cố ngoài ý muốn.
        
      

    

  


SHORTCODE

Form sẽ hiển thị với các tính năng:

• Bảng giá Liberty tự tính theo 14 khung thời gian × 3 chương trình × 3 khu vực
• Input tên (tuỳ chọn) và số điện thoại (bắt buộc)
• Submit qua jQuery AJAX → WordPress REST API
• Thông báo thành công/lỗi hiển thị inline

Sau khi kích hoạt plugin, menu Liberty Leads xuất hiện trong WP Admin sidebar.

Trang danh sách Lead

Hiển thị tối đa 300 lead gần nhất với các cột: ID, thời gian, chương trình, khu vực, phí, tên, SĐT, trạng thái Mautic, trạng thái EspoCRM, thao tác, ngày tạo.

Nút Push thủ công

• → Mautic: hiện khi lead chưa được đẩy lên Mautic. Click để push ngay lập tức.
• → EspoCRM: hiện khi lead chưa được đẩy lên EspoCRM. Click để push ngay.

Sau khi push thành công, cột Mautic / EspoCRM hiển thị ✔ kèm ID trả về từ hệ thống.

Trang Cài đặt

Vào Liberty Leads → Cài đặt để:

• Bật/tắt Tự động đẩy Mautic mặc định cho lead mới
• Bật/tắt Tự động đẩy EspoCRM mặc định cho lead mới
• Nhập URL / credentials Mautic & EspoCRM (nếu không dùng wp-config.php)

Thay đổi bảng giá

Mở liberty-travel-quote.php, tìm hàm ltq_price_map() và chỉnh sửa mảng PHP. Giá được encode sang JS tự động qua wp_localize_script().

Thêm hãng bảo hiểm khác

Mở includes/view-shortcode.php để chỉnh HTML form. Logic tính giá nằm trong assets/js/ltq-form.js hàm getPrice().

Dev mode (bỏ qua nonce)

// Chỉ dùng khi develop local (LocalWP, Valet...)
define('LTQ_DEV_MODE', true);PHP