통화 기록을 구글 시트에 자동 기록하기: Apps Script 웹훅

// Code.gs — KAT Cloud CALL_COMPLETED → 구글 시트
const SHEET_NAME = '통화기록';
const HEADERS = ['통화 기록 ID', '시작 시각', '방향', '고객 번호', '상태', '태그',
  '통화 시간(초)', '요약', '대화 내역', '녹음 URL', '기록 시각'];
const MAX_CELL = 45000; // 셀 한 칸 한도(50,000자)보다 여유 있게

function doPost(e) {
  // 웹 앱 URL 끝의 ?token= 값 확인 (스크립트 속성 WEBHOOK_TOKEN과 비교)
  const token = PropertiesService.getScriptProperties().getProperty('WEBHOOK_TOKEN');
  if (token && (!e || !e.parameter || e.parameter.token !== token)) {
    return reply_({ ok: false, reason: 'token' });
  }

  let body;
  try {
    body = JSON.parse(e.postData.contents);
  } catch (err) {
    return reply_({ ok: false, reason: 'invalid json' });
  }
  if (body.eventType !== 'CALL_COMPLETED' || !body.data || !body.data.callHistoryId) {
    return reply_({ ok: true, skipped: true }); // 테스트 페이로드 등은 건너뛴다
  }

  const d = body.data;
  const lock = LockService.getScriptLock(); // 동시에 온 요청이 같은 행에 쓰지 않게
  lock.waitLock(5000);
  try {
    const sheet = getSheet_();
    if (alreadyLogged_(sheet, d.callHistoryId)) {
      return reply_({ ok: true, duplicate: true });
    }
    const customer = d.isInbound ? d.fromNumber : d.toNumber;
    sheet.appendRow([
      d.callHistoryId,
      d.startedAt ? new Date(d.startedAt) : '',
      d.isInbound ? '수신' : '발신',
      customer ? "'" + customer : '', // 앞자리 0이 사라지지 않게 텍스트로
      d.status || '',
      d.tag || '',
      d.duration || 0,
      safeText_(d.summary || ''),
      safeText_(transcript_(d)),
      d.recordingUrl || '',
      new Date(),
    ]);
  } finally {
    lock.releaseLock();
  }
  return reply_({ ok: true });
}

function getSheet_() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName(SHEET_NAME);
  if (!sheet) {
    sheet = ss.insertSheet(SHEET_NAME);
    sheet.appendRow(HEADERS);
    sheet.setFrozenRows(1);
  }
  return sheet;
}

function alreadyLogged_(sheet, id) {
  return sheet.getRange('A:A').createTextFinder(id).matchEntireCell(true).findNext() !== null;
}

function transcript_(d) {
  const ai = (d.sttAI || []).map((t) => `[AI 구간] ${t.role === 'agent' ? 'AI' : '고객'}: ${t.text}`);
  const direct = (d.sttDirect || []).map((t) => `[직원 구간] ${t.role === 'agent' ? '직원' : '고객'}: ${t.text}`);
  return ai.concat(direct).join('\n');
}

function safeText_(text) {
  const s = String(text).slice(0, MAX_CELL);
  return /^[=+\-@]/.test(s) ? "'" + s : s; // 수식으로 해석되지 않게
}

function reply_(obj) {
  return ContentService.createTextOutput(JSON.stringify(obj))
    .setMimeType(ContentService.MimeType.JSON);
}

export KAT_API_KEY="콘솔에서 발급받은 키"
BASE="https://studio-gateway.zerocall.kr"
WEBAPP_URL="https://script.google.com/macros/s/배포ID/exec?token=스크립트-속성에-넣은-값"

curl -s -X POST "$BASE/webhook" \
  -H "x-api-key: $KAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"eventType\":\"CALL_COMPLETED\",\"url\":\"$WEBAPP_URL\"}"

curl -s -L -X POST "$WEBAPP_URL" \
  -H "Content-Type: application/json" \
  -d '{"eventType":"CALL_COMPLETED","timestamp":"2026-03-12T02:45:30.000Z","data":{"callHistoryId":"8f3f8fd9-7ab8-4a26-b523-4f8eb7d38b85","groupId":1,"channelId":100,"fromNumber":"01012345678","toNumber":"07012345678","isInbound":true,"status":"ANSWERED","tag":"AI_TO_DIRECT","duration":96,"summary":"예약 변경 요청을 접수하고 변경 가능한 시간대를 안내함","sttAI":[{"role":"agent","text":"안녕하세요. KAT Cloud입니다.","timestamp":1.2}],"sttDirect":[{"role":"customer","text":"직원 연결 부탁드립니다.","timestamp":30.1}],"recordingUrl":"https://storage.example.com/recording.wav","startedAt":"2026-03-12T02:40:00.000Z","completedAt":"2026-03-12T02:41:36.000Z"}}'
# {"ok":true}  같은 요청을 한 번 더 보내면 {"ok":true,"duplicate":true}

# webhookId는 등록 응답 또는 GET /webhook의 id
curl -s -X POST "$BASE/webhook/1/test" -H "x-api-key: $KAT_API_KEY"