Tích hợp Webhook trong nước

Được tạo vào ngày

TimelinesAI cho phép bạn tự động gửi tin nhắn WhatsApp để phản hồi các sự kiện hoặc hành động trong các công cụ bạn đang sử dụng: CRM, Hỗ trợ, Hệ thống tuyển dụng, v.v.

Sự kiện "Gửi tin nhắn"

Có thể hướng dẫn TimelinesAI gửi tin nhắn (có hoặc không có tệp đính kèm) đến một liên hệ cụ thể (có thể là một nhóm). Nếu nhiều tài khoản WhatsApp được kết nối trong không gian làm việc của bạn, bạn cũng có thể chỉ định một tài khoản WhatsApp cụ thể để sử dụng để gửi tin nhắn.

Để thiết lập tích hợp, chủ sở hữu không gian làm việc nên điều hướng đến màn hình "Tích hợp / Webhook đến" và tạo URL mới. Hệ thống bên ngoài nên đăng tin nhắn ở định dạng cụ thể (xem chi tiết bên dưới) lên URL đó.

Hạn chế

  • Kích thước tệp đính kèm tối đa là 2 MB.
  • Không có xác thực ngay lập tức về định dạng số điện thoại của người nhận hoặc kết nối với WhatsApp. Điều hướng đến Giao diện người dùng Dòng thời gian để xác minh trạng thái gửi / đọc của tin nhắn.

Gửi tệp qua webhook đến

Gửi tệp: Tải xuống trực tiếp so với dịch vụ lưu trữ tệp

Bắt buộc phải gửi tệp bằng Liên kết tải xuống trực tiếp. Điều này cho phép người nhận thực sự nhận được tệp.

Trong khi đó, một dịch vụ lưu trữ tệp nên được sử dụng để nó có thể cung cấp liên kết tải xuống trực tiếp. Một liên kết như vậy được kiểm tra tốt nhất thông qua duyệt web ẩn danh / riêng tư; bằng cách dán liên kết vào thanh tìm kiếm. Nếu quá trình tải xuống tệp bắt đầu ngay lập tức, liên kết có thể chấp nhận được. Thay vào đó, nếu bất kỳ loại trang web nào được hiển thị, thì liên kết không thể được sử dụng để gửi tệp.

Trường hợp với các liên kết Dịch vụ lưu trữ tệp là các tệp không thể được tải xuống. Thay vào đó, những gì được tải xuống và gửi là một trang web chia sẻ, có thể dẫn đến tệp "bị hỏng".

Điều này, đến lượt nó, sẽ ảnh hưởng đến tin nhắn của bạn vì người nhận không thể truy cập phương tiện bạn gửi cho họ, làm cho các tệp không sử dụng được. Do đó, điều quan trọng là bạn phải đảm bảo rằng bạn đang gửi các liên kết tải xuống trực tiếp, vì điều này sẽ cho phép họ truy cập tệp mà không gặp bất kỳ sự cố nào.

Bạn cũng có thể chạy thử nghiệm này bằng cách gửi tin nhắn webhook đến một trong các số thử nghiệm của mình. Bạn sẽ có thể xác định cách tệp sẽ hoạt động dựa trên những gì chúng tôi đã xem xét ở đây; nếu bạn nhận được thông báo lỗi như "Tệp bị hỏng", "Tệp không tương thích"; hoặc "Không tải được tài liệu X", sau khi nhấp vào tệp đính kèm, thì đây là Liên kết dịch vụ lưu trữ tệp và phải được thay thế bằng Liên kết tải xuống trực tiếp.

Sử dụng tín dụng

  • Gửi tin nhắn tiêu tốn 1 tín dụng từ hạn ngạch gửi tin nhắn.
  • Gửi tin nhắn có văn bản và tệp đính kèm không trống sẽ tiêu tốn 2 tín dụng từ hạn ngạch gửi tin nhắn.
  • Nếu không thể gửi tin nhắn (không hợp lệ hoặc không được kết nối với số WhatsApp, lỗi máy chủ WhatsApp), hạn ngạch gửi tin nhắn sẽ được khôi phục (thường là trong vòng vài giờ).

Tốc độ gửi tin nhắn

  • Tin nhắn sẽ được gửi với độ trễ ngẫu nhiên khoảng 2 giây giữa mỗi hai tin nhắn (để tránh cơ chế phát hiện spam WhatsApp).
  • Nếu bạn kích hoạt webhook với tần suất dưới 2 giây, tin nhắn sẽ được xếp hàng đợi và gửi đi với độ trễ. Mỗi tin nhắn xếp hàng sẽ tiêu tốn một tín dụng gửi tin nhắn, vì vậy số lượng tin nhắn xếp hàng không được vượt quá hạn ngạch có sẵn.

Cấu hình và hành động Webhook

  • "Đã bật Webhook" - cho phép vô hiệu hóa webhook mà không cần xóa hoàn toàn
  • "Tạo URL mới" - sẽ tạo một URL duy nhất mới, sẽ chấp nhận thông báo. URL trước đó sẽ không còn khả dụng nữa.
  • "Lần gửi cuối cùng" - trạng thái của lần kích hoạt webhook cuối cùng
  • "Nhật ký tải xuống" - nhật ký chi tiết gồm 100 lần kích hoạt cuối cùng, hữu ích để khắc phục sự cố định dạng.

Định dạng yêu cầu webhook

Webhook chấp nhận dữ liệu ở định dạng JSON, bằng yêu cầu POST.

  • "Hành động" (bắt buộc) - hiện tại, chỉ có một giá trị có thể "gửi" được hỗ trợ
  • "văn bản" (bắt buộc) - một tin nhắn được mã hóa UTF-8 văn bản thuần túy sẽ được gửi (không hỗ trợ đánh dấu, ngoại trừ dấu tách dòng "\n"), có thể để trống, nếu tệp được chỉ định.
  • "file_url" (tùy chọn) - URL có thể truy cập công khai của tệp sẽ được tải xuống và gửi dưới dạng tệp đính kèm.
  • "file_name" (tùy chọn) – tên cho tệp đính kèm (phải được cung cấp, nếu URL được chỉ định).

Người nhận có thể được chỉ định bằng cách cung cấp một trong các tham số sau:

  • "chat_id" - id của cuộc trò chuyện như xuất hiện trong TimelinesAI (có thể được tìm thấy trong URL của trang trò chuyện hoặc trong tải trọng của webhook gửi đi). Điều này hỗ trợ gửi tin nhắn đến một nhóm.
  • "jid" - một JID WhatsApp chỉ định liên hệ hoặc nhóm
  • "Điện thoại" - một số điện thoại, được định dạng theo tiêu chuẩn số điện thoại quốc tế, tức là:
    [+] [mã quốc gia] [mã vùng] [số điện thoại địa phương] (ví dụ: +14151231234)
  • "chat_name" - tên chính xác của cuộc trò chuyện như xuất hiện trong TimelinesAI

Nếu nhiều tài khoản WhatsApp được kết nối trong không gian làm việc, hãy sử dụng tham số bổ sung sau để chỉ định tài khoản WhatsApp sẽ được sử dụng:

  • "điện thoại tài khoản whatsapp" (tùy chọn) - chỉ định (dưới dạng số điện thoại, ở định dạng quốc tế) tài khoản WhatsApp để sử dụngе để gửi. Nếu bị bỏ qua, tài khoản WhatsApp đang hoạt động được kết nối gần đây nhất trong không gian làm việc sẽ được sử dụng để gửi. Lưu ý: nếu tham số "chat_id" được chỉ định, "điện thoại tài khoản whatsapp" sẽ bị bỏ qua, vì mỗi cuộc trò chuyện đã được kết nối với một tài khoản WhatsApp cụ thể.

Phản hồi Webhook

Trong trường hợp thành công (yêu cầu đã được xác thực và chấp nhận để gửi), Webhook sẽ phản hồi với trạng thái HTTP 200 và JSON, chứa message_id của thông báo đã tạo:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

Trong trường hợp có lỗi, Webhook sẽ phản hồi với trạng thái HTTP 40X và JSON với các chi tiết về lỗi, ví dụ:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

Ví dụ

Ví dụ 1 - gửi tin nhắn qua tài khoản WA cụ thể đến một số điện thoại cụ thể:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

Ví dụ 2 - gửi tin nhắn có văn bản và tệp đính kèm đến cuộc trò chuyện (hoặc nhóm) được chỉ định bởi id:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://timelines.ai/logo.png",
"file_name" : "logo.png"
}
Admin
Bài viết mới nhất của quản trị viên (xem tất cả)
Mục lục