Gapo Work chatbot

Tạo và quản lý bot

Tạo và cấu hình bot

Cấu hình webhook url

Có thể nhập webhook url khi tạo bot hoặc ở bước cấu hình bot. Webhook url là nơi Gapo sẽ gửi request tới khi người dùng có tương tác với bot

Quản lý menu của bot

Câu lệnh được điền thông tin phản hồi sẽ tự động phản hồi và không request tới webhook

Câu lệnh có thông tin phản hồi

Câu lệnh không có thông tin phản hồi, sẽ được request tới webhook để 3rd party xử lý (có thể tạo tin nhắn, sử dụng API)

Câu lệnh không có thông tin phản hồi, 3rd party sẽ nhận webhook và xử lý

Flow tổng thể giữa Gapo Work chatbot với người dùng và 3rd Party

sequenceDiagram
    actor U as User
    participant G as Gapo Chat System
    participant T as 3rd Party

    U->>G: 1/ Chat 1:1 với bot
    alt chưa chat với bot bao giờ
				G->>G: 1.1/ Tạo thread 1:1
        G->>T: 1.2/ Gửi webhook báo User chat với bot lần đầu (nhóm chat mới được tạo)
        T->>G: 1.3/ Tạo tin nhắn chào mừng, sử dụng Open API (optional)
        G->>G: 1.4/ Xử lý tin nhắn (lưu, notify, ...)
        G->>U: 1.5/ Thông báo
    end
    loop
				U->>G: 2/ Đọc tin nhắn
				G->>U: 3/ List tin nhắn
        U->>G: 4/ Lựa chọn option trong menu/nhập input/lựa chọn quick replies
        G->>G: 5/ Xử lý tin nhắn (lưu, notify, ...)
        G->>T: 6/ Gửi webhook input của user lựa chọn/nhập
        T->>T: 7/ Tự xử lý logic
        T->>G: 8/ Tạo tin nhắn với các dạng tin nhắn được cung cấp trong document, sử dụng Open API
        G->>G: 9/ Xử lý tin nhắn (lưu, notify, ...)
        G->>U: 10/ Thông báo
    end

Bot tạo tin nhắn tới chat 1:1 hoặc nhóm chat

Gửi request với method POST tới URL: https://api.gapowork.vn/3rd-bot/v1.0/3rd/messages

Cần gửi kèm các thông tin trên Headers:

• x-gapo-role: service
• x-gapo-api-key: BOT_API_KEY