Pipedrive | ElevenLabs Documentation

아래 웹훅 도구를 사용하면 접수 담당자가 Pipedrive에 이미 등록된 발신자를 식별하고, 새로운 영업 기회에 대한 거래를 생성하며, 팀의 후속 통화를 예약할 수 있습니다.

시작하기 전에

Pipedrive에서 Personal preferences → API를 열고 API 토큰을 복사하세요. 아래의 모든 도구는 x-api-token 요청 헤더로 이를 전송합니다. 이 도구는 사용자 권한으로 작동하므로, 올바른 파이프라인을 볼 수 있는 사용자의 토큰을 사용하세요.

도구 만들기

각 도구에서 Integrations로 이동해 Add integration을 선택하고 Webhook Tool을 선택한 다음, Assign to agents를 Receptionist로 설정하세요.

발신자 찾기

필드	값
이름	`find_pipedrive_person`
설명	”전화번호 또는 이름으로 CRM에서 발신자를 찾습니다. 판매, 견적 또는 기존 거래에 관한 통화 시작 시 사용하세요.”
메서드	GET
URL	`https://api.pipedrive.com/api/v2/persons/search`
요청 헤더	`x-api-token`: API 토큰
쿼리 매개변수	`term` (문자열, 필수): “발신자의 전화번호 또는 전체 이름(최소 2자)“

거래 생성

필드	값
이름	`create_pipedrive_deal`
설명	”발신자가 견적을 요청하거나 구매하려 할 때 거래를 생성합니다. 제목에 발신자 이름을 포함하세요.”
메서드	POST
URL	`https://api.pipedrive.com/api/v2/deals`
요청 헤더	`x-api-token`: API 토큰
본문 매개변수	`title` (문자열, 필수): “발신자 이름과 요청 내용을 포함한 짧은 제목.” `person_id` (숫자): “`find_pipedrive_person`의 id입니다. 발신자를 찾지 못한 경우 생략하세요.” `value` (숫자): “발신자가 제시한 경우 거래 금액.”

후속 조치 예약

필드	값
이름	`create_pipedrive_followup`
설명	”발신자에게 후속 조치를 약속할 때마다 팀의 콜백을 예약합니다.”
메서드	POST
URL	`https://api.pipedrive.com/api/v2/activities`
요청 헤더	`x-api-token`: API 토큰
본문 매개변수	`subject` (문자열, 필수): “예: Jane Doe에게 주방 견적 관련 콜백.” `type` (문자열, 필수): “항상 정확히 `call` 값으로 설정하세요.” `due_date` (문자열, 필수): “YYYY-MM-DD 형식의 후속 조치 날짜.” `note` (문자열, 필수): “발신자의 이름, 전화번호 및 요청 사항.” `deal_id` (숫자): “생성한 경우 거래 id.”

각 도구에서 Enable을 선택한 다음, 견적을 요청하는 통화로 접수 담당자를 테스트하세요.

제한 사항

웹훅 도구는 평면 값을 전송하지만 Pipedrive는 개인의 전화번호를 중첩 목록으로 저장합니다. 따라서 이 도구로는 전화번호가 포함된 새 연락처를 만들 수 없습니다. 대신 후속 조치의 메모에 발신자 번호가 저장됩니다. 연락처를 만들려면 Zapier를 통해 Pipedrive의 Create Person 작업을 사용하세요.

문제 해결

문제	확인할 사항
Pipedrive의 401	헤더 이름은 반드시 `x-api-token`이어야 하며 현재 토큰을 포함해야 합니다.
등록된 발신자를 찾을 수 없음	Pipedrive는 저장된 형식 그대로 전화번호를 일치시킵니다. 번호를 하나의 형식으로 저장하거나 이름으로도 검색하세요.
후속 조치에 유형이 없음	`call`은 Pipedrive 계정의 활동 유형이어야 합니다. Company settings → Activities를 확인하세요.