AI 음성 에이전트와 CRM 연동: HubSpot, Salesforce 및 Pipedrive (웹훅 코드 포함)

AI 음성 에이전트와 CRM 연동: HubSpot, Salesforce 및 Pipedrive (웹훅 코드 포함)

올해 초 출시한 Vapi 기반 프로젝트에서 음성 에이전트 → 내부 조회 API → HubSpot 연락처 읽기 과정의 응답 시간은 p50 기준 410ms, p95 기준 1,240ms로 측정되었습니다. 이 수치가 바로 이 글을 작성하게 된 결정적인 이유입니다. 음성 에이전트와 CRM의 통합 성패는 호출자가 통제하는 '시간'에 달려 있습니다. Zapier 동기화 방식처럼 단순히 웹훅만 연결하면, 웹훅 처리가 느리게 진행되는 동안 에이전트가 문장 중간에서 갑자기 침묵하게 됩니다. 해결책은 더 많은 API 호출이 아닙니다. 두 가지 패턴, 하나의 타임아웃 설정, 그리고 대체 응답 문구(fallback line)가 필요합니다. 배포 가능한 코드와 함께 이 세 가지 요소를 모두 소개합니다.

이 주제에 대한 대부분의 가이드는 개념만 설명하고 자사 제품을 판매하려 합니다. 하지만 실제 실행 가능한 핸들러 코드를 제공하는 곳은 드뭅니다. 우리는 그 반대 방향으로 가겠습니다.

핵심 요약

• 음성 에이전트는 CRM과 두 가지 방식으로 연결됩니다: 통화 중 실시간 데이터 읽기를 위한 **함수 호출(function calling)**과 통화 후 데이터 기록을 위한 웹훅(webhooks).
• 통화 중 읽기 작업은 호출자가 침묵을 듣지 않도록 5초의 시간 예산과 음성 대체 응답 문구가 필요합니다.
• 재시도된 웹훅으로 인해 중복 레코드가 생성되지 않도록 **멱등성 키(idempotency key)**를 사용하여 통화 데이터를 CRM 필드에 매핑하세요.
• Pipedrive는 사용자 정의 필드 변경에 대한 웹훅을 제공하지 않으므로, 대신 정기적으로 dealFields를 폴링(polling)해야 합니다.

"음성 에이전트 CRM 통합"의 실제 의미 (하나가 아닌 두 가지 방법)

음성 에이전트 CRM 통합은 음성 에이전트를 CRM과 두 가지 distinct한 방식으로 연결합니다: 호출자가 통화 중인 동안 실시간으로 데이터를 읽기 위한 **함수 호출(function calling)**과 통화가 종료된 후 결과를 다시 기록하기 위한 웹훅(webhooks). 실시간 읽기는 대화를 개인화하며, 통화 후 기록은 발생한 일을 로그로 남깁니다. 이들은 서로 다른 시간 제약 하에서 작동하며 각기 다른 방식으로 실패할 수 있습니다.

한 문장으로 정리한 mental model은 다음과 같습니다: 함수 호출은 음성 에이전트가 문장 중간에 CRM에게 질문을 던지는 것이고, 웹훅은 에이전트가 전화를 끊은 후 보고서를 제출하는 것입니다.

함수 호출: 실시간 데이터 읽기

**함수 호출(function calling)**은 LLM이 텍스트 생성을 일시 중단하고 사용자가 정의한 외부 도구를 호출한 후, 그 결과를 다음 발화에 반영하는 방식입니다. 음성 에이전트의 경우, 이 도구는 "CRM에서 이 호출자를 조회하라"는 명령입니다. 모델이 데이터가 필요하다고 판단하면 서버가 데이터를 가져오고, 에이전트는 계획 등급(plan tier)과 함께 이름으로 호출자에게 인사합니다. 깊은 메커니즘을 알고 싶다면 함수 호출 가이드에서 도구 정의 스키마를 확인하세요. 주의할 점은 이 과정이 실시간으로 발생하므로 호출자의 인내심과 경쟁한다는 것입니다.

웹훅: 통화 후 데이터 기록

**웹훅(webhook)**은 어떤 작업이 완료되었을 때 서버가 받는 POST 요청입니다. 음성 에이전트의 경우 가장 중요한 것은 통화 종료 이벤트입니다. 플랫폼은 통화가 끝나는 순간 대화록(transcript), 요약(summary), 처리 결과(disposition), 녹음 URL을 전송합니다. 이 페이로드를 받아 CRM에 활동(Activity)으로 기록하고 거래 단계(deal stage)를 이동시키면 됩니다. 여기에는 시간 압박이 없습니다. 호출자는 이미 떠났기 때문입니다. 재시도, 큐잉, 조정 작업을 안전하게 수행할 수 있습니다.

대부분의 프로덕션 수준 통합은 두 가지 방식을 모두 사용합니다. 실시간으로 읽고, 통화 후에 기록합니다.

아키텍처: 인바운드 통화의 시작부터 끝까지

음성 에이전트 CRM 통합은 모든 인바운드 통화에서 고정된 5단계 라이프사이클을 따릅니다. 통화가 도착하면, 에이전트는 함수 호출을 통해 호출자의 레코드를 실시간으로 읽고, 대화가 진행된 후, 통화 종료 웹훅이 발생하며, 핸들러가 결과를 CRM에 기록하고 필요 시 인간 상담원에게 알림을 보냅니다. 이 글의 모든 코드 예제는 이 다섯 단계 중 하나에 기반합니다.

단계별 흐름은 다음과 같습니다:

1. 인바운드 통화 도착. 플랫폼(Vapi, Retell 또는 자체 음성 에이전트 스택)이 응답하고 전화번호로 호출자를 식별합니다.
2. 실시간 조회(함수 호출). 에이전트가 조회 도구를 호출하면, 이는 CRM을 쿼리하여 연락처, 거래 단계 및 최근 컨텍스트를 반환합니다.
3. 대화. 에이전트가 대화하며 필요시 추가 도구를 호출합니다(예약 슬롯 확인, 주문 조회 등).
4. 통화 종료 웹훅. 통화가 종료되면 플랫폼이 서버로 통화 종료 보고서를 POST합니다.
5. CRM 기록 + 인수인계. 핸들러가 활동을 로그로 남기고, 처리 결과를 설정하며, 거래를 이동시키고, 전체 컨텍스트와 함께 인간 상담원을 위한 태스크를 생성합니다.

위의 히어로 다이어그램은 이를 정확히 매핑합니다: 하나의 인바운드 화살표가 "실시간 읽기"와 "통화 후 기록"으로 분기되고, 세 개의 CRM 대상 카드와 인수인계 노드로 이어집니다. 이 그림을 머릿속에 그려두세요. 아래 내용은 단순히 이 박스들을 채우는 작업일 뿐입니다.

통화 중 CRM 데이터 읽기 (그리고 5초 시간 예산의 중요성)

네, 음성 에이전트는 통화 중에 CRM 데이터를 가져올 수 있습니다. 이는 에이전트의 다음 문장 전에 결과를 반환하는 조회 엔드포인트를_hit_하는 함수 호출을 사용합니다. 제약 조건은 시간입니다. Vapi의 서버 이벤트 문서에 따르면 함수 도구 호출은 타임아웃에 의해 제한되며, 실시간 통화에서 실제 상한선은 API의 제한이 아니라 호출자의 인내심입니다. 5초의 예산을 설정하고 대체 응답(fallback)을 준비하세요.

SERP(검색 엔진 결과 페이지)의 어느 곳에서도 측정하지 않는 부분이 바로 이것입니다. Vapi → 내부 조회 API → HubSpot 연락처 읽기 경로에서 수천 건의 통화에 대해 왕복 시간을 측정한 결과, p50은 410ms, p95는 1,240ms였습니다. 대부분의 읽기는 빠릅니다. 그러나 p95 테일(HubSpot 속도 제한 백오프, 콜드 람다, 느린 연관성 fetch 등)에서 통화가 침묵에 빠집니다. 이러한 테일 현상 때문에 우리는 함수 호출 도구 타임아웃을 5초로 설정했습니다. 이는 p95보다 충분히 높으면서도, 인간이 "여보세요? 계신가요?"라고 묻기 시작하는 지점보다는 충분히 낮은 수치입니다.

그리고 여기서 중요한 규칙은 다음과 같습니다: CRM 조회 시간이 호출자의 인내심을 초과하면, 에이전트는 반드시 무언가를 말해야 합니다. 절대 침묵하지 마세요. 침묵(Dead air)은 통화를 잃는 가장 빠른 지름길입니다. 우리 프로젝트에서는 도구가 타임아웃되는 즉시 에이전트가 대체 응답 문구를 말합니다: "잠시만요, 정보를 찾아보겠습니다." 호출자는 끊어진 봇이 아닌, 인간다운 잠시 멈춤을 듣게 됩니다.

실시간 CRM 조회를 위해 배포하는 함수 호출 도구 정의는 다음과 같습니다:

{
  "type": "function",
  "function": {
    "name": "lookup_crm_contact",
    "description": "Look up the caller in the CRM by phone number before greeting them. Returns name, plan, and open deal stage.",
    "parameters": {
      "type": "object",
      "properties": {
        "phone": {
          "type": "string",
          "description": "Caller phone number in E.164 format"
        }
      },
      "required": ["phone"]
    }
  },
  "server": {
    "url": "https://api.yourdomain.com/voice/crm-lookup",
    "timeoutSeconds": 5
  }
}

이 구성이 음성에 안전한 이유는 두 가지입니다. timeoutSeconds: 5 상한선은 에이전트가 무한정 기다리는 것을 방지합니다. 또한 server.url은 CRM이 아닌 사용자의 엔드포인트를指向하므로, 캐싱, 재시도 및 반환 데이터의 형태를 제어할 수 있습니다. 경험상, 에이전트와 CRM 사이에 내부 API를 두는 것이 가장 현명한 결정입니다. 여기에 대체 로직과 필드 매핑이 존재하기 때문입니다.

통화 후 기록 백업: 활동, 요약 및 처리 결과 로깅

AI 음성 에이전트 통화를 CRM에 기록하려면, 플랫폼의 통화 종료 웹훅을 수신하여 대화록, 요약 및 처리 결과를 추출한 후, CRM에 통화 활동(Call Activity)을 POST하고 리드 상태를 설정합니다. 여기에는 지연 시간 예산이 없습니다(호출자가 이미 떠났으므로). 따라서 통화 중에는 위험했던 무거운 쓰기 작업, 재시도 및 거래 단계 이동을 여기서 수행합니다.

통화 종료 페이로드(Vapi에서는 서버 이벤트 문서에 따라 end-of-call-report 이벤트라고 부름)에는 대화록, 생성된 요약, 통화 결과, 녹음 URL 및 통화 지속 시간이 포함됩니다. 여러분의 역할은 이를 CRM 활동으로 매핑하고 레코드를 다음 단계로 진행시키는 것입니다.

다음은 보고서를 수신하고 HubSpot 통화 참여(call engagement)를 기록한 후 거래 단계를 진행하는 실행 가능한 Node/TypeScript 핸들러입니다. POST /crm/v3/objects/calls 엔드포인트와 연락처 연관 패턴은 HubSpot의 통화 API 가이드에서 직접 가져왔습니다:

import express from "express";

const app = express();
app.use(express.json());

const HUBSPOT_TOKEN = process.env.HUBSPOT_TOKEN!;
const seen = new Set<string>(); // swap for Redis/DB in production

app.post("/voice/end-of-call", async (req, res) => {
  const report = req.body.message; // Vapi end-of-call-report
  if (report?.type !== "end-of-call-report") return res.sendStatus(200);

  const key = report.call.id; // idempotency key (see field-mapping section)
  if (seen.has(key)) return res.sendStatus(200);
  seen.add(key);

  const { contactId, dealId } = report.call.metadata; // set when call started

  // 1. Write the call Activity (engagement)
  await fetch("https://api.hubapi.com/crm/v3/objects/calls", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${HUBSPOT_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      properties: {
        hs_call_title: "AI Voice Agent Call",
        hs_call_body: report.summary,
        hs_call_duration: String(report.durationMs ?? 0),
        hs_call_recording_url: report.recordingUrl ?? "",
        hs_call_status: "COMPLETED",
        hs_timestamp: Date.now(),
      },
      associations: [
        {
          to: { id: contactId },
          types: [{ associationCategory: "HUBSPOT_DEFINED", associationTypeId: 194 }],
        },
      ],
    }),
  });

  // 2. Move the deal stage based on disposition
  if (dealId && report.analysis?.disposition === "qualified") {
    await fetch(`https://api.hubapi.com/crm/v3/objects/deals/${dealId}`, {
      method: "PATCH",
      headers: {
        Authorization: `Bearer ${HUBSPOT_TOKEN}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ properties: { dealstage: "qualifiedtobuy" } }),
    });
  }

  res.sendStatus(200);
});

app.listen(3000);

이것이 H1에서 약속한 보상입니다: 설명이 아닌 배포 가능한 핸들러 코드입니다. 직접 코딩하고 호스팅하기 싫으신가요? n8n과 같은 노코드 워크플로우 대안을 사용하면 동일한 웹훅을 수신하여 시각적 노드로 CRM에 기록할 수 있지만, 재시도 및 오류 처리에 대한 제어권이 일부 희생됩니다.

중복 생성 없이 통화 데이터를 CRM 필드에 매핑하기

필드 매핑은 각 통화 데이터 조각을 특정 CRM 객체와 필드에 연결합니다: caller intent를 deal property에, 처리 결과를 lead status에, 요약을 Activity body에 매핑합니다. 여기서 두 가지 프로덕션 함정이 발생합니다: 에이전트가 데이터를 소리 내어 읽기 전에 음성에 맞게 포맷팅하는 것과, 재시도된 웹훅이 동일한 통화 against 두 번째 레코드를 생성하지 않도록 멱등성 키를 사용하는 것입니다.

우리 프로젝트에서는 비엔지니어도 핸들러 코드를 수정하지 않고 편집할 수 있도록 매핑을 하나의 config 객체로 관리합니다. 실제 형태의 예시는 다음과 같습니다:

첫 번째 함정: 음성 최적화 포맷팅. 원시 JSON을 호출자에게 그대로 읽어주는 음성 에이전트는 결함이 있는 것처럼 들립니다. TTS(Text-to-Speech)에 전달되기 전에 CRM 데이터를 문장으로 포맷팅하세요. 모델에 {"plan":"pro","renewed":"2026-03"}을 반환하지 마십시오. 대신 에이전트가 자연스럽게 말할 수 있도록 "그들은 Pro 플랜을 사용 중이며, 지난 3월에 갱신되었습니다"라고 반환하세요.

두 번째 함정: 멱등성(idempotency). 음성 플랫폼은 웹훅을 재시도합니다. 핸들러가 멱등성을 갖지 않으면 동일한 통화가 두 번 기록되어 중복 레코드가 생성됩니다. 호출 ID를 키로 사용하세요:

const key = report.call.id;
if (await store.has(key)) return res.sendStatus(200); // already processed
await store.add(key);
// ...do the CRM write

프로덕션 환경에서 해당 store는 메모리 내 Set이 아니라, 호출 ID에 고유 제약 조건(unique constraint)이 있는 Redis 또는 데이터베이스 행이어야 합니다. 위의 Set은 데모용으로는 작동하지만, 서버가 재시작될 때마다 메모리가 초기화됩니다.

CRM별 섹션에 앞서, 음성 통신에서 실제로 중요한 사항들에 대해 세 플랫폼이 어떻게 다른지 비교합니다:

HubSpot 통합 (Vapi → HubSpot, 단계별 가이드)

Vapi → HubSpot 통합의 경우, 실시간 읽기를 Contact 조회로, 통화 후 기록을 해당 Contact 및 관련 Deal과 연관된 call engagement로 매핑합니다. HubSpot의 객체 모델은 Contact, Deal 및 engagement(Activity)이며, POST /crm/v3/objects/calls 엔드포인트가 기록 대상입니다. 이것이 검색자들이 실제로 원하는 vapi hubspot integration 패턴입니다.

실시간 읽기는 조회 엔드포인트로의 함수 호출이며, 이는 전화번호로 GET /crm/v3/objects/contacts/search를 쿼리하여 Contact와 열린 Deal을 반환합니다. 통화 후 기록은 위 섹션의 핸들러와 동일합니다: call engagement를 생성하고 association type 194를 통해 Contact와 연관시킨 후, Deal의 dealstage를 PATCH합니다.

사람들이 놓치는 세부 사항: HubSpot 연관성은 유형이 지정됩니다. 통화-연락처 연관성은 특정 associationTypeId를 사용하며, 이를 생략하면 연락처 타임라인에 통화가 표시되지 않습니다. HubSpot의 통화 API 가이드에 ID 목록이 있습니다. 인증의 경우, 단일 워크스페이스에서는 private app token이 가장 빠른 경로이며, 여러 HubSpot 계정에 배포하려면 OAuth를 사용하세요.

Salesforce 통합 (객체, 인증, 실시간 읽기/쓰기)

Salesforce 음성 에이전트 통합은 통화 중 Contact 또는 Lead에서 데이터를 읽고, 통화 후 Task(Activity 객체)를 기록합니다. 거래는 Opportunity에 저장됩니다. 패턴은 HubSpot과 동일합니다(실시간 함수 호출 읽기, 통화 후 기록). 하지만 객체 이름과 인증 흐름이 다릅니다. 기록을 위해 REST API 또는 Composite API를 사용하게 됩니다.

실시간 읽기를 위해, 조회 엔드포인트는 SELECT Id, Name, Account.Name FROM Contact WHERE Phone = '...'와 같은 SOQL 요청으로 Salesforce를 쿼리하고 결과를 에이전트에 반환합니다. 통화 후 기록을 위해, Salesforce REST API 가이드에 따라 WhoId를 Contact/Lead로, WhatId를 Opportunity로 설정하여 Task를 생성합니다:

await fetch(
  `${INSTANCE_URL}/services/data/v60.0/sobjects/Task`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${sfToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      Subject: "AI Voice Agent Call",
      Description: report.summary,
      Status: "Completed",
      WhoId: contactId,      // Contact or Lead
      WhatId: opportunityId, // Opportunity
      CallDurationInSeconds: Math.round((report.durationMs ?? 0) / 1000),
    }),
  }
);

음성 특유의 주의 사항: Salesforce OAuth 토큰은 만료됩니다. 5초라는 실시간 읽기 예산 동안 토큰 갱신이 경쟁하지 않도록 해야 합니다. 배경에서 정기적으로 토큰을 갱신하고, 액세스 토큰을 캐싱하여 항상 준비된 상태(warm)로 유지함으로써, 실시간 조회가 통화 중에 갱신 비용을 치르지 않도록 하세요.

Pipedrive 통합 (모두가 건너뛰는 부분)

Pipedrive 통합은 Persons, Deals 및 Activities를 통해 이루어지며, 한 가지 큰 함정이 있습니다: 사용자 정의 필드 변경에 대한 웹훅이 없다는 점입니다. 음성 에이전트가 사용자 정의 필드를 기록하고 다른 곳에서 해당 변경 사항에 반응해야 한다면, 이를 구독할 수 없습니다. Pipedrive는 사용자 정의 필드가 변경될 때 웹훅을 보내지 않으며, 대신 정기적으로 dealFields를 폴링해야 합니다. 거의 아무도 이 부분을 다루지 않기 때문에, 음성 에이전트 Pipedrive 통합이 미묘한 방식으로 실패하는 경우가 많습니다.

음성 라이프사이클은 깔끔하게 매핑됩니다: 실시간 읽기는 전화번호로 GET /persons/search를 쿼리하고, 통화 후 기록은 Person과 Deal에 링크된 Activity(POST /activities)를 생성하며, 자격 조건(qualification) 충족 시 Deal을 다음 단계로 이동시킵니다. 표준적인 절차입니다.

함정은 사용자 정의 필드입니다. Pipedrive에서 사용자 정의 필드는 사람이 읽을 수 있는 이름이 아닌 40자리 해시 키로 참조되므로, 매핑 구성은 plan_tier 대신 dcf558aba6...와 같은 값을 저장해야 합니다. 또한 Pipedrive의 DealFields 문서에 따르면 이에 대한 변경 이벤트가 없습니다. 하위 시스템이 에이전트가 사용자 정의 필드를 업데이트한 시점을 알아야 한다면, GET /dealFields를 폴링하고 cron 작업으로 마지막 스냅샷과 비교(diff)해야 합니다. 우아하지는 않지만, Pipedrive의 작동 방식이며, 프로덕션 환경에서 새벽 2시에 이를 발견하는 것보다 여기서 미리 아는 것이 낫습니다.

리드 자격 심사 인수인계: 거래 이동 및 인간 상담원 브리핑

인수인계 단계에서 음성 에이전트는 자격 심사 완료 시 거래 단계를 이동하고, 인간 상담원을 위한 태스크를 생성하며, 대화록과 요약을 전달하여 상담원이 컨텍스트를 이미 인지한 상태에서 업무를 시작할 수 있게 합니다. 올바르게 수행되면, 인간 상담원은 차가운 이름과 전화번호가 아닌, 노트가 첨부된 따뜻하고 자격이 확인된 리드를接手하게 됩니다.

기계적으로는 통화 후 핸들러 내에서 세 가지 기록 작업이 모두 수행됩니다: 거래를 자격 완료 단계로 PATCH하고, 마감일이 지정된 상담원에게 할당된 Activity/Task를 POST하며, 통화 요약을 태스크 본문에 넣습니다. 상담원이 CRM을 열면 "AI 자격 완료: Pro 데모 희망, 예산 확인됨, 목요일 선호"라는 내용을 보고 준비된 상태로 전화를 겁니다.

이 부분에서 플랫폼 선택의 차이가 드러납니다. 어떤 엔진을 사용할지 아직 결정하지 않았다면, 어떤 플랫폼이 CRM 통합을 가장 잘 처리하는지에 대한 분석에서 Vapi, Retell 및 Bland가 통화 메타데이터와 웹훅 이벤트를 어떻게 노출하는지 비교해보세요. 이 차이가 인수인계의 깔끔함을 직접적으로 결정합니다.

직접 구축 vs 외주 의뢰 (솔직한 소요 시간)

프로덕션 수준의 음성 에이전트 CRM 통합을 구축하는 데는 CRM당 약 20~40시간이 소요되며, 예상과 달리 시간이 많이 들어가지 않습니다. 해피 패스(정상 경로)의 읽기 및 기록은 아마 하루 정도면 충분합니다. 나머지 시간은 인증 토큰 관리, 필드 매핑, 대체 응답 처리, 멱등성 구현, 그리고 CRM의 속도 제한 및 특이사항에 대한 테스트에 사용됩니다. 그렇다면 실제로 구축하는 데 얼마나 걸릴까요? 솔직한 내역은 다음과 같습니다.

우리 프로젝트에서의 시간 배분은 대략 다음과 같습니다: 인증 및 토큰 갱신에 3–5시간, 필드 매핑 및 음성 최적화 포맷팅 레이어에 4–6시간, 대체 응답 및 타임아웃 처리에 4–8시간, 멱등성 및 중복 제거에 3–5시간, 나머지는 실제 통화 트래픽에 대한 테스트에 사용됩니다. 첫 번째 CRM은 패턴을 익히는 과정이므로 가장 느립니다. 두 번째와 세 번째는 더 빠르지만, Pipedrive의 누락된 사용자 정의 필드 웹훅처럼 각각 고유한 함정이 있습니다.

직접 구축할까요, 아니면 구매할까요? 웹훅 엔드포인트를 호스팅할 수 있는 개발자가 있고 하나의 CRM만 통합한다면, 직접 구축하세요. 이 글이 청사진입니다. 하지만 세 개의 CRM, 멀티 테넌트 인증, 그리고 오전 9시 HubSpot 속도 제한 발생 시 대응할 인력이 필요하다면 계산이 달라집니다. 이 결정에 대해서는 DIY vs 채용 가이드에서 자세히 다루며, 가격 분석에서는 통합 작업이 구축 비용에 얼마나 추가되는지 보여줍니다.

이 모든 것을 유지보수하기 싫다면, 저희가 고객을 위해 수행합니다. Techsy는 CRM과 연결된 프로덕션 음성 에이전트를 제공합니다: 함수 호출 읽기, 웹훅 기록 백업, 대체 응답 처리 등 모든 것을 포함합니다. 강요하는 것은 아닙니다; 위의 코드는 누구나 자유롭게 실행할 수 있습니다.

저자 소개

Mert Batur Gurbuz는 Techsy.io의 공동 창업자로, 팀은 B2B 고객을 위한 AI 에이전트, 자동화 시스템 및 음성/SDR 파이프라인을 구축합니다. 그는 버밍엄 대학교에서 공부하며, Techsy 팀이 프로덕션에서 실제로 사용하는 LLM 도구 스택에 대해 글을 씁니다. LinkedIn에서 연결하세요.

자주 묻는 질문

AI 음성 에이전트를 CRM과 어떻게 통합하나요?

에이전트를 CRM과 두 가지 방식으로 연결합니다: 통화 중 실시간 읽기를 위한 함수 호출과 통화 후 기록을 위한 웹훅입니다. 에이전트는 엔드포인트를 통해 호출자를 실시간으로 조회한 후, 통화 종료 웹훅이 핸들러를 실행하여 CRM에 활동을 로그로 남기고 거래 단계를 업데이트합니다.

음성 에이전트가 통화 중에 CRM 데이터를 가져올 수 있나요?

예. 에이전트는 함수 호출을 사용하여 조회 엔드포인트를 hit하며, 이는 CRM을 쿼리하여 에이전트의 다음 문장 전에 연락처 및 거래 데이터를 반환합니다. 실시간 통화에서는 API의 제한이 아니라 호출자의 인내심과 경쟁하므로, 5초의 도구 타임아웃과 음성 대체 응답 문구를 설정하세요.

AI 음성 에이전트 통화를 CRM에 어떻게 기록하나요?

플랫폼의 통화 종료 웹훅을 수신합니다. 여기에는 대화록, 요약, 처리 결과 및 녹음 URL이 포함됩니다. 핸들러는 이를 추출하여 연락처와 연관된 통화 활동 또는 참여를 CRM에 POST하고, 리드 상태를 설정합니다. 호출자가 이미 전화를 끊었으므로 여기에는 지연 시간 압박이 없습니다.

음성 에이전트에서 웹훅과 함수 호출의 차이점은 무엇인가요?

함수 호출은 통화 중 실시간 읽기입니다: 에이전트가 대화 중간에 CRM에게 질문을 하고 답변을 즉시 사용합니다. 웹훅은 통화 후 기록입니다: 플랫폼은 통화가 종료된 후 호출 결과를 서버에 POST합니다. 함수 호출은 시간과의 경쟁이지만, 웹훅은 그렇지 않습니다.

Vapi는 HubSpot, Salesforce 및 Pipedrive와 통합되나요?

Vapi는 세 플랫폼 모두에 대한 네이티브 커넥터를 기본적으로 제공하지는 않지만, 함수 호출 도구(실시간 읽기)와 서버 URL 웹훅(통화 후 기록)을 통해 어느 플랫폼과도 통합됩니다. 이러한 도구를 자체 엔드포인트로 지정하면, 해당 엔드포인트가 REST API를 통해 HubSpot, Salesforce 또는 Pipedrive와 통신합니다. 패턴은 세 CRM 모두에서 동일합니다.

통화 데이터를 CRM 사용자 정의 필드에 어떻게 매핑하나요?

각 통화 데이터 필드를 CRM 객체 및 필드에 매핑하는 config 객체를 유지하세요. HubSpot과 Salesforce의 경우, 사용자 정의 필드는 읽기 쉬운 내부 이름을 사용합니다. Pipedrive는 사용자 정의 필드를 40자리 해시 키로 참조하므로, config에는 친숙한 이름 대신 해시를 저장해야 합니다. 에이전트가 소리 내어 읽기 전에 값을 음성에 맞게 포맷팅하세요.

음성 에이전트가 통화 중에 실시간으로 CRM을 업데이트할 수 있나요?

실시간으로 읽을 수는 있지만, 대부분의 프로덕션 구축은 기록을 통화 후로 연기합니다. 실시간 읽기는 빠르고 안전해야 합니다. 실시간 기록은 통화가 기록 중간에 끊길 경우 지연 시간과 부분적 업데이트의 위험을 감수해야 합니다. 표준 패턴은 실시간으로 읽고, 통화 종료 웹훅에서 기록하여 호출자의 경험을 보호하는 것입니다.

음성 에이전트가 중복 CRM 레코드를 생성하지 않도록 하려면 어떻게 해야 하나요?

멱등성 키를 사용하세요. 호출 ID가 완벽합니다. 핸들러가 anything을 기록하기 전에, 해당 호출 ID를 이미 처리했는지 확인하세요. 만약 그렇다면 200을 반환하고 건너뜁니다. 키는 메모리가 아닌, 재시작 후에도 생존할 수 있도록 고유 제약 조건이 있는 Redis 또는 데이터베이스에 저장하세요. 웹훅은 재시도되므로 이는 선택 사항이 아닙니다.

Retell은 Pipedrive와 통합되나요?

Retell은 네이티브 커넥터가 나열되지 않은 경우에도 다른 CRM과 동일한 함수 호출 및 웹훅 패턴을 통해 Pipedrive와 통합됩니다. Retell의 통화 이벤트를 엔드포인트에 연결하면, 이는 Pipedrive의 Activities 및 Deals API를 사용합니다. 사용자 정의 필드 제한에 주의하세요: Pipedrive는 사용자 정의 필드 변경에 대한 웹훅이 없으므로, 대신 dealFields를 폴링해야 합니다.

음성 에이전트 CRM 통합을 구축하는 데 얼마나 걸리나요?

프로덕션 수준의 구축에는 CRM당 약 20~40시간이 소요됩니다. 해피 패스는 빠르지만, 실제 시간은 인증 및 토큰 갱신, 필드 매핑, 대체 응답 및 타임아웃 처리, 멱등성, 그리고 실제 통화 트래픽에 대한 테스트에 사용됩니다. 첫 번째 CRM은 패턴을 익혀야 하므로 가장 느립니다. 추가적인 CRM마다 고유한 특이사항이 있습니다.