Tích hợp ra nước ngoài

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

Tích hợp ra nước ngoài:
Whatsapp > CRM và các hệ thống khác của bạn

Chia sẻ bài viết này với nhà phát triển của bạn hoặc sử dụng Zapier để tích hợp hệ thống của bạn với Whatsapp

Thiết lập

TimelinesAI cho phép thông báo cho hệ thống bên ngoài khi nhận được hoặc gửi tin nhắn mới trong bất kỳ tài khoản whatsapp nào được kết nối trong không gian làm việc. Điều này bao gồm các tin nhắn whatsapp được gửi qua Ứng dụng di động Whatsapp hoặc từ trong Dòng thời gian.

Nó thường xảy ra trường hợp tích hợp như vậy được sử dụng thông qua một số dịch vụ trung gian như Zapier, trong đó mỗi lần kích hoạt webhook được tính vào việc sử dụng hạn ngạch tác vụ.

Để làm cho việc sử dụng hạn ngạch nhiệm vụ hiệu quả hơn, TimelinesAI cung cấp khả năng tổng hợp nhiều tin nhắn được gửi hoặc nhận trong một cuộc trò chuyện cụ thể trong khoảng thời gian đã chọn. Các tin nhắn thông qua webhook dưới dạng một "gói" duy nhất. Để thuận tiện cho bạn, "gói" như vậy chứa một trường với tổng hợp tin nhắn được định dạng trước (và liên kết đến điểm trong các cuộc hội thoại trong TimelinesAI), nhưng bạn có thể triển khai định dạng của riêng mình bằng cách sử dụng dữ liệu được cung cấp cùng với webhook.

Ảnh chụp màn hình 2021 11 23 tại 12 06 26
Gói tin nhắn được gửi qua webhook

Để thiết lập tích hợp bằng Webhook gửi đi:

  1. Điều hướng đến menu Webhooks trong tài khoản TimelinesAI của bạn
  2. Chọn tab Thư đi .

Ảnh chụp màn hình 2021 11 23 tại 11.47.21

Bạn sẽ được trình bày với các cài đặt sau:

  • Tổng hợp độ chi tiết - các tin nhắn sẽ được tổng hợp và gửi bằng webhook theo lựa chọn (cứ sau 1 / 6 / 12 / 24 giờ) hoặc sẽ được gửi ngay khi chúng xuất hiện trong dòng thời gian ("Không tổng hợp)
  • URL webhook - ở đây bạn cần nhập URL thực tế cần được thông báo.
  • Đã bật Webhook - bạn có thể tắt webhook nếu muốn dừng tích hợp.

Khi Webhook được bật và một số thư được gửi, nhật ký hoạt động sẽ được hiển thị (tối đa 10 hành động gần đây nhất).

Lưu ý: hiện tại, chỉ hỗ trợ tin nhắn văn bản và biểu tượng cảm xúc. Thư có chứa tệp đính kèm sẽ bị bỏ qua.

Lỗi và khắc phục sự cố

Để đảm bảo tích hợp hoạt động chính xác, nếu gặp phải hơn 10 lỗi liên tiếp từ đầu nhận (bất kỳ lỗi nào, từ URL không hợp lệ đến mã phản hồi không phải là 200), hệ thống sẽ tự động vô hiệu hóa tích hợp. Trong trường hợp như vậy, chủ sở hữu không gian làm việc sẽ nhận được thông báo qua email.

Trong trường hợp bạn cần khắc phục lỗi, bạn có thể tải xuống nhật ký chi tiết (liên kết sẽ có sẵn ở cuối trang), trong đó tối đa 100 yêu cầu gần đây nhất sẽ hiển thị với tất cả các chi tiết của dữ liệu được gửi và phản hồi nhận được.

Định dạng dữ liệu

Dữ liệu sẽ được gửi đến URL của Webhook bằng yêu cầu HTTP POST, ở định dạng JSON. Dữ liệu được cung cấp ở 2 định dạng khác nhau, tùy thuộc vào cài đặt Độ chi tiết tổng hợp, như được mô tả bên dưới.

Tổng hợp mỗi X giờ

Tin nhắn sẽ được tổng hợp thành một "gói". Các dữ liệu sau đây sẽ có sẵn:

  • "Tài khoản WhatsApp" - Chi tiết về tài khoản WhatsApp (và đồng đội trong Không gian làm việc, đã kết nối tài khoản), qua đó tin nhắn được nhận hoặc gửi
    • "phone" – số điện thoại của tài khoản WA
    • "full_name" - tên đầy đủ của chủ sở hữu tài khoản WA, như đã đăng ký trong Dòng thời gian
    • "email" - email của chủ sở hữu tài khoản WA, như đã đăng ký trong Dòng thời gian
  • "Trò chuyện" - chi tiết của cuộc trò chuyện (trò chuyện trực tiếp hoặc nhóm), trong đó tin nhắn được gửi hoặc nhận
    • "full_name" – tên trò chuyện (như xuất hiện trong Dòng thời gian)
    • "responsible_name" - tên của một đồng đội được chỉ định là người chịu trách nhiệm cho cuộc trò chuyện này
    • "responsible_email" - email của một đồng đội được chỉ định là người chịu trách nhiệm cho cuộc trò chuyện này
    • "chat_url" - URL, tại đó cuộc trò chuyện có thể được truy cập trong TimelinesUI
    • "chat_id" - ID của cuộc trò chuyện trong TimelinesUI (có thể được sử dụng để tạo URL trò chuyện hoặc với webhook đến)
    • "is_new_chat" - đúng, nếu cuộc trò chuyện này chỉ được tạo, nếu không thì sai
    • "is_group" - đúng, nếu cuộc trò chuyện này là một cuộc trò chuyện trực tiếp, nếu không thì sai
    • "Điện thoại" - Số điện thoại của cuộc trò chuyện (trống cho trò chuyện nhóm)
  • "Tin nhắn" – danh sách các tin nhắn, trong đó mỗi đối tượng tin nhắn chứa các trường sau
    • "Hướng" - có thể được "nhận" hoặc "gửi"
    • "timestamp" – dấu thời gian của thư, theo múi giờ UTC
    • "message_id" – ID duy nhất nội bộ của tin nhắn
    • "Người gửi" - Chi tiết về người gửi (người tham gia trò chuyện) của tin nhắn
      • "full_name" - tiêu đề của cuộc trò chuyện hoặc tên của đồng đội trong Dòng thời gian (nếu được gửi từ bên trong Dòng thời gian)
      • "Điện thoại" - số điện thoại của người gửi (hoặc trống cho trò chuyện nhóm)
    • "Người nhận" - Chi tiết về người gửi (người tham gia cuộc trò chuyện) của tin nhắn
      • "full_name" – tiêu đề của cuộc trò chuyện hoặc tên của đồng đội trong Dòng thời gian
      • "Điện thoại" - số điện thoại của người nhận (hoặc trống cho trò chuyện nhóm)
    • "text" – văn bản tin nhắn (plaintext)
  • "first_message_timestamp" – dấu thời gian của tin nhắn sớm nhất trong gói, theo múi giờ UTC
  • "last_message_timestamp" – dấu thời gian của thư gần đây nhất trong gói, theo múi giờ UTC
  • "tổng hợp" - văn bản tổng hợp của tin nhắn, ở định dạng HTML, phù hợp để sử dụng với CRM hoặc các hệ thống tương tự làm nội dung cho ghi chú, bao gồm liên kết trực tiếp đến tin nhắn đầu tiên trong Dòng thời gian.

Ví dụ

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97254000000"
    },
    "messages" :
    [
        {
            "direction": "sent", 
            "timestamp": "2021-02-24T16:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        },
        {
            "direction": "received", 
            "timestamp": "2021-02-24T16:30:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        }
    ],
    "first_message_timestamp" : "2021-02-24T16:25:29+0000",
    "last_message_timestamp" : "2021-02-24T16:30:29+0000",
    "aggregation":
        "from John Doe on 2021-02-24 16:25: Hi! How are you?<br/>from Jane Smith on 2021-02-24 16:30: I am fine, how are you?<br/>Click <a href='https://app.timelines.ai/permalink/77a28d55-5345-5435-8c72-3a7bcad8ded9/'>here</h> to open the conversation in TimelinesAI"
}

Không tổng hợp

Mỗi tin nhắn được gửi riêng lẻ, ngay khi nó có sẵn. Không có "bó" diễn ra. Các dữ liệu sau đây sẽ có sẵn:

  • "Tài khoản WhatsApp" - Chi tiết về tài khoản WhatsApp (và đồng đội trong Không gian làm việc, đã kết nối tài khoản), qua đó tin nhắn được nhận hoặc gửi
    • "phone" – số điện thoại của tài khoản WA
    • "full_name" - tên đầy đủ của chủ sở hữu tài khoản WA, như đã đăng ký trong Dòng thời gian
    • "email" - email của chủ sở hữu tài khoản WA, như đã đăng ký trong Dòng thời gian
  • "Trò chuyện" - chi tiết của cuộc trò chuyện (trò chuyện trực tiếp hoặc nhóm), trong đó tin nhắn được gửi hoặc nhận
    • "full_name" – tên trò chuyện (như xuất hiện trong Dòng thời gian)
    • "responsible_name" - tên của một đồng đội được chỉ định là người chịu trách nhiệm cho cuộc trò chuyện này
    • "responsible_email" - email của một đồng đội được chỉ định là người chịu trách nhiệm cho cuộc trò chuyện này
    • "chat_url" - URL, tại đó cuộc trò chuyện có thể được truy cập trong TimelinesUI
    • "chat_id" - ID của cuộc trò chuyện trong TimelinesUI (có thể được sử dụng để tạo URL trò chuyện hoặc với webhook đến)
    • "is_new_chat" - đúng, nếu cuộc trò chuyện này chỉ được tạo, nếu không thì sai
    • "is_group" - đúng, nếu cuộc trò chuyện này là một cuộc trò chuyện trực tiếp, nếu không thì sai
    • "Điện thoại" - Số điện thoại của cuộc trò chuyện (trống cho trò chuyện nhóm)
  • "Thông điệp" – chi tiết của tin nhắn
    • "Hướng" - có thể được "nhận" hoặc "gửi"
    • "timestamp" – dấu thời gian của thư, theo múi giờ UTC
    • "message_id" – ID duy nhất nội bộ của tin nhắn
    • "Người gửi" - Chi tiết về người gửi (người tham gia trò chuyện) của tin nhắn
      • "full_name" - tiêu đề của cuộc trò chuyện hoặc tên của đồng đội trong Dòng thời gian (nếu được gửi từ bên trong Dòng thời gian)
      • "Điện thoại" - số điện thoại của người gửi (hoặc trống cho trò chuyện nhóm)
    • "Người nhận" - Chi tiết về người gửi (người tham gia cuộc trò chuyện) của tin nhắn
      • "full_name" – tiêu đề của cuộc trò chuyện hoặc tên của đồng đội trong Dòng thời gian
      • "Điện thoại" - số điện thoại của người nhận (hoặc trống cho trò chuyện nhóm)
    • "text" – văn bản tin nhắn (plaintext)

Ví dụ

{
    "whatsapp_account" :
    {
        "full_name" : "Amnon Haha",
        "email" : "Amnon@acme.com",
        "phone" : "+972500000000"
    },
    "chat": 
    {
        "full_name": "John Doe>",
        "responsible_name": "Amnon",
        "responsible_email": "Amnon@acme.com",
        "chat_url" : "https://app.timelines.ai/chat/10010001/messages/",
        "chat_id" : "10010001",
        "is_new_chat" : true,
        "is_group": false, 
        "phone": "+97251111111"
    },
    "message" :
       {
            "direction": "sent", 
            "timestamp": "2021-02-24T06:25:29+0000",
            "message_id": "ddfskhsd76dsfs6dsd5skjsdhf",
            "sender": {
                "full_name": "John Doe",
                "phone": "+972540000000"
            },
            "recipient": {
                "full_name": "Jane Smith",
                "phone": "+972550000000"
            },
            "text": "lorem ipsum"
        }
}
Admin
Bài viết mới nhất của quản trị viên (xem tất cả)
Mục lục