{
    "userId": "{{user_id}}",
    "message": {
        "attachment": {
                "clientAttachmentId": "{{request_id}}",
                "contentType": "video/mp4",
                "fileName": "sample.mp4",
                "url": "https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4",
                "headers": {
                    "header 1": "value 1"
                }
            },
        "text": "along with text",
        "typed": true
    }
}

1. 미디어 API를 사용하여 파일을 업로드합니다. 자세한 내용은 문서를 참조하십시오.
   미디어 API는 URL을 반환합니다. 응답의 예는 다음과 같습니다.

   {
     "result": {
       "mediaUrl": "<instance>/api/now/v1/cs/media/JOBBfkqSq6kDiFzxyinvHhke73O4TZ0j",
       "name": "image.png",
       "state": "available",
       "attachmentId": "e8671b9193209210a755b8e86cba104b"
     }
   }

2. 요청에 미디어 URL을 가상 에이전트 API 사용합니다. JSON 예는 다음과 같습니다.

   {
     "userId": "user123",
     "message": {
       "attachment": {
         "contentType": "image/png",
         "fileName": "image.png",
         "url": "<instance>/api/now/v1/cs/media/JOBBfkqSq6kDiFzxyinvHhke73O4TZ0j"
       },
       "text": "Here is the image",
       "typed": true
     }
   }

1. 요청에 파일 URL을 가상 에이전트 API 사용합니다.
   • 직접 파일 URL:

     {
       "userId": "user123",
       "message": {
         "attachment": {
           "contentType": "application/pdf",
           "fileName": "report.pdf",
           "url": "https://publicserver.com/files/report.pdf"
         },
         "text": "Document attached",
         "typed": true
       }
     }

   • 보호된 파일 URL:

     {
       "userId": "user123",
       "message": {
         "attachment": {
           "contentType": "application/pdf",
           "fileName": "confidential.pdf",
           "url": "https://secureserver.com/files/confidential.pdf",
           "headers": {
             "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
             "X-Custom-Header": "custom-value"
           }
         },
         "text": "Secure document attached",
         "typed": true
       }
     }

2. 미디어 API 사용(동기 모드에서 따름).

1. 메시지 인증은 필수입니다.
   • sys_cs_provider_application에 메시지 인증이 없으면 사용자 연결이 작동하지 않습니다.
   • 메시지 인증을 올바르게 구성해야 합니다. (인증 섹션을 참조하십시오.)
2. 필수 요청 필드입니다.
   • userId 가 존재하고 고유해야 합니다.
   • emailId 가 존재하고 유효해야 합니다.

• 기록이 sys_user 테이블에 있습니다.
• 이메일 필드가 정확히 일치합니다.
• 사용자가 활성 상태입니다. (활성=true)
• 사용자가 잠기지 않았습니다. (locked_out=아니오)
• 단 하나의 사용자 기록만이 이 조건과 일치합니다.

1. 제공자 구성을 확인합니다.
   • sys_cs_provider 테이블로 이동하여 "VA 봇에서 봇 제공자로" 기록을 엽니다.

   • 표 3. 필수 설정

     필드	예상 값
     automatic_link_enabled	예
     automatic_link_action	sn_va_as_service.virtual_agent__bot_to_bot_auto_link_account
     link_account_enabled	예

2. 제공자 사용자 맵을 확인합니다.
   • provider_user_map 테이블로 이동합니다.
   • 필터 기준: 활성=아니오 및 channel_user_id={요청의 userId}.
   • 문제: 활성=아니오인 기록이 있으면 사용자를 자동으로 연결할 수 없습니다.
   • 해결 방법: 관리자는 비활성 기록을 수동으로 삭제하고 연결 요청을 다시 시도해야 합니다.
3. 사용자 지정을 확인합니다.
   • sn_va_as_service.virtual_agent__bot_to_bot_auto_link_account 스크립트를 실행하여 사용자 지정을 검토합니다.
   • 일반적인 커스터마이제이션 문제를 확인합니다.
     • 자동 연결을 방지하는 논리
     • 추가 유효성 확인 검사
     • 수정된 필드 매핑