Tham chiếu API

Receiving Events

call.incomingbeta

Tính năng này đang trong giai đoạn thử nghiệm kín. Hãy liên hệ bộ phận hỗ trợ kỹ thuật để yêu cầu cấp quyền cho không gian làm việc.

call.incoming là hợp đồng dự phòng; hiện chưa mở cuộc gọi đến. Khi được mở, không gian thử nghiệm có thể nhận qua subscribed_events chứa tên sự kiện, *, danh sách rỗng hoặc bỏ qua trường.

Event payload

{
  "id": "evt_call_example",
  "type": "call.incoming",
  "provider": "whatsapp",
  "account_id": "acc_example",
  "occurred_at": "2026-10-10T12:00:42Z",
  "data": {
    "call": {
      "id": "call_example",
      "direction": "inbound",
      "media_type": "voice",
      "state": "ringing"
    },
    "sender": {
      "id": "100000000000002@lid",
      "display_name": "Example"
    },
    "join_url": "https://calls.example.com/call/call_example?ticket=EXAMPLE"
  }
}

Ghi chú

  • call.incoming là hợp đồng dự phòng; hiện chưa mở cuộc gọi đến. Khi được mở, không gian thử nghiệm có thể nhận qua subscribed_events chứa tên sự kiện, *, danh sách rỗng hoặc bỏ qua trường.
  • Quyền nhận sự kiện gọi do is_beta của không gian làm việc quyết định. Với quyền thử nghiệm, subscribed_events là *, rỗng hoặc bị bỏ qua bao gồm sự kiện gọi; danh sách cụ thể chỉ nhận các sự kiện đã liệt kê. Không gian không có quyền vẫn dùng được wildcard nhưng không nhận sự kiện gọi; đăng ký rõ sự kiện gọi trả về 403 beta_feature_not_enabled. Quyền được kiểm tra lại mỗi lần gửi, thử lại và phát lại dead letter; lỗi tra cứu không cho phép gửi. Bản ghi cuộc gọi message.* thông thường độc lập.