탐색으로 건너뛰기
통합설정 가이드CRM

ERPNext

발신자를 인식하고 새 발신자를 영업팀을 위한 ERPNext 리드로 등록하세요.

아래 웹훅 도구를 사용하면 리셉셔니스트가 이미 ERPNext 리드인 발신자를 인식하고, 이름, 전화번호, 필요한 사항에 대한 메모와 함께 새 발신자를 리드로 등록하며, 기존 리드에 댓글을 남겨 영업팀이 다시 연락할 수 있습니다. ERPNext와 Frappe 프레임워크는 고정 API 키와 시크릿, JSON 요청 본문을 지원하므로 Frappe Cloud와 자체 호스팅 사이트에서 모두 사용할 수 있습니다.

시작하기 전에

1

API 사용자 만들기

ERPNext에서 Reception.ai용 사용자를 만드세요. 예: reception@yourcompany.com. 그리고 Sales User 역할만 부여하세요. API 요청은 이 사용자의 권한으로 실행되므로 관리자를 사용하지 마세요.

2

키 생성하기

사용자를 열고 Settings 탭을 선택한 다음 API Access를 펼치고 Generate Keys를 선택하세요. 팝업에서 API Secret을 즉시 복사하세요. ERPNext는 이를 한 번만 표시합니다. API Key는 같은 섹션에 계속 표시됩니다.

아래의 모든 도구는 Authorization이라는 요청 헤더를 전송하며, 값은 키와 시크릿을 콜론으로 연결한 token API_KEY:API_SECRET입니다. 해당 헤더의 Type을 Secret으로 설정하세요.

키와 시크릿으로는 Sales User 역할이 허용하는 모든 항목을 읽고 변경할 수 있습니다. 공유 문서에 넣지 말고, 유출된 경우 Generate Keys를 다시 선택해 교체하세요.

3

사이트 주소 찾기

도구의 URL은 브라우저에서 ERPNext를 사용할 때 여는 주소로 시작합니다. 아래 표에서는 https://YOUR-SITE.example.com을 사용합니다. 자신의 주소로 바꾸세요.

도구 만들기

각 도구에서 Integrations로 이동해 Add integration을 선택하고 Webhook Tool을 선택한 다음 Assign to agents를 Receptionist로 설정하세요. 아래에서 “Always”로 표시된 모든 매개변수는 Value를 Fixed value로 설정하세요.

리드 찾기

필드값
이름find_erpnext_lead
설명”전화번호로 리드 중에서 발신자를 찾습니다. 통화 시작 시 이전에 문의한 적이 있는지 확인하는 데 사용하세요.”
메서드GET
URLhttps://YOUR-SITE.example.com/api/resource/Lead
요청 헤더Authorization: token API_KEY:API_SECRET
쿼리 매개변수or_filters (문자열, 필수): “발신자 번호의 마지막 7자리를 기준으로 하는 필터입니다. 정확히 [["mobile_no","like","%5550123%"],["phone","like","%5550123%"]]처럼 사용하세요.”
fields (문자열): 항상 ["name","lead_name","status"].
limit_page_length (정수): 항상 5.

새 리드 등록하기

필드값
이름create_erpnext_lead
설명”find_erpnext_lead에서 발신자를 찾지 못한 경우, 발신자를 새 리드로 등록합니다.”
메서드POST
URLhttps://YOUR-SITE.example.com/api/resource/Lead
요청 헤더Authorization: token API_KEY:API_SECRET
본문 매개변수first_name (문자열, 필수): “발신자의 이름입니다.”
last_name (문자열): “발신자의 성입니다.”
mobile_no (문자열, 필수): “발신자의 국제 형식 전화번호입니다. 예: +14155550123.”
email_id (문자열): “발신자가 제공한 경우 이메일 주소입니다.”
lead_owner (문자열): 항상 새 리드에 다시 연락할 영업 담당자의 이메일 주소입니다.
notes (배열): 아래를 참조하세요.

리드 유입 경로를 설정하려면 Lead Source 레코드 중 하나와 정확히 일치하는 고정 값으로 source (문자열)를 추가하세요. ERPNext 16 이상에서는 필드가 utm_source이며, UTM Source 레코드와 일치해야 합니다.

notes는 리드의 Notes 탭을 채웁니다. 설명에 “발신자에게 필요한 사항을 포함해 정확히 하나의 항목을 전송합니다.”라고 입력하세요. Each item에서 object를 선택한 후, 다음 각각에 대해 Add field를 선택하세요.

  • note (문자열, 필수): “발신자에게 필요한 사항과 다시 연락받고 싶은 시점입니다.”
  • added_by (문자열): 항상 API 사용자의 이메일 주소입니다.

통화 세부 정보 기록하기

필드값
이름add_erpnext_lead_comment
설명”발신자에게 필요한 사항을 해당 발신자의 리드에 댓글로 남깁니다. find_erpnext_lead가 발신자를 찾았을 때 CRM-LEAD-2026-00012와 같은 리드 이름과 함께 사용하세요.”
메서드POST
URLhttps://YOUR-SITE.example.com/api/method/frappe.desk.form.utils.add_comment
요청 헤더Authorization: token API_KEY:API_SECRET
본문 매개변수reference_doctype (문자열): 항상 Lead.
reference_name (문자열, 필수): “find_erpnext_lead 또는 create_erpnext_lead에서 가져온 리드 이름입니다.”
content (문자열, 필수): “발신자에게 필요한 사항과 다시 연락받고 싶은 시점입니다.”
comment_email (문자열): 항상 API 사용자의 이메일 주소입니다.
comment_by (문자열): 항상 Reception.ai.

각 도구에서 Enable을 선택한 다음, 다시 연락해 달라고 요청하는 새 발신자로서 리셉셔니스트를 테스트하세요. 리드는 영업 담당자가 소유한 상태로 Lead 목록에 표시되며, 리셉셔니스트의 댓글도 함께 표시됩니다.

발신자를 위한 절차를 추가하세요. 먼저 리드를 찾고, 찾지 못했다면 메모와 함께 등록하고, 찾았다면 해당 리드에 통화 세부 정보를 기록하세요. 리셉셔니스트가 발신자에게 리드 레코드를 절대 읽어 주지 않도록 규칙을 추가하세요.

리셉셔니스트는 대화 내용을 바탕으로 검색 필터를 작성하므로, 발신자가 다른 사람의 리드를 검색하도록 유도할 수 있습니다. 도구는 이름과 상태를 최대 5개까지만 반환하지만, 위 규칙은 계속 유지하세요. Sales User에 고객 및 견적 등 원치 않는 추가 액세스 권한이 있다면, 리드를 읽고 생성하고 댓글을 남기는 것만 가능한 사용자 지정 역할을 만드세요.

제한 사항

  • 검색은 번호의 마지막 7자리를 기준으로 합니다. 해당 숫자 사이에 공백이나 대시가 포함된 번호는 찾을 수 없으며, 두 발신자가 같은 마지막 7자리를 공유할 수 있습니다.
  • 이 설정은 리드만 처리합니다. 리셉셔니스트는 연락처나 고객을 검색하거나 영업 기회를 생성하지 않습니다.

문제 해결

문제확인할 사항
ERPNext에서 401 또는 403 발생헤더 값은 token, 공백, 콜론으로 연결한 키와 시크릿 순서여야 합니다. 사용자가 활성화되어 있고 Sales User 역할이 있는지 확인하세요.
기존 발신자를 찾을 수 없음번호를 공백이나 대시 없이 저장하고, 번호가 리드의 Mobile No 또는 Phone 필드에 있는지 확인하세요.
리드 소유자 또는 소스 관련 오류lead_owner는 활성화된 사용자의 이메일 주소여야 하며, source는 Lead Source와 정확히 일치해야 합니다(ERPNext 16 이상에서는 utm_source 및 UTM Source).
전화번호 관련 오류ERPNext는 전화번호를 확인합니다. 리셉셔니스트가 선택적 선행 +와 숫자만 전송하도록 하세요.
added_by 관련 오류notes의 added_by는 API 사용자와 같이 활성화된 사용자의 이메일 주소여야 합니다.
댓글이 추가되지 않음reference_name은 CRM-LEAD-2026-00012와 같이 기존 리드의 이름이어야 합니다. 먼저 찾기 또는 생성 도구가 실행되었는지 확인하세요.