March 12, 2026

Context

UJET 플랫폼은 다양한 CRM(Zendesk, Brightspeed, Salesforce, HubSpot)과 통합되면서 콜 라우팅, 녹음 저장, 큐 관리, 에이전트 상태 추적 등에서 다중 시스템 연동 오류가 누적되었다. 또한 가상 에이전트, 웹SDK, 채팅 어댑터 등 여러 채널에서 메타데이터 불일치, 파일 구성 오류, 접근성 문제가 발생하고 있었다.

Technical Solution

• Zendesk click-to-dial에서 비공개 노트 기반 통화 시 기존 티켓 조회 실패 → 노트 컨텍스트 전달 로직 수정으로 아웃바운드 콜 시 기존 티켓 표시 복원
• Brightspeed 에이전트 어댑터의 CRM 링크 미작동 → 콜/채팅 중 링크 오픈 가능 상태로 변경
• 콜 녹음을 MP3에서 WAV로 변환 실패 → WAV 포맷 변환 프로세스 재구현으로 Call Quality Assurance 도구 호환성 복구
• Alvaria Workforce 통합에서 RECORDKEY 값에 임의 접미사 추가로 파일 거부 → RECORDKEY 생성 로직에서 접미사 제거
• 채팅 메타데이터 파일이 채팅 종료 날짜와 맞지 않는 폴더에 저장 → 메타데이터와 트랜스크립트 파일을 동일한 채팅 종료 날짜로 정렬
• 에이전트 상태 지속 시간이 로그아웃/오프라인 후에도 계속 누적 → 로그아웃/오프라인 시점에 상태 누적 중지 로직 추가
• .today 도메인 웹 큐 리다이렉트 미작동 → 도메인 검증 로직에서 .today 추가 허용
• HTML 엔티티(/) 렌더링 문제 → 팀명에서 정규 슬래시(/) 문자로 복원
• WebSocket 접속 만료로 인한 에이전트 접속 불가 → WebSocket 재연결 및 상태 유지 로직 개선
• 대용량 큐 목록 로딩 시간 초과 → 페이지네이션 또는 지연 로딩 방식으로 변경
• SSO 인증 사용자의 프로필 업데이트 불가 → SSO 토큰 검증 로직에서 비밀번호 필수 조건 제거
• 콜 녹음 링크 HubSpot 케이스 미푸시 → HubSpot API 호출 타이밍 및 링크 포맷 수정
• 따뜻한 콜 전환(Warm Transfer) 후 에이전트 2와 사용자 간 음성 미전달 → 음성 스트림 재라우팅 로직 추가
• 에이전트 우선순위 선택(Deltacast) 오류 → 선택 알고리즘의 가중치 계산 수정

Impact

아티클에 정량적 성능 수치가 명시되지 않음.

Key Takeaway

멀티채널 통합 플랫폼에서는 각 외부 시스템(CRM, 저장소, 통신 프로토콜)의 데이터 형식과 상태 동기화 시점을 명확히 정의해야 한다. 특히 메타데이터 정렬, 비동기 작업 타이밍(녹음 저장소, 링크 푸시), 에이전트 상태 라이프사이클 관리를 엄격하게 테스트하지 않으면 분산된 시스템 간 데이터 불일치 버그가 누적된다.