Thiết lập cá nhân hóa cho các cuộc gọi đến trong ElevenAgents

Thiết lập cá nhân hóa cho các cuộc gọi đến qua Twilio bằng webhook.

Tổng quan

Khi nhận cuộc gọi đến qua Twilio, bạn có thể truy xuất dữ liệu khởi tạo cuộc hội thoại một cách linh hoạt thông qua webhook. Điều này cho phép bạn tùy chỉnh hành vi của agent dựa trên thông tin người gọi và các dữ liệu ngữ cảnh khác.

Cách thức hoạt động

1. Khi nhận được cuộc gọi qua Twilio, ElevenAgents sẽ gửi một yêu cầu webhook đến endpoint mà bạn đã chỉ định, kèm theo các thông tin cuộc gọi (caller_id, agent_id, called_number, call_sid, conversation_id) dưới dạng tham số.
2. Webhook của bạn sẽ phản hồi dữ liệu khởi tạo cuộc hội thoại, bao gồm các biến động (dynamic variable) và những giá trị ghi đè (override) - xem ví dụ bên dưới.
3. Dữ liệu này được sử dụng để bắt đầu cuộc hội thoại.

Cấu hình

1. Thiết lập thông tin webhook

Tại trang cài đặt của ElevenAgents, hãy cấu hình URL webhook và thêm các thông tin bảo mật cần thiết để xác thực.

Nhấp vào webhook để tùy chỉnh các thông tin bảo mật sẽ được gửi trong phần tiêu đề (header) của yêu cầu.

2. Bật tính năng truy xuất dữ liệu khởi tạo cuộc hội thoại

Trong tab Security trên trang của agent, hãy bật tính năng truy xuất dữ liệu khởi tạo cuộc hội thoại cho các cuộc gọi đến qua Twilio, đồng thời xác định các trường có thể được ghi đè.

3. Triển khai endpoint webhook để nhận dữ liệu từ Twilio

Webhook sẽ nhận một yêu cầu POST bao gồm các tham số sau:

4. Trả về dữ liệu khách hàng khi bắt đầu cuộc hội thoại

Webhook của bạn phải trả về phản hồi dạng JSON chứa dữ liệu khởi tạo dành cho agent.

Trường dynamic_variables phải bao gồm tất cả các biến động (dynamic variable) đã được định nghĩa cho agent đó. Trong khi đó, các giá trị ghi đè (override) là tùy chọn. 

Ví dụ về phản hồi:

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "The customer's bank account balance is $100. They are based in San Francisco.",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "Hi, how can I help you today?",
      "language": "en"
    },
    "tts": {
      "voice_id": "new-voice-id"
    },
    "conversation": {
      "text_only": false
    }
  },
  "dynamic_variables": {
    "customer_name": "John Doe",
    "account_status": "premium",
    "last_interaction": "2026-01-15"
  },
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

ElevenAgents sẽ sử dụng các biến động (dynamic variable) để điền dữ liệu khởi tạo cuộc hội thoại, giúp cuộc hội thoại bắt đầu một cách suôn sẻ.

Bảo mật

• Chỉ sử dụng các endpoint HTTPS.
• Triển khai xác thực thông qua tiêu đề yêu cầu (request header).
• Lưu trữ các giá trị nhạy cảm dưới dạng bí mật (secret) thông qua trình quản lý secret của ElevenLabs.
• Xác thực các tham số trong yêu cầu gửi đến.