본문으로 건너뛰기

수신 전화용 Phone AI 설정

빠른 설정

Twilio 번호 하나를 연결하고 웹훅을 테스트한 다음 Phone AI를 활성화하세요. 보통 약 10분이 걸립니다.

이 가이드는 AVA로 호텔 수신 전화를 받고 각 통화 기록을 검토하는 방법을 설명합니다.

이동 경로: Settings → Communications → Phone AI

빠른 참조​

설정기능표시 내용
Twilio Account SIDTwilio 계정 선택AC로 시작하는 식별자
Twilio phone number고객 전화 수신+와 국가 코드가 포함된 번호
Twilio Auth TokenAVA의 통화 확인 및 처리 승인다시 표시되지 않는 보호된 비밀 값
Purpose번호에 선택적 메모 추가설정 페이지의 설명
Incoming-call webhookTwilio 통화를 AVA로 전송복사 가능한 URL과 Test webhook 작업
Phone AI 스위치AI 통화 처리 시작 또는 일시 중지Active 또는 Not active
Call Activity통화와 상태 목록 표시발신 번호, 시작 시간, 상태, 통화 기록

시작하기 전에​

  • Settings write 권한이 있음
  • Phone AI 전용 Twilio 전화번호가 있음
  • Twilio Account SID와 Auth Token이 있음
  • 전화번호가 국제 형식으로 작성됨
Auth Token 보호

Twilio Auth Token은 비밀번호처럼 취급하세요. AVA는 저장 후 이를 보호하며 다시 표시하지 않습니다.

Twilio 연결 저장​

  1. Settings → Communications → Phone AI로 이동합니다.

  2. Setup 탭을 유지합니다.

  3. Twilio Account SID를 입력합니다.

  4. +와 국가 코드가 포함된 Twilio phone number를 입력합니다.

  5. Twilio Auth Token을 입력합니다.

  6. 선택 사항인 Purpose를 추가합니다.

  7. Save settings를 선택합니다.

    ✓ "Phone AI settings saved."가 표시됩니다. ✓ Auth Token 필드가 보호된 자리표시자로 바뀝니다.

토큰 교체

저장된 토큰을 유지하려면 Auth Token을 비워 두세요. 교체할 때만 새 토큰을 입력하세요.

Twilio 수신 전화 연결​

  1. Setup에서 Incoming-call webhook을 찾습니다.

  2. Copy를 선택합니다.

  3. Twilio Console을 엽니다.

  4. Phone Numbers에서 호텔 번호를 선택합니다.

  5. Voice configuration의 A call comes in을 Webhook으로 설정합니다.

  6. 복사한 URL을 붙여넣습니다.

  7. POST를 선택하고 Twilio 설정을 저장합니다.

    ✓ Twilio가 수신 전화를 AVA 웹훅으로 전송합니다.

Phone AI 테스트 및 활성화​

  1. Settings → Communications → Phone AI로 돌아갑니다.

  2. 저장되지 않은 변경 사항을 저장합니다.

  3. Test webhook을 선택합니다.

  4. 성공 메시지를 확인합니다.

  5. Enable Phone AI를 켭니다.

  6. Save settings를 선택합니다.

  7. 다른 전화기로 Twilio 번호에 전화합니다.

    ✓ Phone AI가 수신 전화를 받습니다. ✓ 통화가 Call Activity에 표시됩니다.

활성화 조건

활성화 전에 Account SID, 전화번호, Auth Token을 저장해야 합니다. 저장되지 않은 변경 사항이 있으면 웹훅 테스트도 비활성화됩니다.

통화 활동 검토​

  1. Call Activity를 엽니다.

  2. 발신 번호와 시작 시간으로 통화를 찾습니다.

  3. 통화 상태를 확인합니다.

  4. View transcript를 선택합니다.

  5. 검토가 끝나면 기록을 닫습니다.

    ✓ 해당 통화의 고객 및 어시스턴트 메시지를 확인할 수 있습니다.

문제 해결​

전화번호가 거부됨​

표시 내용: "Enter the Twilio phone number in E.164 format, including + and country code."

해결 방법:

  1. 번호를 +로 시작합니다.
  2. 국가 코드를 추가합니다.
  3. 공백, 괄호, 하이픈을 제거합니다.
  4. Save settings를 다시 선택합니다.

웹훅 테스트가 비활성화됨​

표시 내용: Test webhook을 선택할 수 없습니다.

해결 방법:

  1. Account SID, 전화번호, Auth Token을 모두 입력합니다.
  2. Save settings를 선택합니다.
  3. 저장 확인 메시지를 기다립니다.
  4. Test webhook을 다시 선택합니다.

웹훅 테스트 실패​

표시 내용: "Unable to verify the Twilio webhook configuration."

해결 방법:

  1. 현재 Incoming-call webhook을 다시 복사합니다.
  2. Twilio의 A call comes in에 해당 URL이 사용되는지 확인합니다.
  3. 메서드가 POST인지 확인합니다.
  4. Twilio에서 저장한 후 AVA에서 다시 테스트합니다.

Phone AI를 활성화할 수 없음​

표시 내용: Enable Phone AI 스위치가 비활성화되어 있습니다.

해결 방법:

  1. Settings write 권한을 확인합니다.
  2. 필수 Twilio 설정을 모두 저장합니다.
  3. 전화번호에 +와 국가 코드가 있는지 확인합니다.
  4. 페이지를 새로고침하고 다시 시도합니다.

통화 기록이 열리지 않음​

표시 내용: "Unable to load this transcript."

해결 방법:

  1. 통화 기록 패널을 닫습니다.
  2. Call Activity를 새로고침합니다.
  3. 통화를 다시 엽니다.
  4. 다른 기록도 실패하면 지원팀에 문의합니다.

문제가 계속되나요?​

다음 상황에서는 success@vouch-technologies.com으로 문의하세요.

  • ❌ 저장된 웹훅 테스트가 계속 실패함
  • ❌ 통화가 Call Activity에 나타나지 않음
  • ❌ 활성화 후 Phone AI가 전화를 받지 않음

함께 보내면 유용한 정보:

  • 비밀 값이 보이지 않는 설정 상태 스크린샷
  • Twilio 전화번호
  • 테스트 통화 시간
  • 정확한 오류 메시지