Dự án này minh họa việc tích hợp với Bitrix24 sử dụng .NET 8, với các tính năng quản lý liên hệ và thiết lập ứng dụng.
Trước khi bắt đầu, hãy đảm bảo bạn đã cài đặt các công cụ sau:
- Visual Studio 2022
- Ngrok
- .NET 8 SDK
Bạn cũng sẽ cần 2 cổng trống: 5010 và 7269.
Thực hiện theo các bước sau để thiết lập và chạy dự án:
-
Clone project về máy, sau đó vào thư mục và chạy file
Bitrix24Integration.sln. -
Trong Visual Studio, chọn Project -> Configure Startup Projects...
-
Chọn Multiple startup projects và bật Action -> Start cho cả hai project. Nhấn OK.
-
Chạy project (F5 hoặc nút Start).
-
Bật Ngrok bằng cách mở terminal hoặc command prompt và chạy lệnh sau:
ngrok http 5010
-
Truy cập trang Bitrix24 cá nhân của bạn, sau đó chọn Developer resources.
-
Chọn other -> local application.
-
Copy link từ Ngrok (ví dụ:
https://your-ngrok-url.ngrok-free.app) và điền vào trường Install path với/api/Installở cuối. Sau đó, nhấn Save.
Dự án này bao gồm hai bài tập chính: tương tác với Bitrix24 API qua Swagger và quản lý liên hệ thông qua giao diện web.
-
Truy cập trang Swagger UI tại
https://localhost:7289/swagger.
-
Tìm và mở rộng API CallApi. Nhấn Try It Out.
-
Quay lại trang ứng dụng local Bitrix24 để lấy Application ID (Client ID) và Application Key (Client Secret). Điền thông tin này vào các trường tương ứng trong Swagger.
-
Nhấn Execute. Kéo xuống để xem kết quả API.
-
Truy cập trang quản lý liên hệ tại
https://localhost:7269/.
-
Điền Application ID (Client ID) và Application Key (Client Secret) từ Bitrix24 của bạn, sau đó nhấn Lưu.
-
Trên trang chính, bạn có thể thực hiện các hành động: xóa (biểu tượng thùng rác), tìm kiếm, hoặc xem chi tiết liên hệ (biểu tượng bên cạnh thùng rác).
-
Để tạo một liên hệ mới, nhấn Thêm Liên Hệ từ trang chính.
-
Điền vào các trường thông tin liên hệ và nhấn Tạo.
-
Nếu thành công, bạn sẽ tự động được dẫn đến trang chi tiết của liên hệ đó.
-
Tại đây, bạn có thể chỉnh sửa thông tin cơ bản như Tên, Email, Số điện thoại và Website.
-> 
-
Kéo xuống dưới là phần thông tin Bank và Address. Trước tiên, bạn phải tạo một hồ sơ để thêm thông tin này.
-> 
-> 
-
Từ đó, bạn có thể thêm/xóa/sửa các thông tin Bank hoặc Address, hoặc xóa toàn bộ hồ sơ (lưu ý: thao tác này cũng sẽ xóa luôn thông tin Bank và Address kèm theo).
-> 
-> 
-> 
-
Lưu ý quan trọng: Nếu có thông báo lỗi, thường là do thiếu Application ID (Client ID) và Application Key (Client Secret). Nhấn vào nút Thay đổi Credentials để cập nhật chúng.
