ONMATE / API INTEGRATION

API Integration

Kết nối các hệ thống để dữ liệu phục vụ công việc liền mạch hơn.

ONMATE khảo sát API, thống nhất dữ liệu cần trao đổi và triển khai kết nối giữa các phần mềm. Giải pháp có kiểm soát truy cập, xử lý lỗi và nhật ký để đội ngũ theo dõi từng lần đồng bộ.

Xem phạm vi dịch vụ Trao đổi nhu cầu

Ánh xạ trường

luong.nhathom.example/ket-noi/website-crm/anh-xa

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Ánh xạ trường

Website sang CRM (mẫu) · bốn trong năm trường

Trường website	Trường CRM	Quy tắc đổi
Họ tên	Tên khách	Giữ nguyên
Điện thoại	Số điện thoại	Bỏ dấu cách
Nguồn	Nguồn lead	Gán Form website
Lời nhắn	Ghi chú	Giữ nguyên

Dữ liệu gửi đi

luong.nhathom.example/ket-noi/website-crm/gui

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Dữ liệu gửi đi

Website sang CRM (mẫu) · yêu cầu POST

Một bản ghi gửi sang CRM

POST crm.nhathom.example/api/lead{  "external_id": "form-0431",  "name": "Khách A (mẫu)",  "phone": "09•••••214",  "source": "Form website",  "note": "Hỏi số lượng"}

Thử lại

Nhật ký tích hợp

luong.nhathom.example/ket-noi/website-crm/lan-goi

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Nhật ký tích hợp

Website sang CRM (mẫu) · gần nhất

Lần gọi gần nhất

05/10 16:40form-0455201 · Đã tạo
05/10 09:30form-0452409 · Bỏ qua
04/10 14:05form-0446Hết thời gian · thử lại xong
04/10 13:50form-0445201 · Đã tạo

HÀNH TRÌNH KẾT NỐI API

Kết nối API đưa dữ liệu sang hệ thống khác, có xử lý lỗi và nhật ký. Người phụ trách khóa.

Sáu chặng từ ghép trường đến nhật ký từng lần gọi. Chọn một chặng để xem việc ở đó.

CHẶNG 01

Ghép trường hai bên

Mỗi trường của website có một trường đích trong CRM, kèm quy tắc đổi. Bảng ánh xạ được thử bằng khách mẫu.

Sáu chặng quay quanh một điểm. Chọn một chặng để đọc chi tiết.

API

SÁU PHẦN VIỆC

Chọn một phần việc để xem
toàn bộ cách làm.

Mỗi phần việc có màn hình làm việc, đầu vào và cách đo riêng.

Chạm vào một thẻ để đổi nội dung bên dưới.

Đang xemÁnh xạ trường dữ liệu

Nội dung của thẻ Ánh xạ trường dữ liệuChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Ánh xạ trường trông thế nào.

Ba màn hình: bảng ánh xạ, bản thử một khách mẫu và phiếu ánh xạ.

Trường nguồn sang trường đích

Mỗi dòng là một trường của website và trường tương ứng trong CRM. Cột cuối nói giá trị được giữ nguyên hay đổi.

Đọc tiếp

Một dòng, một trường đích.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/anh-xa

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Ánh xạ trường

Website sang CRM (mẫu) · bốn trong năm trường

Trường website	Trường CRM	Quy tắc đổi
Họ tên	Tên khách	Giữ nguyên
Điện thoại	Số điện thoại	Bỏ dấu cách
Nguồn	Nguồn lead	Gán Form website
Lời nhắn	Ghi chú	Giữ nguyên

Mỗi trường của website có một trường đích trong CRM. Họ tên sang Tên khách, giữ nguyên.
Số điện thoại bỏ dấu cách trước khi gửi, để CRM nhận một dạng thống nhất.
Nguồn luôn được gán Form website, không lấy từ ô khách nhập, nên cột nguồn của CRM không bị lẫn.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

LÀM NHƯ THẾ NÀO

Năm bước dựng bảng ánh xạ.

Bắt đầu từ danh sách trường của hai bên.

01Chủ shop (mẫu) liệt kê các trường website gửi: họ tên, điện thoại, nguồn và lời nhắn.
02Đọc tài liệu của CRM để biết mỗi trường đích tên là gì và có bắt buộc không.
03Ghép từng trường nguồn với một trường đích, rồi ghi quy tắc đổi nếu hai bên khác dạng.
04Thử bằng một bản mẫu giả, rồi so dữ liệu trước và sau khi đổi.
05Chủ shop (mẫu) duyệt bảng ánh xạ, rồi mới nối thật. Sửa quy tắc thì ghi ngày.

Bạn đưa vào

Trường nguồn
Trường đích
Quy tắc đổi
Bản mẫu

Ánh xạ trườngONMATE cùng doanh nghiệp

Bạn nhận lại

Một bảng ánh xạ đã thử bằng bản mẫu, có quy tắc đổi và người duyệt.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để ánh xạ trường.

Cần danh sách trường hai bên, tài liệu của CRM và vài bản mẫu giả.

NGUYÊN TẮC

Trường bắt buộc phải có đích. Quy tắc đổi phải có ví dụ trước và sau, và dữ liệu thử luôn là dữ liệu giả.

BẢNG ÁNH XẠ

docs.google.com/spreadsheets

nhathom-anh-xaTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Nhóm trường	Số trường	Có quy tắc đổi	Chưa có đích
2	Bắt buộc	3	2	0
3	Không bắt buộc	1	0	0
4	Mã chống trùng	1	0	0
5	Cộng	5	2	0

Theo nhómGhi chú

Ba trường bắt buộc: Họ tên, Điện thoại và Nguồn. Cả ba đều đã có đích trong CRM.
Hai trong ba trường bắt buộc có quy tắc đổi: bỏ dấu cách ở điện thoại và gán cố định nguồn.
Cộng năm trường, không trường nào chưa có đích. Mã lần gửi được dùng để nhận ra lần gửi trùng.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Bắt buộc

Phải có trường đích

Quy tắc đổi

Có ví dụ trước và sau

Để trống

Ghi là trống

Duyệt

Chủ shop (mẫu) duyệt

Bộ tài nguyên4 mục

GốcDanh sách trườngChủ shop (mẫu) liệt kê.
BảngBảng ánh xạNhóm, số trường, quy tắc đổi, thiếu đích.
Quy ướcQuy tắc đổiCó ví dụ trước và sau.
DuyệtPhiếu bảng ánh xạChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: OpenAPI: đặc tả Trang đặc tả OpenAPI. Đọc để biết một API mô tả trường dữ liệu, kiểu giá trị và trường bắt buộc ra sao.
Nguồn: JSON Trang giới thiệu định dạng JSON. Đọc để biết dữ liệu gửi đi được viết thành cặp tên và giá trị thế nào.
Nguồn: Bitrix24: tài liệu REST API Tài liệu API của Bitrix24. Đọc để xem một CRM mô tả trường của lead và cách gửi dữ liệu vào.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗JSON ↗Bitrix24: tài liệu REST API ↗

ĐO ĐIỀU GÌ

Đọc ánh xạ trường.

Đếm trường bắt buộc có đích, trường có quy tắc đổi và quy tắc đổi có ví dụ trước và sau.

CẦN ĐO

Đủ điều kiện chỉ nói bảng ánh xạ đầy đủ, không nói dữ liệu đúng.

ĐỌC ÁNH XẠ

docs.google.com/document/d/1AbC…/edit

Đọc ánh xạ trường – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc ánh xạ trường

Website sang CRM · số trường đủ điều kiện · ví dụ giả định

Điều kiện	Số trường	Trên tổng	Đọc
Trường bắt buộc có đích	3	3	Đủ
Trường có quy tắc đổi	2	5	Đủ
Quy tắc đổi có ví dụ trước và sau	1	2	Còn một

Cả ba trường bắt buộc đều có đích trong CRM, nên không bản ghi nào bị thiếu cột.
Hai trên năm trường có quy tắc đổi. Ba trường còn lại giữ nguyên giá trị.
Mới một trên hai quy tắc đổi có ví dụ trước và sau. Còn một quy tắc cần bổ sung ví dụ.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Trường bắt buộc có đích	Mọi trường bắt buộc có đích	Trường bắt buộc bị bỏ sót
Trường có quy tắc đổi	Trường khác dạng có quy tắc	Gửi nguyên giá trị khác dạng
Quy tắc đổi có ví dụ	Mỗi quy tắc có trước và sau	Quy tắc không có ví dụ
Trường để trống	Ghi là trống	Điền số không thay thế

CÁCH ĐỌC

Ba trên ba trường bắt buộc có đích, hai trên năm trường có quy tắc đổi.

Đọc tiếp

Một trong hai quy tắc đổi còn thiếu ví dụ trước và sau.

LƯU Ý

Bảng chỉ đếm việc ghép trường, không đo dữ liệu thật có đúng, đủ hay mới.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

Hai hệ thống gọi một thứ bằng hai tên

Bắt đầu từ danh sách trường của hai bên.

Liệt kê trường của từng bên
Ghép các trường cùng nghĩa
Ghi chỗ khác tên hay khác dạng
Viết quy tắc đổi cho chỗ khác dạng

Số điện thoại nhập mỗi kiểu một khác

Bắt đầu từ quy tắc đổi định dạng.

Gom vài kiểu viết thực tế
Chọn một dạng chung
Viết quy tắc đổi về dạng chung
Thử bằng ba bản mẫu giả

Có trường mà CRM không có chỗ chứa

Bắt đầu từ việc hỏi người phụ trách CRM.

Ghi trường chưa có đích
Hỏi người phụ trách CRM có nên thêm không
Nếu không thêm thì đưa vào Ghi chú
Cập nhật bảng ánh xạ

DẤU HIỆU

Số điện thoại vào CRM sai dạng

Chỉ số	Giá trị
Hiện tượng	Số điện thoại vào CRM còn dấu cách
Nguyên nhân	Quy tắc bỏ dấu cách chưa được bật
Việc cần làm	Bật quy tắc rồi thử lại bằng bản mẫu

KIỂM TRA

Số hiện với dấu cách hoặc dấu chấm.

DẤU HIỆU

Cột Nguồn trong CRM bị lẫn

Chỉ số	Giá trị
Hiện tượng	Nguồn hiện Form, form và Website lẫn nhau
Nguyên nhân	Nguồn lấy từ ô khách nhập, không gán cố định
Việc cần làm	Gán cố định Form website rồi thử lại

KIỂM TRA

Cùng một nguồn mà có nhiều cách viết.

DẤU HIỆU

Bản ghi thiếu trường ở CRM

Chỉ số	Giá trị
Hiện tượng	Vài lead không có số điện thoại
Nguyên nhân	Trường đích chưa được ghép trong bảng
Việc cần làm	Ghép trường, đối chiếu bảng rồi gửi lại bản mẫu

KIỂM TRA

Có bản ghi được tạo mà trống một cột.

Tài liệu tham khảo:JSON ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã liệt kê trường của cả hai bênMỗi trường nguồn có một trường đíchTrường bắt buộc đều có đíchQuy tắc đổi có ví dụ trước và sauNguồn được gán cố địnhÔ trống được ghi là trốngĐã thử bằng bản mẫu giảChủ shop (mẫu) đã duyệt bảng ánh xạ

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

Nội dung của thẻ Dữ liệu gửi điChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Dữ liệu gửi đi trông thế nào.

Ba màn hình: bản ghi gửi đi, phản hồi của CRM và phiếu bản mẫu.

Một bản ghi gửi đi

Mỗi lead là một bản ghi có tên trường và giá trị. Mã lần gửi đi kèm để CRM nhận ra lần gửi trùng.

Đọc tiếp

Một lead, một mã lần gửi.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/gui

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Dữ liệu gửi đi

Website sang CRM (mẫu) · yêu cầu POST

Một bản ghi gửi sang CRM

POST crm.nhathom.example/api/lead{  "external_id": "form-0431",1  "name": "Khách A (mẫu)",  "phone": "09•••••214",  "source": "Form website",2  "note": "Hỏi số lượng"3}

Mã lần gửi đi kèm mỗi bản ghi. Gửi lại cùng mã thì CRM nhận ra, không tạo thêm.
Nguồn do kết nối gán sẵn là Form website, không lấy từ ô khách nhập.
Lời nhắn là trường không bắt buộc. Có thì gửi, không có thì để trống.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:JSON ↗

LÀM NHƯ THẾ NÀO

Năm bước dựng dữ liệu gửi đi.

Bắt đầu từ bản ghi mà hệ thống đích nhận.

01Đọc đặc tả của CRM: trường nào bắt buộc, kiểu giá trị là gì, mã trạng thái trả về.
02Viết một bản mẫu đúng bằng JSON, với tên giả và số điện thoại giả.
03Thêm mã lần gửi duy nhất cho mỗi bản ghi, để lần gửi trùng bị nhận ra.
04Viết các bản mẫu lỗi: thiếu số điện thoại, nguồn trống, mã đã dùng. Ghi kết quả mong đợi.
05Thử từng bản bằng công cụ thử API, rồi Chủ shop (mẫu) duyệt trước khi bật thật.

Bạn đưa vào

Đặc tả của CRM
Bản mẫu đúng
Bản mẫu lỗi
Mã lần gửi

Dữ liệu gửi điONMATE cùng doanh nghiệp

Bạn nhận lại

Một bộ bản mẫu đúng và lỗi, mỗi bản có kết quả mong đợi và mã lần gửi.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để gửi dữ liệu.

Cần đặc tả của CRM, bản mẫu đúng, bản mẫu lỗi và mã lần gửi.

NGUYÊN TẮC

Mỗi bản ghi một mã lần gửi duy nhất. Bản mẫu lỗi cũng có kết quả mong đợi, và dữ liệu thử luôn là dữ liệu giả.

BẢNG BẢN MẪU

docs.google.com/spreadsheets

nhathom-ban-mauTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Loại bản mẫu	Số bản	Được nhận	Không nhận
2	Bản đúng	1	1	0
3	Bản thiếu trường	2	0	2
4	Bản trùng mã	1	0	1
5	Cộng	4	1	3

Theo loạiGhi chú

Một bản đúng, và CRM nhận bản này. Đây là bản để so với các bản lỗi.
Hai bản thiếu trường: một thiếu số điện thoại, một để trống nguồn. CRM không nhận cả hai, đúng mong đợi.
Cộng bốn bản mẫu, một bản được nhận và ba bản không nhận. Mỗi bản đều có kết quả viết sẵn.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cấu trúc

Theo đặc tả của CRM

Mã lần gửi

Mỗi bản ghi một mã

Bản lỗi

Có kết quả mong đợi

Duyệt

Chủ shop (mẫu) duyệt

Bộ tài nguyên4 mục

GốcĐặc tả của CRMCSKH A (mẫu) đọc và ghi ngày.
BảngBảng bản mẫuLoại bản, số bản, được nhận, không nhận.
Quy ướcMã lần gửiMỗi bản ghi một mã.
DuyệtPhiếu bản mẫuChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: JSON Trang giới thiệu định dạng JSON. Đọc để biết cách viết cặp tên và giá trị, danh sách và dữ liệu lồng nhau.
Nguồn: OpenAPI: đặc tả Trang đặc tả OpenAPI. Đọc để biết một API mô tả dữ liệu gửi đi, kiểu giá trị và trường bắt buộc.
Nguồn: Postman: bắt đầu Trang bắt đầu của Postman. Đọc để biết một công cụ thử API gửi yêu cầu và xem phản hồi thế nào.

Tài liệu tham khảo:JSON ↗OpenAPI: đặc tả mô tả API ↗Postman: bắt đầu ↗

ĐO ĐIỀU GÌ

Đọc dữ liệu gửi đi.

Đếm bản mẫu đúng đã thử, bản mẫu lỗi có kết quả mong đợi và bản mẫu đã đối chiếu đặc tả.

CẦN ĐO

Đủ điều kiện chỉ nói bản mẫu đủ, không nói dữ liệu thật luôn được nhận.

ĐỌC BẢN MẪU

docs.google.com/document/d/1AbC…/edit

Đọc dữ liệu gửi đi – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc dữ liệu gửi đi

Website sang CRM · số bản mẫu đủ điều kiện · ví dụ giả định

Điều kiện	Số bản	Trên tổng	Đọc
Bản mẫu đúng đã thử xong	1	1	Đủ
Bản mẫu lỗi có kết quả mong đợi	3	3	Đủ
Bản mẫu đã đối chiếu đặc tả	3	4	Còn một

Bản mẫu đúng đã thử xong, CRM trả mã đã tạo.
Cả ba bản mẫu lỗi đều có kết quả mong đợi viết sẵn, nên người thử biết thế nào là đúng.
Ba trên bốn bản mẫu đã được đối chiếu với đặc tả. Còn một bản cần đối chiếu.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Bản mẫu đúng đã thử	Bản đúng được CRM nhận	Chưa thử bản nào
Bản mẫu lỗi có kết quả	Bản lỗi có kết quả mong đợi	Bản lỗi không ghi kết quả
Bản mẫu đã đối chiếu	Mọi bản đã đối chiếu đặc tả	Bản chưa đối chiếu
Mã lần gửi	Mỗi bản ghi một mã	Hai bản ghi cùng mã

CÁCH ĐỌC

Bản đúng đã thử xong, ba bản lỗi đều có kết quả mong đợi.

Đọc tiếp

Ba trên bốn bản mẫu đã đối chiếu đặc tả, còn một bản cần đối chiếu.

LƯU Ý

Bảng chỉ đếm bản mẫu, không đo dữ liệu thật của khách có đủ và đúng hay không.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

CRM từ chối bản ghi mà chưa rõ vì sao

Bắt đầu từ so bản ghi với đặc tả.

Lấy bản ghi bị từ chối
Đối chiếu từng trường với đặc tả
Tìm trường thiếu hoặc sai kiểu
Sửa rồi thử lại bằng bản mẫu

Gửi lại làm CRM có hai bản ghi

Bắt đầu từ mã lần gửi.

Xem hai bản ghi trùng nhau
Thêm mã lần gửi cho mỗi bản ghi
Để CRM nhận ra mã đã có
Thử gửi lại cùng một bản mẫu

Chưa biết bản ghi đúng trông thế nào

Bắt đầu từ một bản mẫu đúng.

Đọc ví dụ trong tài liệu của CRM
Viết bản mẫu bằng dữ liệu giả
Thử bằng công cụ thử API
Lưu bản mẫu vào phiếu

DẤU HIỆU

Gửi đi bị từ chối

Chỉ số	Giá trị
Hiện tượng	Bản ghi của Khách B (mẫu) bị từ chối
Nguyên nhân	Thiếu trường số điện thoại bắt buộc
Việc cần làm	Bổ sung trường rồi gửi lại bản mẫu

KIỂM TRA

CRM trả mã 400 cho một bản ghi.

DẤU HIỆU

CRM có hai lead giống nhau

Chỉ số	Giá trị
Hiện tượng	Hai lead cùng một mã form
Nguyên nhân	Bản ghi chưa có mã lần gửi
Việc cần làm	Thêm mã lần gửi rồi thử gửi lại

KIỂM TRA

Cùng một form mà thành hai bản ghi.

DẤU HIỆU

Dữ liệu vào CRM bị lệch cột

Chỉ số	Giá trị
Hiện tượng	Số điện thoại hiện vào cột tên
Nguyên nhân	Tên trường gửi đi không khớp đặc tả
Việc cần làm	Đối chiếu tên trường rồi thử lại

KIỂM TRA

Số điện thoại nằm ở cột tên.

Tài liệu tham khảo:OpenAPI: đặc tả mô tả API ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã đọc đặc tả của CRMCó một bản mẫu đúng bằng JSONMỗi bản ghi có mã lần gửiCó các bản mẫu lỗiMỗi bản mẫu có kết quả mong đợiĐã thử bằng công cụ thử APIDữ liệu thử là dữ liệu giảChủ shop (mẫu) đã duyệt phiếu bản mẫu

Tài liệu tham khảo:Postman: bắt đầu ↗

Nội dung của thẻ Xác thực và quyềnChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Xác thực trông thế nào.

Ba màn hình: khóa và quyền, tiêu đề của yêu cầu và phiếu khóa truy cập.

Một khóa, một quyền

Khóa hiện ở dạng che, kèm ngày đổi gần nhất. Bên dưới là các quyền: khóa của website chỉ được tạo lead.

Đọc tiếp

Quyền đọc và xóa đang tắt.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/khoa

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Khóa truy cập

Website sang CRM (mẫu) · do Chủ shop (mẫu) giữ

Khóa của kết nối

Tên khóawebsite-gui-lead

Giá trịnh•••••••k3

Đổi lần gần nhất01/10

Quyền của khóa

Tạo leadChỉ nhận từ websiteGhi
Đọc leadChưa cần, đang tắtChỉ đọc
Xóa leadKhông cấpGhi

Khóa hiện ra dạng che, chỉ thấy vài ký tự đầu và cuối. Giá trị đầy đủ không hiện trên màn hình.
Khóa được đổi lần gần nhất ngày 01/10. Có ngày đổi thì biết khóa đã dùng được bao lâu.
Khóa này chỉ có quyền tạo lead, và chỉ nhận từ website. Quyền đọc và xóa đang tắt.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:MDN: header Authorization ↗

LÀM NHƯ THẾ NÀO

Năm bước cấp quyền cho kết nối.

Bắt đầu từ việc kết nối cần làm gì, và chỉ vậy thôi.

01Ghi kết nối cần làm gì với CRM: chỉ tạo lead, hay còn đọc hoặc sửa.
02Đọc tài liệu xác thực của CRM để biết dùng khóa truy cập hay OAuth 2.0.
03Tạo khóa với quyền tối thiểu cho đúng việc đó, rồi cất vào kho khóa của công cụ.
04Giao một người phụ trách khóa và ghi ngày đổi gần nhất vào phiếu khóa truy cập.
05Thử bằng dữ liệu giả, rồi thử cả việc bị cấm để thấy CRM từ chối.

Bạn đưa vào

Việc cần làm
Tài liệu xác thực
Khóa và quyền
Người phụ trách

Xác thựcONMATE cùng doanh nghiệp

Bạn nhận lại

Một khóa quyền tối thiểu, cất đúng chỗ, có người phụ trách và ngày đổi.

Tài liệu tham khảo:OAuth 2.0 ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để cấp quyền.

Cần việc của kết nối, tài liệu xác thực của CRM và người phụ trách khóa.

NGUYÊN TẮC

Quyền tối thiểu cho đúng việc. Khóa cất ngoài mã nguồn, có người phụ trách và có ngày đổi, không chép sang bảng tính.

BẢNG KHÓA

docs.google.com/spreadsheets

nhathom-khoa-truy-capTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Loại khóa	Số khóa	Có người giữ	Có ngày đổi
2	Chỉ tạo lead	1	1	1
3	Chỉ đọc lead	1	1	0
4	Toàn quyền	0	0	0
5	Cộng	2	2	1

Theo loạiGhi chú

Một khóa chỉ được tạo lead. Đây là khóa của website, có người giữ và có ngày đổi.
Không cấp khóa toàn quyền, nên hàng này là số không. Đúng với quy tắc quyền tối thiểu.
Hai khóa, cả hai có người giữ. Mới một khóa có ghi ngày đổi, còn một khóa cần bổ sung.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tối thiểu

Chỉ quyền cần dùng

Người phụ trách

Mỗi khóa một người

Ngày đổi

Ghi ngày đổi gần nhất

Nghi lộ

Đổi khóa ngay

Bộ tài nguyên4 mục

GốcDanh sách việcChủ shop (mẫu) liệt kê.
BảngBảng khóaLoại khóa, số khóa, người phụ trách, ngày đổi.
Quy ướcQuyền tối thiểuChỉ quyền cần dùng.
DuyệtPhiếu khóa truy cậpChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: OAuth 2.0 Trang giới thiệu OAuth 2.0. Đọc để biết cách một hệ thống cho ứng dụng khác truy cập mà không đưa mật khẩu.
Nguồn: MDN: header Authorization Trang của MDN về header Authorization. Đọc để biết khóa hoặc mã truy cập được gửi kèm yêu cầu thế nào.
Nguồn: Bitrix24: tài liệu REST API Tài liệu API của Bitrix24. Đọc để xem một CRM mô tả cách xác thực và quyền truy cập.

Tài liệu tham khảo:OAuth 2.0 ↗MDN: header Authorization ↗Bitrix24: tài liệu REST API ↗

ĐO ĐIỀU GÌ

Đọc khóa và quyền.

Đếm khóa có người phụ trách, khóa chỉ có quyền cần dùng và khóa có ghi ngày đổi gần nhất.

CẦN ĐO

Đủ điều kiện chỉ nói khóa được quản lý đủ bước, không nói là an toàn.

ĐỌC KHÓA

docs.google.com/document/d/1AbC…/edit

Đọc khóa và quyền – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc khóa và quyền

Website sang CRM · số khóa đủ điều kiện · ví dụ giả định

Điều kiện	Số khóa	Trên tổng	Đọc
Khóa có người phụ trách	2	2	Đủ
Khóa chỉ có quyền cần dùng	2	2	Đủ
Khóa có ghi ngày đổi gần nhất	1	2	Còn một

Cả hai khóa đều có người giữ, nên khi cần đổi thì biết hỏi ai.
Cả hai khóa chỉ có quyền cần dùng: một khóa tạo lead, một khóa đọc lead.
Mới một trên hai khóa có ghi ngày đổi gần nhất. Khóa còn lại cần bổ sung ngày.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Khóa có người phụ trách	Mỗi khóa có một người	Khóa không ai nhận
Khóa chỉ có quyền cần dùng	Quyền khớp với việc	Khóa quyền rộng
Khóa có ngày đổi gần nhất	Mọi khóa ghi ngày đổi	Khóa không ghi ngày
Khóa nằm ngoài mã nguồn	Mọi khóa trong kho khóa	Khóa trong tệp hay bảng

CÁCH ĐỌC

Cả hai khóa đều có người phụ trách và chỉ có quyền cần dùng.

Đọc tiếp

Mới một trên hai khóa có ghi ngày đổi gần nhất, khóa còn lại cần bổ sung.

LƯU Ý

Bảng chỉ đếm việc quản lý khóa, không kiểm tra khóa có bị lộ hay chưa.

Tài liệu tham khảo:OAuth 2.0 ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

Khóa đang nằm trong mã hoặc bảng tính

Bắt đầu từ việc chuyển khóa vào kho khóa.

Tìm nơi đang chứa khóa
Tạo khóa mới cho kết nối
Cất khóa mới vào kho khóa
Vô hiệu khóa cũ

Chưa rõ khóa này được làm gì

Bắt đầu từ danh sách việc của kết nối.

Liệt kê việc kết nối cần làm
So với quyền khóa đang có
Bỏ quyền không dùng đến
Ghi quyền còn lại vào phiếu

Người phụ trách khóa nghỉ việc

Bắt đầu từ phiếu khóa truy cập.

Xem khóa người đó giữ
Giao khóa cho người mới
Đổi khóa ngay
Ghi ngày đổi vào phiếu

DẤU HIỆU

Kết nối bị từ chối vì khóa

Chỉ số	Giá trị
Hiện tượng	Mọi lần gọi trả mã 401
Nguyên nhân	Khóa đã đổi mà luồng còn dùng khóa cũ
Việc cần làm	Cập nhật khóa trong kho khóa, rồi gọi thử

KIỂM TRA

CRM trả mã 401 hoặc 403.

DẤU HIỆU

Khóa làm được nhiều hơn cần thiết

Chỉ số	Giá trị
Hiện tượng	Khóa của website xóa được lead
Nguyên nhân	Khóa được cấp toàn quyền cho tiện
Việc cần làm	Cấp lại khóa quyền tối thiểu, bỏ khóa cũ

KIỂM TRA

Khóa gửi lead lại đọc và xóa được.

DẤU HIỆU

Không biết khóa dùng bao lâu rồi

Chỉ số	Giá trị
Hiện tượng	Một khóa không có ngày đổi gần nhất
Nguyên nhân	Lần đổi trước chưa ghi vào phiếu
Việc cần làm	Đổi khóa, ghi ngày vào phiếu

KIỂM TRA

Phiếu không có ngày đổi.

Tài liệu tham khảo:MDN: header Authorization ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã ghi việc kết nối cần làmKhóa có quyền tối thiểuKhóa cất trong kho khóa, không nằm trong mãMỗi khóa có một người phụ tráchCó ngày đổi gần nhất trong phiếuĐã thử cả việc bị cấmKhóa không ghi vào nhật kýChủ shop (mẫu) đã duyệt phiếu khóa truy cập

Tài liệu tham khảo:OAuth 2.0 ↗

Nội dung của thẻ Mã lỗi và cách xử lýChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Mã lỗi trông thế nào.

Ba màn hình: bảng mã, luồng xử lý lỗi và phiếu bảng mã lỗi.

Mã trạng thái và việc làm

Mỗi dòng là một mã CRM trả về, nghĩa của mã và việc nên làm. Ba mã lỗi đi ba hướng khác nhau.

Đọc tiếp

Một mã, một việc làm.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/ma-loi

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Mã trạng thái

Website sang CRM (mẫu) · cách đọc từng mã

Mã	Nghĩa	Việc làm
201	Đã tạo	Ghi xong
400	Dữ liệu sai	Dừng, báo người
409	Đã có bản ghi	Bỏ qua, ghi nhật ký
503	Tạm bận	Thử lại

Mã 400 là dữ liệu sai. Thử lại cũng vẫn sai, nên dừng và báo người sửa.
Mã 409 là bản ghi đã có. Kết nối bỏ qua lần gửi này và ghi vào nhật ký.
Mã 503 là CRM tạm bận. Lỗi tạm thời nên được thử lại có giới hạn.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:MDN: HTTP ↗

LÀM NHƯ THẾ NÀO

Năm bước dựng bảng mã lỗi.

Bắt đầu từ các mã mà CRM thật sự trả về.

01Đọc tài liệu HTTP và tài liệu của CRM để biết mỗi mã trạng thái có nghĩa gì.
02Gom các mã thành ba loại: dữ liệu sai, quyền sai và lỗi tạm thời.
03Với mỗi loại, chọn một việc: dừng và sửa, dừng và báo người, hoặc thử lại.
04Thử từng loại bằng bản mẫu giả, rồi ghi mã nhận được vào bảng.
05Chủ shop (mẫu) duyệt bảng. Có mã mới xuất hiện thì thêm một dòng và ghi ngày.

Bạn đưa vào

Tài liệu HTTP
Mã CRM trả về
Việc làm
Bản mẫu lỗi

Mã lỗiONMATE cùng doanh nghiệp

Bạn nhận lại

Một bảng mã lỗi chia ba loại, mỗi loại có một việc làm và người duyệt.

Tài liệu tham khảo:RFC 9110: ngữ nghĩa HTTP ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để xử lý lỗi.

Cần danh sách mã CRM trả về, ba loại lỗi và việc làm cho từng loại.

NGUYÊN TẮC

Mỗi lần lỗi thuộc đúng một loại. Chỉ lỗi tạm thời được thử lại, lỗi dữ liệu và lỗi quyền thì dừng và báo người.

BẢNG LẦN LỖI

docs.google.com/spreadsheets

nhathom-ma-loiTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Kết quả	Số lần gọi	Thử lại	Báo người
2	Đã tạo (201)	36	0	0
3	Lỗi tạm thời	2	2	0
4	Gửi trùng (409)	1	0	0
5	Cộng	39	2	0

Theo kết quảGhi chú

Hai lần gọi gặp lỗi tạm thời: một lần CRM bận, một lần hết thời gian chờ.
Cả hai lần đều đã được thử lại. Không lần lỗi nào bị bỏ qua.
Cộng ba mươi chín lần gọi cho ba mươi sáu bản ghi, vì có hai lần thử lại và một lần gửi trùng.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Ba loại

Dữ liệu, quyền, tạm thời

Việc làm

Mỗi loại một việc

Ghi lại

Mã và lý do

Duyệt

Chủ shop (mẫu) duyệt

Bộ tài nguyên4 mục

GốcDanh sách mãCSKH A (mẫu) lấy từ CRM.
BảngBảng lần lỗiKết quả, lần gọi, thử lại, báo người.
Quy ướcBa loại lỗiDữ liệu, quyền, tạm thời.
DuyệtPhiếu bảng mã lỗiChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: MDN: HTTP Trang giới thiệu HTTP của MDN. Đọc để biết mã trạng thái chia thành nhóm nào và mỗi nhóm nghĩa là gì.
Nguồn: RFC 9110: ngữ nghĩa HTTP Văn bản chuẩn về ngữ nghĩa HTTP. Đọc để tra nghĩa chính thức của từng mã trạng thái.
Nguồn: n8n: xử lý lỗi Trang xử lý lỗi của n8n. Đọc để biết một công cụ luồng cho đặt nhánh riêng khi một bước báo lỗi thế nào.

Tài liệu tham khảo:MDN: HTTP ↗RFC 9110: ngữ nghĩa HTTP ↗n8n: xử lý lỗi ↗

ĐO ĐIỀU GÌ

Đọc mã lỗi.

Đếm lần lỗi đã xếp loại, lỗi tạm thời đã thử lại và lần lỗi có ghi mã và lý do.

CẦN ĐO

Đủ điều kiện chỉ nói lỗi được xử lý đủ bước, không nói hết lỗi.

ĐỌC MÃ LỖI

docs.google.com/document/d/1AbC…/edit

Đọc mã lỗi – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc mã lỗi

Tuần 29/09 – 05/10 · số lần lỗi đủ điều kiện · ví dụ giả định

Điều kiện	Số lần	Trên tổng	Đọc
Lần lỗi đã xếp vào một loại	2	2	Đủ
Lần lỗi tạm thời đã thử lại	2	2	Đủ
Lần lỗi ghi mã và lý do	1	2	Còn một

Cả hai lần lỗi của tuần đã được xếp vào một loại: một lần CRM bận, một lần hết thời gian chờ.
Cả hai lần lỗi tạm thời đều đã được thử lại và đều xong.
Mới một trên hai lần lỗi ghi cả mã và lý do. Lần form-0446 còn thiếu lý do.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Lần lỗi đã xếp loại	Mỗi lần lỗi thuộc một loại	Lần lỗi chưa xếp loại
Lỗi tạm thời đã thử lại	Thử lại trong giới hạn	Thử lại không giới hạn
Lần lỗi ghi mã và lý do	Có cả mã và lý do	Chỉ ghi là lỗi
Lỗi dữ liệu không thử lại	Dừng và báo người	Cứ gửi lại như cũ

CÁCH ĐỌC

Cả hai lần lỗi đã xếp loại và đã thử lại.

Đọc tiếp

Mới một trên hai lần lỗi có ghi mã và lý do, lần còn lại cần bổ sung.

LƯU Ý

Bảng chỉ đếm việc xử lý, không nói CRM có còn trả lỗi trong tương lai hay không.

Tài liệu tham khảo:MDN: HTTP ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

Chưa biết mã nào là lỗi của mình

Bắt đầu từ bảng mã trạng thái.

Lấy các mã trong nhật ký
Tra nghĩa trong tài liệu HTTP
Xếp mã vào ba loại
Ghi việc làm cho từng loại

Mọi lỗi đều bị thử lại như nhau

Bắt đầu từ việc tách lỗi tạm thời.

Liệt kê các lỗi đang thử lại
Chọn lỗi thật sự tạm thời
Cho lỗi còn lại dừng và báo người
Thử lại bằng bản mẫu

Lỗi báo nhưng không ai biết

Bắt đầu từ người nhận báo lỗi.

Chọn người nhận trong luồng
Thêm mã và lý do vào tin báo
Thử bằng một lỗi giả
Ghi người nhận vào phiếu

DẤU HIỆU

Cùng một lỗi lặp lại mỗi ngày

Chỉ số	Giá trị
Hiện tượng	Một bản ghi lỗi 400 lặp lại nhiều lần
Nguyên nhân	Lỗi dữ liệu bị xếp nhầm vào thử lại
Việc cần làm	Chuyển sang dừng và báo người, sửa dữ liệu

KIỂM TRA

Lỗi dữ liệu vẫn được gửi lại.

DẤU HIỆU

Lỗi báo chung chung

Chỉ số	Giá trị
Hiện tượng	Tin báo không có mã lỗi
Nguyên nhân	Luồng chưa gắn mã và lý do vào tin
Việc cần làm	Thêm mã và lý do, rồi thử bằng lỗi giả

KIỂM TRA

Tin báo chỉ ghi là có lỗi.

DẤU HIỆU

Mã mới chưa có trong bảng

Chỉ số	Giá trị
Hiện tượng	Một mã lạ xuất hiện trong nhật ký
Nguyên nhân	Bảng mã lỗi chưa có dòng cho mã này
Việc cần làm	Tra tài liệu, thêm dòng và ghi ngày

KIỂM TRA

CRM trả một mã chưa từng gặp.

Tài liệu tham khảo:n8n: xử lý lỗi ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã đọc tài liệu mã trạng tháiMã được gom thành ba loạiMỗi loại có một việc làmChỉ lỗi tạm thời được thử lạiLỗi dữ liệu và quyền thì dừng và báo ngườiTin báo lỗi có mã và lý doĐã thử bằng lỗi giảChủ shop (mẫu) đã duyệt phiếu bảng mã lỗi

Tài liệu tham khảo:RFC 9110: ngữ nghĩa HTTP ↗

Nội dung của thẻ Thử lại có giới hạnChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Thử lại trông thế nào.

Ba màn hình: cài đặt, một lần gửi có thử lại và một lần gửi trùng.

Cài đặt thử lại

Hai lựa chọn của shop: thử lại tối đa hai lần, chờ ngắn rồi chờ lâu hơn. Hết lần thì dừng và báo CSKH A (mẫu).

Đọc tiếp

Đây là lựa chọn của shop.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/thu-lai

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Cài đặt thử lại

Website sang CRM (mẫu) · lựa chọn của shop

Khi gặp lỗi tạm thời

Số lần thử lạiTối đa hai lần

Cách chờChờ ngắn, rồi chờ lâu hơn

Khi hết lần thử

Việc làmDừng, báo CSKH A (mẫu)

Kèm theoMã lần gửi và lý do

Thử lại tối đa hai lần. Con số này là lựa chọn của shop mẫu, không phải quy định của CRM.
Lần đầu chờ ngắn, lần sau chờ lâu hơn, để không dồn thêm yêu cầu vào lúc CRM đang bận.
Hết lần thử thì dừng và báo CSKH A (mẫu). Luồng không thử mãi.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:n8n: xử lý lỗi ↗

LÀM NHƯ THẾ NÀO

Năm bước đặt thử lại.

Bắt đầu từ việc lỗi nào đáng thử lại.

01Chọn lỗi đáng thử lại: CRM bận hoặc hết thời gian chờ. Lỗi dữ liệu và lỗi quyền thì không.
02Đọc trang xử lý lỗi của công cụ luồng để biết chỗ đặt số lần thử và thời gian chờ.
03Chọn số lần thử và cách chờ. Đây là lựa chọn của shop, ghi vào phiếu và sửa được sau.
04Bảo đảm mỗi bản ghi có mã lần gửi, để CRM nhận ra lần gửi trùng.
05Thử bằng một lỗi giả. Hết lần thử thì kiểm tra luồng có dừng và báo người không.

Bạn đưa vào

Lỗi tạm thời
Số lần, thời gian chờ
Mã lần gửi
Người nhận báo

Thử lạiONMATE cùng doanh nghiệp

Bạn nhận lại

Một cài đặt thử lại có giới hạn, có mã lần gửi và người nhận báo khi hết lần.

Tài liệu tham khảo:n8n: node HTTP Request ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để thử lại.

Cần danh sách lỗi đáng thử lại, số lần, thời gian chờ và mã lần gửi.

NGUYÊN TẮC

Thử lại có giới hạn, không thử mãi. Gửi lại luôn kèm mã lần gửi, và hết lần thì có người nhận báo.

BẢNG LẦN GỌI

docs.google.com/spreadsheets

nhathom-thu-laiTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Loại lần gọi	Số lần	Xong	Không ghi
2	Gọi lần đầu	36	34	2
3	Thử lại	2	2	0
4	Gửi trùng	1	0	1
5	Cộng	39	36	3

Theo lần gọiGhi chú

Ba mươi bốn trong ba mươi sáu lần gọi đầu xong ngay. Hai lần còn lại gặp lỗi tạm thời.
Cả hai lần thử lại đều xong, nên cả ba mươi sáu bản ghi đều được tạo.
Lần gửi trùng không ghi bản ghi mới vì CRM nhận ra mã đã có. Đây là kết quả đúng.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Chỉ lỗi tạm thời

Lỗi khác thì dừng

Có giới hạn

Số lần ghi rõ

Mã lần gửi

Mỗi bản ghi một mã

Người nhận

Báo khi hết lần

Bộ tài nguyên4 mục

GốcDanh sách lỗiCSKH A (mẫu) liệt kê.
BảngBảng lần gọiLoại lần gọi, số lần, xong, không ghi.
Quy ướcSố lần, thời gian chờLựa chọn của shop.
DuyệtPhiếu quy tắc thử lạiChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: n8n: xử lý lỗi Trang xử lý lỗi của n8n. Đọc để biết cách một bước được đặt thử lại và cách luồng đi khi bước vẫn lỗi.
Nguồn: n8n: node HTTP Request Trang node HTTP Request của n8n. Đọc để biết một bước gọi API được đặt các lựa chọn về thử lại ở đâu.
Nguồn: RFC 9110: ngữ nghĩa HTTP Văn bản chuẩn về ngữ nghĩa HTTP. Đọc để biết khi nào gửi lại một yêu cầu là an toàn.

Tài liệu tham khảo:n8n: xử lý lỗi ↗n8n: node HTTP Request ↗RFC 9110: ngữ nghĩa HTTP ↗

ĐO ĐIỀU GÌ

Đọc thử lại.

Đếm lỗi tạm thời đã thử lại, lần gửi trùng được nhận ra và lần thử lại có ghi thời gian chờ.

CẦN ĐO

Đủ điều kiện chỉ nói thử lại đúng quy tắc, không nói mọi lần đều xong.

ĐỌC THỬ LẠI

docs.google.com/document/d/1AbC…/edit

Đọc thử lại – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc thử lại

Tuần 29/09 – 05/10 · số lần gọi đủ điều kiện · ví dụ giả định

Điều kiện	Số lần	Trên tổng	Đọc
Lần lỗi tạm thời đã thử lại	2	2	Đủ
Lần gửi trùng được nhận ra	1	1	Đủ
Lần thử lại ghi thời gian chờ	1	2	Còn một

Cả hai lần lỗi tạm thời của tuần đã được thử lại và đều xong.
Lần gửi trùng form-0452 được nhận ra, nên CRM không có hai bản ghi cho một lead.
Mới một trên hai lần thử lại ghi thời gian chờ. Lần còn lại cần ghi thêm.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Lỗi tạm thời đã thử lại	Thử lại trong giới hạn	Lỗi tạm thời bị bỏ qua
Lần gửi trùng được nhận ra	Trả 409 và bỏ qua	Tạo thêm bản ghi trùng
Lần thử lại ghi thời gian chờ	Có thời gian chờ trong nhật ký	Không rõ chờ bao lâu
Lần hết lần thử	Có báo người nhận	Dừng mà không báo

CÁCH ĐỌC

Cả hai lần lỗi tạm thời đã thử lại, và một lần gửi trùng đã được nhận ra.

Đọc tiếp

Mới một trên hai lần thử lại có ghi thời gian chờ.

LƯU Ý

Bảng chỉ đếm lần gọi theo quy tắc, không so tốc độ hay nói lần sau sẽ xong.

Tài liệu tham khảo:n8n: xử lý lỗi ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

CRM bận mà luồng bỏ luôn bản ghi

Bắt đầu từ việc bật thử lại.

Xem lần gọi bị bỏ trong nhật ký
Bật thử lại cho lỗi tạm thời
Chọn số lần và thời gian chờ
Thử bằng một lỗi giả

Luồng cứ thử mãi không dừng

Bắt đầu từ giới hạn số lần.

Xem luồng đang thử mấy lần
Đặt số lần tối đa
Thêm bước báo người khi hết lần
Ghi vào phiếu quy tắc thử lại

Gửi lại làm CRM có hai bản ghi

Bắt đầu từ mã lần gửi.

Xem hai bản ghi trùng nhau
Thêm mã lần gửi cho mỗi bản ghi
Để CRM trả 409 khi đã có
Thử gửi lại cùng một bản mẫu

DẤU HIỆU

Lần gọi bị bỏ khi CRM bận

Chỉ số	Giá trị
Hiện tượng	Một lead biến mất sau mã 503
Nguyên nhân	Luồng chưa bật thử lại cho lỗi tạm thời
Việc cần làm	Bật thử lại có giới hạn rồi thử bằng lỗi giả

KIỂM TRA

Bản ghi không bao giờ tới CRM.

DẤU HIỆU

Thử lại làm sinh bản ghi trùng

Chỉ số	Giá trị
Hiện tượng	Hai lead giống nhau sau một lần thử lại
Nguyên nhân	Bản ghi chưa có mã lần gửi
Việc cần làm	Thêm mã lần gửi, để CRM nhận ra lần trùng

KIỂM TRA

CRM có hai lead cùng một form.

DẤU HIỆU

Hết lần thử mà không ai biết

Chỉ số	Giá trị
Hiện tượng	Lần gọi lỗi nằm im trong nhật ký
Nguyên nhân	Chưa có bước báo người khi hết lần
Việc cần làm	Thêm bước báo CSKH A (mẫu), kèm mã lần gửi

KIỂM TRA

Không có tin báo nào.

Tài liệu tham khảo:RFC 9110: ngữ nghĩa HTTP ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã chọn lỗi đáng thử lạiSố lần thử lại có giới hạnCó thời gian chờ giữa các lầnMỗi bản ghi có mã lần gửiLỗi dữ liệu và quyền không thử lạiHết lần thì báo ngườiĐã thử bằng một lỗi giảChủ shop (mẫu) đã duyệt quy tắc thử lại

Tài liệu tham khảo:n8n: node HTTP Request ↗

Nội dung của thẻ Nhật ký tích hợpChọn thẻ khác

TRÔNG NHƯ THẾ NÀO

Nhật ký tích hợp trông thế nào.

Ba màn hình: danh sách lần gọi, chi tiết một lần gọi và phiếu xem nhật ký.

Danh sách lần gọi

Mỗi lần gọi một dòng: thời điểm, mã lần gửi và kết quả. Màu cho biết dòng nào cần xem lại.

Đọc tiếp

Một lần gọi, một dòng.

MÔ PHỎNG · SỐ MẪU

luong.nhathom.example/ket-noi/website-crm/lan-goi

✦Công cụ luồng tự độngNhà Thơm (mẫu)Tìm luồngC

LuồngLần chạyKết nốiCài đặt

Nhật ký tích hợp

Website sang CRM (mẫu) · gần nhất

Lần gọi gần nhất

05/10 16:40form-0455201 · Đã tạo
05/10 09:30form-0452409 · Bỏ qua
04/10 14:05form-0446Hết thời gian · thử lại xong
04/10 13:50form-0445201 · Đã tạo

Mỗi dòng là một lần gọi, có thời điểm, mã lần gửi và kết quả. Dòng xanh là lần đã tạo.
Dòng vàng form-0452 là lần gửi trùng, kết quả 409, bỏ qua. Không phải lỗi cần sửa.
Form-0446 hết thời gian chờ rồi thử lại xong. Dòng này cho biết lần lỗi nào đã tự xong sau thử lại.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Tài liệu tham khảo:n8n: lịch sử chạy (executions) ↗

LÀM NHƯ THẾ NÀO

Năm bước dựng nhật ký.

Bắt đầu từ câu hỏi nhật ký phải trả lời được.

01Quyết định mỗi lần gọi ghi gì: thời điểm, mã lần gửi, mã trạng thái và lý do khi lỗi.
02Liệt kê dữ liệu phải che, như số điện thoại và lời nhắn. Khóa truy cập không bao giờ ghi.
03Bật lịch sử chạy của công cụ luồng, rồi đặt mã lần gửi dễ tìm.
04Giao người xem: CSKH A (mẫu) xem lần lỗi mỗi sáng, Chủ shop (mẫu) xem cả tuần.
05Thử tìm một lần gọi cũ bằng mã lần gửi, rồi ghi cách tìm vào phiếu.

Bạn đưa vào

Cột cần ghi
Dữ liệu cần che
Người xem
Mã lần gửi

Nhật kýONMATE cùng doanh nghiệp

Bạn nhận lại

Một nhật ký mỗi lần gọi một dòng, che dữ liệu nhạy cảm, có người xem theo lịch.

Tài liệu tham khảo:n8n: lịch sử chạy (executions) ↗

CẦN CHUẨN BỊ GÌ

Cần chuẩn bị gì để ghi nhật ký.

Cần danh sách cột cần ghi, dữ liệu phải che và người xem.

NGUYÊN TẮC

Ghi đủ để tra lại một lần gọi, và không ghi hơn mức cần. Che số điện thoại, không ghi khóa, và mỗi người xem có lịch.

BẢNG NHẬT KÝ

docs.google.com/spreadsheets

nhathom-nhat-kyTệp Chỉnh sửa Xem Chèn Định dạng Dữ liệu

	A	B	C	D
1	Loại dòng	Số dòng	Có mã lần gửi	Đã che số
2	Lần xong	36	36	36
3	Lần lỗi	2	2	2
4	Lần bỏ qua	1	1	1
5	Cộng	39	39	39

Theo loại dòngGhi chú

Ba mươi sáu dòng là lần gọi đã tạo bản ghi, mỗi dòng một bản ghi.
Hai dòng lỗi vẫn nằm trong nhật ký, kể cả lỗi đã tự xong sau thử lại.
Cả ba mươi chín dòng có mã lần gửi, nên tìm lại được từng lần.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Một dòng

Mỗi lần gọi một dòng

Mã lần gửi

Để tra lại

Che dữ liệu

Số điện thoại, lời nhắn

Không ghi khóa

Dù lỗi hay không

Bộ tài nguyên4 mục

GốcDanh sách cộtCSKH A (mẫu) liệt kê.
BảngBảng nhật kýLoại dòng, số dòng, có mã, đã che.
Quy ướcQuy tắc cheChe số, không ghi khóa.
DuyệtPhiếu xem nhật kýChủ shop (mẫu) duyệt.

Xem đủ thông số và ghi chú

Nguồn: n8n: lịch sử chạy Trang lịch sử chạy của n8n. Đọc để biết một công cụ luồng lưu từng lần chạy và cho xem lại thế nào.
Nguồn: MDN: HTTP Trang giới thiệu HTTP của MDN. Đọc để biết một yêu cầu và phản hồi gồm những phần nào đáng ghi lại.
Nguồn: n8n: xử lý lỗi Trang xử lý lỗi của n8n. Đọc để biết thông tin lỗi của một lần chạy được giữ ở đâu.

Tài liệu tham khảo:n8n: lịch sử chạy (executions) ↗MDN: HTTP ↗n8n: xử lý lỗi ↗

ĐO ĐIỀU GÌ

Đọc nhật ký tích hợp.

Đếm lần gọi có mã lần gửi, lần lỗi ghi mã và lý do và lần gọi đã che số điện thoại.

CẦN ĐO

Đủ điều kiện chỉ nói nhật ký ghi đủ cột, không nói thấy mọi sự cố.

ĐỌC NHẬT KÝ

docs.google.com/document/d/1AbC…/edit

Đọc nhật ký tích hợp – Nhà Thơm (mẫu)

TệpChỉnh sửaXemChènĐịnh dạngCông cụ

Chia sẻ

100%Văn bản thườngArial11BI

Đọc nhật ký tích hợp

Tuần 29/09 – 05/10 · số lần gọi đủ điều kiện · ví dụ giả định

Điều kiện	Số lần	Trên tổng	Đọc
Lần gọi có mã lần gửi	39	39	Đủ
Lần lỗi ghi mã và lý do	1	2	Còn một
Lần gọi đã che số điện thoại	39	39	Đủ

Cả ba mươi chín lần gọi đều có mã lần gửi, nên tìm lại được từng lần.
Mới một trên hai lần lỗi ghi cả mã và lý do. Lần form-0446 cần bổ sung.
Cả ba mươi chín lần gọi đã che số điện thoại trong nhật ký.

Giao diện và số liệu minh họa cho thương hiệu giả định Nhà Thơm; không phải kết quả của khách hàng.

Cách đọc số · số mẫu

Chỉ số	Cho biết	Cần xem lại khi
Lần gọi có mã lần gửi	Mọi lần gọi có mã	Lần gọi không tra lại được
Lần lỗi ghi mã và lý do	Có cả mã và lý do	Chỉ ghi là lỗi
Lần gọi đã che số	Mọi lần gọi đã che	Số điện thoại hiện đủ
Lần gọi có người xem	Có lịch xem rõ	Không ai xem

CÁCH ĐỌC

Cả ba mươi chín lần gọi có mã lần gửi và đã che số điện thoại.

Đọc tiếp

Mới một trên hai lần lỗi có ghi mã và lý do.

LƯU Ý

Bảng chỉ đếm cột đã ghi, không nói nhật ký đã phát hiện hết sự cố hay đạt yêu cầu pháp lý.

Tài liệu tham khảo:n8n: lịch sử chạy (executions) ↗

CÁCH TRIỂN KHAI

Cách xử lý các tình huống thường gặp.

Số trong bảng là số mẫu để minh họa cách đọc, không phải kết quả dự kiến.

Có lead thiếu mà không tra được

Bắt đầu từ mã lần gửi.

Lấy mã form của lead thiếu
Tìm mã đó trong nhật ký
Đọc mã trạng thái của các lần gọi
Làm theo bảng mã lỗi

Nhật ký chứa dữ liệu nhạy cảm

Bắt đầu từ quy tắc che.

Xem nhật ký đang ghi gì
Liệt kê cột phải che
Che số điện thoại và lời nhắn
Xóa khóa khỏi nhật ký nếu có

Không ai xem nhật ký

Bắt đầu từ lịch xem.

Chọn người xem lần lỗi
Đặt giờ xem mỗi ngày
Chọn người xem cả tuần
Ghi lịch vào phiếu xem nhật ký

DẤU HIỆU

Có lần gọi không tra lại được

Chỉ số	Giá trị
Hiện tượng	Một dòng không biết thuộc form nào
Nguyên nhân	Luồng chưa ghi mã lần gửi vào dòng
Việc cần làm	Thêm mã lần gửi vào cột, thử lại bằng bản mẫu

KIỂM TRA

Dòng nhật ký không có mã lần gửi.

DẤU HIỆU

Nhật ký lộ số điện thoại

Chỉ số	Giá trị
Hiện tượng	Số điện thoại hiện đủ trong một dòng
Nguyên nhân	Cột điện thoại chưa có quy tắc che
Việc cần làm	Che cột đó, rồi xóa các dòng đã lộ

KIỂM TRA

Số hiện đủ trong danh sách.

DẤU HIỆU

Lần lỗi không có lý do

Chỉ số	Giá trị
Hiện tượng	Một lần lỗi không có lý do kèm theo
Nguyên nhân	Cột lý do chưa nối với bước báo lỗi
Việc cần làm	Nối cột lý do, rồi thử bằng một lỗi giả

KIỂM TRA

Chỉ ghi là hết thời gian.

Tài liệu tham khảo:n8n: xử lý lỗi ↗

TRƯỚC KHI BẮT ĐẦU

Danh sách kiểm tra.

Đánh dấu từng mục để xem mức sẵn sàng. Trạng thái chỉ lưu trên trình duyệt của bạn.

0%SẴN SÀNG

Đã chọn các cột cần ghiMỗi lần gọi một dòngMỗi dòng có mã lần gửiLần lỗi ghi mã và lý doSố điện thoại đã được cheKhóa truy cập không nằm trong nhật kýĐã giao người xem theo lịchChủ shop (mẫu) đã duyệt phiếu xem nhật ký

Tài liệu tham khảo:MDN: HTTP ↗

NHỚ NHANH

Sáu phần việc, từ ghép trường đến nhật ký.

Chọn một ô để quay lại đúng phần nội dung ở trên.

CÓ THỂ CẦN THÊM

Dịch vụ AI đi cùng.

01Workflow AutomationNối công cụ: kích hoạt, điều kiện, hành động, lỗi.02CRM AutomationGiao người, nhắc việc, cập nhật trạng thái.03Tự động hóa báo cáoLấy dữ liệu, kiểm tra, gửi đúng lịch.

API Integration

Kết nối API đưa dữ liệu sang hệ thống khác, có xử lý lỗi và nhật ký. Người phụ trách khóa.

Ghép trường hai bên

Dựng dữ liệu gửi đi

Cấp khóa tối thiểu

Phân loại mã lỗi

Thử lại có giới hạn

Giữ nhật ký từng lần gọi

Chọn một phần việc để xem toàn bộ cách làm.

Ánh xạ trường dữ liệu — Nối trường của hệ thống này với trường của hệ thống kia, kèm quy tắc đổi.

Ánh xạ trường trông thế nào.

Trường nguồn sang trường đích

Ánh xạ trường

Thử bằng một khách mẫu

Thử một bản mẫu

Từ website

Sang CRM

Phiếu bảng ánh xạ

Bảng ánh xạ trường

Trường bắt buộc1

Trường được đổi2

Trường để trống3

Năm bước dựng bảng ánh xạ.

Cần chuẩn bị gì để ánh xạ trường.

Bắt buộc

Quy tắc đổi

Để trống

Duyệt

Đọc ánh xạ trường.

Đọc ánh xạ trường

Cách xử lý các tình huống thường gặp.

Hai hệ thống gọi một thứ bằng hai tên

Số điện thoại nhập mỗi kiểu một khác

Có trường mà CRM không có chỗ chứa

Danh sách kiểm tra.

Dữ liệu gửi đi — Dựng bản ghi gửi đi đúng cấu trúc, kèm mã lần gửi và bản mẫu.

Dữ liệu gửi đi trông thế nào.

Một bản ghi gửi đi

Dữ liệu gửi đi

Một bản ghi gửi sang CRM

Phản hồi của CRM

Phản hồi của CRM

Mã trạng thái

Nội dung phản hồi

Phiếu bản mẫu

Mẫu dữ liệu gửi đi

Một bản mẫu đúng1

Các bản mẫu lỗi2

Kiểm tra trước khi gửi3

Năm bước dựng dữ liệu gửi đi.

Cần chuẩn bị gì để gửi dữ liệu.

Cấu trúc

Mã lần gửi

Bản lỗi

Duyệt

Đọc dữ liệu gửi đi.

Đọc dữ liệu gửi đi

Cách xử lý các tình huống thường gặp.

CRM từ chối bản ghi mà chưa rõ vì sao

Gửi lại làm CRM có hai bản ghi

Chưa biết bản ghi đúng trông thế nào

Danh sách kiểm tra.

Xác thực và quyền — Cất khóa truy cập an toàn, cấp quyền tối thiểu và có người phụ trách, người đổi.

Xác thực trông thế nào.

Một khóa, một quyền

Khóa truy cập

Khóa của kết nối

Quyền của khóa

Khóa đi kèm yêu cầu

Tiêu đề của yêu cầu

Tiêu đề gửi kèm

Phiếu khóa truy cập

Phiếu khóa truy cập

Ai giữ khóa1

Quyền tối thiểu2

Khi nào đổi khóa3

Năm bước cấp quyền cho kết nối.

Cần chuẩn bị gì để cấp quyền.

Tối thiểu

Người phụ trách

Chọn một phần việc để xem
toàn bộ cách làm.

Trường bắt buộc

Trường được đổi

Trường để trống

Một bản mẫu đúng

Các bản mẫu lỗi

Kiểm tra trước khi gửi

Ai giữ khóa

Quyền tối thiểu

Khi nào đổi khóa

Lỗi dữ liệu

Lỗi quyền

Lỗi tạm thời