Sử dụng Tài nguyên dành cho nhà phát triển phần mở rộng Bitrix24. Bạn có thể:
- Tạo một webhook
- Tạo một ứng dụng cục bộ
- Xem tất cả webhooks và ứng dụng của bạn
- Kiểm tra số liệu thống kê yêu cầu cho webhooks và ứng dụng
Trang định giá Bitrix24
Tạo một webhook
Mở Các trường hợp sử dụng phổ biến tab. Bạn sẽ tìm thấy các kịch bản được tạo sẵn, chẳng hạn như:
- Tạo chatbot để thông báo cho nhân viên
- Thêm tập lệnh bán hàng vào biểu mẫu cuộc gọi
Nếu không có mẫu nào phù hợp với nhu cầu của bạn, hãy tạo một webhook tùy chỉnh. Bất kỳ người dùng nào cũng có thể tạo webhook.
Chọn một trường hợp sử dụng và định cấu hình cài đặt.
Webhook để gọi API REST
- Hệ thống tạo ra một chìa khóa bí mật tự động.
- Chỉ người tạo webhook mới có thể nhìn thấy nó.
- Nếu quản trị viên chỉnh sửa webhook của người dùng khác thì khóa sẽ đặt lại và quyền sở hữu sẽ chuyển cho quản trị viên đó.
Giữ khóa bí mật ở chế độ riêng tư. Không đưa nó vào mã hoặc tập lệnh công khai.
Trình tạo yêu cầu REST
Sử dụng trình tạo để:
- Chọn phương pháp và tham số
- Xem mô tả phương pháp
- Tải xuống các ví dụ PHP
URL . Hệ thống tạo một URL dựa trên cài đặt của bạn. Sử dụng URL này trong các hệ thống bên ngoài để thực hiện các yêu cầu.
URL bao gồm:
********.bitrix24.com: Địa chỉ tài khoản Bitrix24 của bạn./nghỉ ngơi: Nó cho thấy thao tác webhook được thực hiện thông qua REST./5: Đây là ID của người dùng đã tạo webhook./iam***********xr3: Đây là khóa bí mật. Sử dụng phím này, bạn có thể xem, chỉnh sửa và xóa dữ liệu trong Bitrix24./crm.lead.update: Đây là phương thức REST API đang được gọi..json: Khi tạo webhook mới, tham số này được sử dụng theo mặc định.?ID=42: Các tham số này là bắt buộc đối với các phương pháp cụ thể. Các tham số được chỉ định sau dấu chấm hỏi và được phân tách bằng ký tự &.
Ví dụ về thực thi phương thức cập nhật
Hãy xem xét một ví dụ về việc sử dụng
crm.***.cập nhật
phương pháp. Với các phương pháp CRM này, ngoại trừ SPA, có một quy tắc chung: ID được chuyển trước, sau đó là một mảng có các giá trị có thể thay đổi trong các trường.
Dưới đây là ví dụ về thực thi phương thức cập nhật trên thanh địa chỉ của trình duyệt:
crm.***.update.json?id=1&fields[TITLE]=Test%20entity&fields[ASSIGNED_BY_ID]=1&fields[UF_CRM_1234567890]=TEST
Xem cách xây dựng các yêu cầu API REST để thực thi trong thanh địa chỉ của trình duyệt:
[method].json?[nếu bạn truyền một mảng, hãy chỉ định trường theo cách này:]fields[[field]]
Các tham số cho các phương pháp khác nhau có thể khác nhau, vì vậy trước tiên hãy kiểm tra từng mô tả phương pháp.
Để kiểm tra yêu cầu của bạn, hãy nhấp vào Thực hiện và xem kết quả.
Gán quyền . Quyết định công cụ Bitrix24 nào có thể được truy cập bằng webhook của bạn. Ví dụ, Nhập khẩu khách hàng trường hợp sử dụng sẽ chỉ hoạt động cho CRM.
Ứng dụng cục bộ
Ứng dụng cục bộ là ứng dụng bạn tạo cho tài khoản Bitrix24 của mình.
Các ứng dụng cục bộ Bắt đầu nhanh
Tìm webhooks và ứng dụng
Mở Tích hợp tab. Bạn có thể xem:
- Tên các webhooks và ứng dụng
- Sự kiện kích hoạt
- Quyền truy cập
- Người sáng tạo
Quản trị viên có thể xem tất cả các mục. Người dùng thông thường chỉ có thể nhìn thấy của riêng họ.
Để tùy chỉnh danh sách:
- nhấp chuột Cài đặt (⚙️) để chọn trường
- sử dụng Thực đơn (≡) để chỉnh sửa hoặc xóa các mục
Xem số liệu thống kê
Mở Thống kê tab để xem số lượng yêu cầu cho từng webhook và ứng dụng.
Sử dụng dữ liệu này để theo dõi tải API REST.
- Chỉ quản trị viên mới có thể truy cập phần này
- Thời gian báo cáo tối đa là 14 ngày
- Sử dụng bộ lọc để xem các mục cụ thể
- nhấp chuột Cài đặt (⚙️) để tùy chỉnh các trường hiển thị
Tóm lại
- sử dụng Tài nguyên dành cho nhà phát triển để mở rộng Bitrix24 bằng webhook và REST API
- Sử dụng mẫu hoặc tạo webhook tùy chỉnh
- Bất kỳ người dùng nào cũng có thể tạo webhook
- Chỉ quản trị viên mới có thể tạo ứng dụng
- Quản lý tích hợp trong Tích hợp tab
- Theo dõi việc sử dụng trong Thống kê tab
