Nutshell | ElevenLabs Documentation

리셉셔니스트는 이미 Nutshell에 등록된 발신자를 인식하고, 새 발신자를 팀에서 후속 조치할 수 있도록 리드가 연결된 사람으로 추가할 수 있습니다. 발신자 조회에는 웹훅 도구를 사용합니다. 사람과 리드 추가는 Zapier를 통해 진행합니다. Nutshell API는 레코드를 생성하기 위해 목록과 중첩 값이 필요하지만 웹훅 도구는 이를 전송할 수 없기 때문입니다.

발신자 조회

API 키 만들기

Nutshell에서 왼쪽 하단의 Settings를 선택한 다음 Connections 아래의 API keys를 선택합니다. Add API key를 선택하고 Zapier에도 필요한 API + user impersonation을 선택합니다. 키를 복사합니다.

인증 헤더 만들기

Nutshell API는 Nutshell 이메일 주소를 사용자 이름으로, API 키를 비밀번호로 사용합니다. 터미널에서 두 값을 바꾸고 그 사이의 콜론은 유지한 채 인코딩합니다.

printf 'YOUR_EMAIL:YOUR_API_KEY' | base64

헤더 값은 Basic 뒤에 출력값을 붙인 형식입니다.

API 키를 온라인 인코더에 붙여 넣지 마세요. 키 또는 인코딩된 헤더를 가진 사람은 누구나 Nutshell 데이터를 읽고 변경할 수 있습니다.

웹훅 도구 만들기

Integrations로 이동하여 Add integration을 선택한 다음 Webhook Tool을 선택합니다.

필드	값
이름	`find_nutshell_person`
설명	”전화번호, 이름 또는 이메일로 CRM에서 발신자를 찾습니다. 통화 시작 시 기존 고객인지 확인하는 데 사용합니다.”
메서드	GET
URL	`https://app.nutshell.com/rest/contacts`
요청 헤더	`Authorization`: 인코딩된 값 앞에 `Basic` 붙이기
쿼리 매개변수	`q` (문자열, 필수): “발신자의 전화번호, 전체 이름 또는 이메일 주소.”
에이전트에 할당	Receptionist

Enable을 선택합니다.

사람 및 리드 추가

Zapier 연결

아직 연결하지 않았다면 Reception.ai에서 Zapier를 연결하세요.

Nutshell 작업 추가

mcp.zapier.com의 Zapier MCP 서버에서 API 키로 Nutshell 계정을 연결하고 다음 작업을 추가합니다.

Create Person: AI가 발신자의 이름, 전화번호, 이메일 주소를 입력하도록 설정합니다.
Create Lead: 소스, 파이프라인, 담당자는 고정 값으로 설정하고, AI가 발신자의 요청 내용과 해당 대상자에 대한 설명을 입력하도록 설정합니다.

사람의 타임라인에 통화를 기록하려면 Log Activity도 추가하고 AI가 짧은 요약을 입력하도록 설정하세요.

도구 할당

Reception.ai에서 Zapier 통합의 Tools 탭을 열고 Refresh tools를 선택한 다음 Nutshell 작업을 Client(리셉셔니스트)에 할당합니다.

테스트

Nutshell 사람에 저장된 번호로 전화를 건 경우와 견적을 원하는 새 발신자인 경우로 리셉셔니스트를 테스트하세요. 새 사람과 해당 리드가 Nutshell에 표시됩니다.

제한 사항

Zapier의 Nutshell 앱에는 후속 태스크를 만드는 작업이 없습니다. 대신 리드 담당자가 Nutshell에서 새 리드를 확인할 수 있습니다.
Zapier의 Nutshell 앱은 사용 가능 시간을 확인할 수 없으므로 리셉셔니스트는 Nutshell에서 미팅을 예약할 수 없습니다. Google Calendar를 사용하여 Reception 자체 예약 기능을 이용하세요.
리셉셔니스트가 실행하는 각 Zapier 작업은 Zapier 플랜의 태스크를 사용합니다. 현재 Zapier는 성공한 통화당 태스크 2개를 계산하며, 실패한 통화는 계산하지 않습니다. 플랜이 소진되면 재설정될 때까지 작업이 중지됩니다.

문제 해결

문제	확인 사항
Nutshell에서 401 반환	Nutshell 이메일 주소, 콜론, 키를 인코딩하고 헤더 값은 `Basic` 으로 시작해야 합니다.
알려진 발신자를 찾을 수 없음	Nutshell의 사람에 저장된 번호로 테스트 전화를 걸거나, 발신자에게 이름을 물어보세요.
리셉셔니스트가 중복된 사람을 생성함	조회 도구 설명에 발신자를 찾지 못한 경우에만 사람을 추가하라고 지시하세요.
Nutshell 작업이 Reception.ai에 표시되지 않음	Zapier에서 작업을 추가한 후 Zapier 통합에서 Refresh tools를 선택하세요.
Zapier가 Nutshell에 연결할 수 없음	API + user impersonation이 포함된 API 키를 사용하세요.