본문으로 건너뛰기

보이스 옵션

메시지 발송 참고

voiceOptions: {
  voiceType: `'MALE', 'FEMALE' (보이스 타입 '남자', '여자')`,
  headerMessage: `머리말, 통화 시작시 나오는 메시지 (최대 70Byte)`,
  tailMessage: `맺음말, 통화가 끝나고 나오는 메시지, 상담원 연결 시 나오지 않음, 머리말이 있어야 적용됨`,
  replyRange: `통화 내용이 나온 후 1~3번까지의 버튼으로 받는 답변 (수신자에게서 입력받을 숫자, 1~3)
EX) 안녕하십니까. 쇼핑몰 사이트를 이용해주셔서 감사합니다. 제공해드리는 상품에 대한 만족도를 선택해주세요.
1번 만족. 2번 보통. 3번 불만족`,
  counselorNumber: `상담원번호, 번호 입력 시 통화 내용이 나온 후 0번을 누르면 상담원 연결 (replyRange와 병행 가능)`
}

보이스 메시지 시나리오

  • replyRange만 사용

    • 본문 내용 → DTMF 수집 → 종료

  • headerMessage, replyRange 사용

    • 헤더 메시지 → 아무 버튼이나 입력 → 본문 내용 → DTMF 수집 → 종료

  • headerMessage, tailMessage, replyRange 사용

    • 헤더 메시지 → 아무 버튼이나 입력 → 본문 내용 → DTMF 수집 → 테일 메시지 → 종료

  • counselorNumber만 사용

    • 본문 내용 → 0번 누르면 고객센터 연결
      (이외의 버튼 누를 시 ‘잘못 누르셨습니다’ 멘트 나옴)

  • headerMessage, counselorNumber 사용 (tailMessage 같이 사용해도 동일)

    • 헤더 메시지 → 아무 버튼이나 입력 → 본문 내용 → 0번 누르면 고객센터 연결
      (이외의 버튼 누를 시 ‘잘못 누르셨습니다’ 멘트 나옴)

참고: 버튼을 잘못 입력하면 세 번째에 멘트가 나오고 통화 종료됩니다.

보이스 태그 사용 가이드

1. 태그 형식 (Tag Format)​

1.1 값 없이 사용되는 태그​

<tag>text</tag>

예시:

<spell>apple</spell>

1.2 값을 직접 지정하는 태그​

<tag="tag_value"/>
<tag="tag_value">text</tag>

예시:

<speed="150">apple</speed>

1.3 속성을 사용하는 태그​

<tag attribute="tag_value">text</tag>

예시:

<date format="yyyymmdd">20150624</date>

1.4 별도의 속성값을 적용하는 경우​

<tag attribute="tag_value">text</tag>

예시:

<date format="yyyymmdd">20150624</date>

2. 태그 입력 시 주의사항​

  • 대소문자 구분 없음
  • 모든 tag_value는 쌍따옴표(" ")로 감싸야 함
  • </tag>는 범위 지정 시에만 사용
  • 중첩(nested) 구조는 지원하지 않음
  • 태그는 메시지 마지막에 두지 말 것
    예) <emphasis>감사합니다.</emphasis>

비권장 예시:

<speed="150">S1<speed="80">S2</speed>S3</speed>

S3는 기본값으로 합성됨

3. 태그 상세 설명​

태그는 음성 메시지에서 특정 단어나 문장의 읽는 방식(속도, 높낮이, 멈춤 등)을 조절하는 도구입니다.
자연스럽고 듣기 좋은 음성을 만들기 위해 사용됩니다.

사용 예시 코드​

{
  to: '##수신번호##',
  from: '##발신번호##',
  text: `최근 저희 쇼핑몰을 이용하신 경험은 어떠셨나요?<pause="800">
<emphasis level="moderate">1번, 매우 만족</emphasis><pause="800">
<emphasis level="moderate">2번, 보통이에요</emphasis><pause="800">
<emphasis level="moderate">3번, 아쉬웠어요</emphasis><pause="800">
해당하는 번호를 눌러주세요.<pause="800">
고객님의 소중한 의견은 더 나은 서비스를 만드는 데 큰 힘이 됩니다.<pause="800">`,
  type: 'VOICE',
  voiceOptions: {
    voiceType: 'FEMALE',
    replyRange: 3,
    headerMessage: `안녕하세요. <emphasis>ABC 쇼핑몰</emphasis>입니다.<pause="800">
더 나은 서비스 제공을 위해 잠시 설문을 부탁드립니다.<pause="800">
계속하시려면 아무 버튼이나 눌러주세요.`,
    tailMessage: `참여해주셔서 진심으로 감사합니다.<pause="800"> 오늘도 행복한 하루 되세요.`
  }
}

3.1 <speed>​

<speed="150">빠르게</speed>
<speed="-50%">느리게</speed>

3.2 <volume>​

<volume="200">크게</volume>
<volume="-50%">작게</volume>

3.3 <pitch>​

<pitch="120">높게</pitch>
<pitch="-20%">낮게</pitch>

3.4 <emphasis>​

<emphasis level="strong">강조된 단어</emphasis>
<emphasis>기본 강조</emphasis>

3.5 <pause>​

안녕하세요.<pause="1000"> 반갑습니다.

3.6 <break>​

<break="1">약한 멈춤</break>
<break="3">강한 멈춤</break>

3.7 <syll>​

<syll>ABC123</syll>

3.8 <isyll>​

<isyll>ABC123</isyll>

3.9 <spell>​

<spell>DIOTEK</spell>

3.10 <wpron>​

<wpron="dloUtEk">DIOTEK</wpron>
<wpron="zhong1guo2">中國</wpron>

3.11 <phoneme>​

<phoneme ph="d l o U t E k">DIOTEK</phoneme>

3.12 <sub>​

<sub alias="World Wide Web">W3C</sub>

3.13 <date>​

<date>20150624</date>
<date format="yyyymmdd">20150624</date>
<date format="mdy">06-24-15</date>

3.14 <time>​

<time>122530</time>
<time format="hhmmss12">122530</time>
<time format="hms12">12:25:30</time>

3.15 <digit>​

<digit format="64" pause="600">1012061530</digit>

3.16 <money>​

<money type="3" pause="80">12345원</money>

3.17 <effect>​

<effect="effect_1">