Node Webhook Start

Bạn muốn truy cập nhanh đến Phân hệ Tự động? Truy cập vào phân hệ Tự động

Nội dung

Giới thiệu về node Webhook Start
Thiết lập node Webhook Start trong quy trình mẫu
Cách gửi dữ liệu tới node Webhook 1Office qua API

Giới thiệu về node HTTP

Node Webhook Start thuộc một trong những node khởi chạy Công việc quy trình. Đây là một giải pháp mạnh mẽ và linh hoạt, giúp khách hàng tự động hóa quy trình làm việc bằng cách tiếp nhận và xử lý thông tin từ các hệ thống khác. Khi khách hàng gửi dữ liệu đến Webhook Office bằng URL được tự động tạo bởi 1Office, Node Webhook Start sẽ ngay lập tức kích hoạt quy trình công việc. Thông tin nhận được sẽ được chuyển tiếp và sử dụng ngay trong các node tiếp theo của quy trình, đảm bảo sự liền mạch và hiệu quả trong xử lý dữ liệu.

Thiết lập node Webhook Start trong quy trình mẫu

Khi cài đặt quy trình mẫu, tại node chọn điều kiện để bắt đầu, người dùng click chọn node Webhooks 1Office. Sau khi nhấp chuột vào node webhook, hệ thống hiển thị form cài đặt:

Bảng mô tả các trường thông tin trong form cài đặt node webhook start:

Trường thông tin	Mô tả
Tiêu đề	Mô tả: Đây là tên của Webhook để bạn có thể dễ dàng nhận diện trong danh sách các webhook. Cách sử dụng: Nhập tên mô tả cho webhook, Ví dụ: "Webhook Đơn Hàng Mới".
URL Webhook 1Office	Mô tả: Đây là URL endpoint mà hệ thống sẽ gửi dữ liệu đến khi webhook được kích hoạt. Cách sử dụng: Copy URL đầy đủ của webhooks 1office đã sinh ra cho mỗi Quy trình, để gắn vào hệ thống mà KH sử dụng để gửi API
Phương thức	Mô tả: Đây là phương thức HTTP mà hệ thống sẽ sử dụng để gửi dữ liệu, gồm các phương thức: GET, POST, PUT. Cách sử dụng: Chọn phương thức phù hợp từ danh sách Ví dụ: GET
Cấu hình trường dữ liệu
Tiêu đề	Mô tả: Đây là tên hiển thị của trường dữ liệu, giúp bạn nhận diện dữ liệu dễ dàng. Cách sử dụng: Nhập tên trường dữ liệu Ví dụ: "Mã đơn hàng".
Tên trường	Mô tả: Đây là tên trường thực tế được gửi trong payload của webhook. Cách sử dụng: Nhập tên trường đúng theo định dạng yêu cầu của hệ thống nhận (Tên trường từ 1 đến 31 ký tự, không chứa ký tự đặc biệt, là chữ số và chữ cái, viết liền. Nối nhau bằng dấu '_') Ví dụ: id, total_value...
Kiểu dữ liệu	Ký tự: Sử dụng cho dữ liệu đầu vào dạng 1 dòng Văn bản: Sử dụng cho dữ liệu đầu vào dạng nhiều dòng Số nguyên: Sử dụng cho dữ liệu đầu vào dạng số nguyên Số thực: Sử dụng cho dữ liệu đầu vào dạng số thực Ngày: Sử dụng cho dữ liệu đầu vào dạng ngày tháng năm Giờ: Sử dụng cho dữ liệu đầu vào dạng giờ phút Email người dùng: Truyền theo email của người đùng để xác định người dùng của hệ thống File: File gửi qua API, dữ liệu gửi file dưới dạng base64 endcode. Dung lượng tối đa 10MB
Bắt buộc	Mô tả: Chỉ định liệu trường dữ liệu này có bắt buộc phải có khi gửi webhook hay không. Cách sử dụng: Chọn "Có" hoặc "Không" từ danh sách thả xuống.

Lưu ý: Chọn đúng Kiểu dữ liệu phù hợp với từng loại trường để đảm bảo lấy được thông tin chính xác. Ví dụ:

Trường Người đề nghị: Chọn Kiểu dữ liệu là Email người dùng để từ email đó,1Office có thể xác định được người dùng của hệ thống.
Trường Số tiền: Chọn Kiểu dữ liệu là Số nguyên
Trường File đính kèm: Chọn kiểu dữ liệu là File

Cách gửi dữ liệu tới node Webhook 1Office qua API

Để gửi thông tin đến node Webhook của 1Office, hệ thống của khách hàng cần đáp ứng các điều kiện và cơ chế xác thực. Sau đó, khách hàng có thể gửi các thông tin, dữ liệu mong muốn đến Công việc quy trình (BPA) qua node Webhook thông qua một hệ thống thứ ba.

Dưới đây là hướng dẫn chi tiết về cách gửi thông tin vào node Webhook 1Office qua API

Cách gửi dữ liệu tới node Webhook 1Office qua API

Bước 1: Chọn phương thức gửi tới node Webhook 1Office

Phương thức: POST

Bước 2: Sử dụng đường link URL của Webhook 1Office cung cấp

URL Webhook: Đây là link do 1Office tự sinh ra và cung cấp cho bạn. Mỗi link đều là duy nhất và được sử dụng để gửi thông tin từ hệ thống của bạn đến node Webhook của 1Office.
Ví dụ URL Webhook: https://bpawebhook-cloud.1office.vn/bpa-webhook/26bef246-2ada-4cbd-bdd1-216175e9fc1a

Bước 3: Thiết lập các thông số Query Parameters

Tên trường dữ liệu (Keys) và giá trị (Values):

order_id: DH_0001
name: Đề xuất mua nguyên vật liệu
user_id: diemquynh2k1k1@gmail.com
file: UEsDBBQABgAIAAAAIQDKJiIMfQEAcAKgAAATAAgCWO
money: 150.000.000
customer_name: Phùng Văn Quyết
description: Em xin đề xuất nhập 500 kg thép không gỉ từ Công ty TNHH Thép Việt để sản xuất.

Bước 4: Nhấn "Send" để gửi yêu cầu

Kiểm tra lại các thông số đã nhập đúng và đầy đủ.
Nhấn nút "Send" để gửi thông tin đến node Webhook 1Office.

Bước 5: Xác nhận phản hồi (Response)

Phản hồi thành công: Nếu nhận được phản hồi như sau, nghĩa là dữ liệu đã được gửi thành công: (Status: 200Ok {"message":"Gửi dữ liệu thành công","error":false})

Lưu ý:

Đảm bảo rằng các tên trường (Keys) nhập đúng với tên trường đã cài đặt ở node Webhook 1Office.
Các giá trị của trường dữ liệu (Values) là những thông tin muốn gửi đến node Webhook 1Office.
Kiểm tra kỹ URL và phương thức gửi để đảm bảo yêu cầu được gửi đúng cách.

Bước 6: Kiểm tra Công việc quy trình sau khi nhận đc thông tin, dữ liệu từ node Webhook

Sau khi hệ thống của khách hàng gửi thông tin cho Webhook 1Office thành công , hệ thống 1Office sẽ tự động tạo ra một công việc quy trình từ quy trình mẫu với đầy đủ các thông tin đã nhận được

Kiểm tra Công việc quy trình sau khi nhận đc thông tin, dữ liệu từ node Webhook

1Office là phần mềm đa chức năng dành cho quản trị doanh nghiệp, giúp tối ưu hoá quy trình làm việc vả nâng cao hiệu suất hoạt động của tổ chức.

Tự động

Quy trình duyệt

Thiết lập quy trình duyệt