다음을 통해 공유

Elead Sales Customers(미리 보기)

이 API를 사용하면 Elead CRM 내에서 잠재 고객/고객 정보를 관리할 수 있습니다. 이 API에는 잠재 고객/고객 정보를 관리하기 위한 다음과 같은 기능과 기능이 포함되며, 이름, 전화 번호, 이메일 주소 및 실제 주소와 같은 잠재 고객/고객 정보를 추가하고, 기존 Elead ID에 연결된 게시, 업데이트, 검색 및 검색에 고유하게 할당된 Elead ID를 반환합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 CDK Global
URL https://serviceconnect.support.cdk.com
전자 메일 mbd_support@cdk.com
커넥터 메타데이터
게시자 CDK Global
웹 사이트 https://fortellis.io
개인 정보 보호 정책 https://fortellis.io/privacy
카테고리 데이터

이 API는 무엇을 합니까?

이 API를 사용하면 Elead CRM 내에서 잠재 고객/고객 정보를 관리할 수 있습니다.

대상

이 API는 Elead CRM 내에서 잠재 고객/고객 데이터를 관리해야 하는 딜러 및 공급업체 파트너를 위한 것입니다.

기능 및 기능

이 API에는 잠재 고객/고객 정보를 관리하기 위한 다음과 같은 기능과 기능이 포함되어 있습니다.

  • 이름, 전화 번호, 전자 메일 주소 및 실제 주소와 같은 잠재 고객/고객 정보 추가
  • 기존 Elead ID에 연결된 잠재 고객/고객 연락처 정보 업데이트
  • Elead ID로 잠재 고객/고객 검색
  • 이름, 전자 메일 주소 또는 전화 번호로 잠재 고객/고객 검색
  • Elead ID로 잠재 고객/고객 소유 차량 검색

Pre-requisites

계속하려면 다음이 필요합니다.

  • 커넥터를 사용하려면 Fortellis 사용자여야 합니다.
  • API를 호출하는 동안 사용할 클라이언트 ID 및 비밀을 생성하기 위해 Fortellis에서 솔루션을 만들어야 합니다.

자세한 설명서는 다음에서 찾을 수 있습니다.

https://apidocs.fortellis.io/specs/ba092364-accc-4ad9-865f-fac51c34cdb1

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

ID로 고객 가져오기

Elead 고객 ID로 잠재 고객/고객 레코드를 검색합니다. Elead 고객 ID는 현재 다음과 같이 제공됩니다.

  • POST /sales/v1/elead/customers를 통해 고객 만들기

  • GET /sales/v1/elead/opportunities/search를 통해 기회 검색
ID로 차량 가져오기

Elead 고객 ID로 잠재 고객/고객 차량 레코드를 검색합니다. Elead 고객 ID는 현재 다음과 같이 제공됩니다.

  • POST /sales/v1/elead/customers를 통해 고객 만들기

  • GET /sales/v1/elead/opportunities/search를 통해 기회 검색
고객 검색

고객 검색
고객 만들기

잠재 고객/고객 만들기
고객 업데이트

잠재 고객/고객 정보 업데이트

ID로 고객 가져오기

작업 ID:
Customers_GetCustomer

Elead 고객 ID로 잠재 고객/고객 레코드를 검색합니다. Elead 고객 ID는 현재 다음과 같이 제공됩니다.

  • POST /sales/v1/elead/customers를 통해 고객 만들기

  • GET /sales/v1/elead/opportunities/search를 통해 기회 검색

매개 변수

Name 키 필수 형식 Description
고객 ID
 customerId True string

형식 - uuid.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
Accept
 Accept string

Accept Header
Accept-Charset
 Accept-Charset string

Accept-Charset 헤더
Accept-Encoding (인코딩 허용)
 Accept-Encoding string

Accept-Encoding 헤더
여러 언어 수용 (Accept-Language)
 Accept-Language string

Accept-Language 헤더
If-Match
 If-Match string

If-Match 헤더
If-None-Match
 If-None-Match string

If-None-Match 헤더
선호하다
 Prefer string

고객의 기본 설정
요청 ID
 Request-Id True string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.

반환

몸
Customer

ID로 차량 가져오기

작업 ID:
Customers_GetCustomerOwnedVehicles

Elead 고객 ID로 잠재 고객/고객 차량 레코드를 검색합니다. Elead 고객 ID는 현재 다음과 같이 제공됩니다.

  • POST /sales/v1/elead/customers를 통해 고객 만들기

  • GET /sales/v1/elead/opportunities/search를 통해 기회 검색

매개 변수

Name 키 필수 형식 Description
고객 ID
 customerId True string

형식 - uuid.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
Accept
 Accept string

Accept Header
Accept-Charset
 Accept-Charset string

Accept-Charset 헤더
Accept-Encoding (인코딩 허용)
 Accept-Encoding string

Accept-Encoding 헤더
여러 언어 수용 (Accept-Language)
 Accept-Language string

Accept-Language 헤더
If-Match
 If-Match string

If-Match 헤더
If-None-Match
 If-None-Match string

If-None-Match 헤더
선호하다
 Prefer string

고객의 기본 설정
요청 ID
 Request-Id True string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.

반환

몸
CustomerVehicleCollection

고객 검색

작업 ID:
Customers_SearchCustomers

고객 검색

매개 변수

Name 키 필수 형식 Description
페이지
 page integer

형식 - int32.
페이지 크기
 pageSize integer

형식 - int32.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
Accept
 Accept string

Accept Header
Accept-Charset
 Accept-Charset string

Accept-Charset 헤더
Accept-Encoding (인코딩 허용)
 Accept-Encoding string

Accept-Encoding 헤더
여러 언어 수용 (Accept-Language)
 Accept-Language string

Accept-Language 헤더
If-Match
 If-Match string

If-Match 헤더
If-None-Match
 If-None-Match string

If-None-Match 헤더
선호하다
 Prefer string

고객의 기본 설정
요청 ID
 Request-Id True string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
이름 (첫 번째 이름)
 firstName string

고객의 이름에 대한 검색 문자열
lastName
 lastName string

고객의 성을 검색하는 문자열
전화번호
 phoneNumber string

고객의 전화 번호에 대한 검색 문자열
이메일 주소
 emailAddress string

고객의 전자 메일 주소에 대한 검색 문자열

반환

몸
SearchCustomersResponse

고객 만들기

작업 ID:
Customers_CreateCustomer

잠재 고객/고객 만들기

매개 변수

Name 키 필수 형식 Description
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
Accept
 Accept string

Accept Header
Accept-Charset
 Accept-Charset string

Accept-Charset 헤더
Accept-Encoding (인코딩 허용)
 Accept-Encoding string

Accept-Encoding 헤더
여러 언어 수용 (Accept-Language)
 Accept-Language string

Accept-Language 헤더
If-Match
 If-Match string

If-Match 헤더
If-None-Match
 If-None-Match string

If-None-Match 헤더
선호하다
 Prefer string

고객의 기본 설정
요청 ID
 Request-Id True string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
isBusiness
 isBusiness boolean

이 고객이 비즈니스인지 여부에 관계없이 true/false
businessName
 businessName string

비즈니스 이름, isBusiness가 true인 경우 설정
businessContact
 businessContact string

isBusiness가 true일 때 설정된 고객사 연락처의 이름
title
 title string

고객의 제목
이름 (첫 번째 이름)
 firstName string

고객 이름
중간 이름
 middleName string

고객 중간 이름
lastName
 lastName string

고객 성
별명
 nickname string

고객 애칭
생일
 birthday date-time

고객 생일
address
 address True string

고객 전자 메일 주소
emailType
 emailType True string
doNotEmail
 doNotEmail boolean

true/false를 사용하여 전자 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 전자 메일 주소인지 여부를 true/false로 지정합니다.
숫자
 number True string

전화번호
phoneType
 phoneType True string
preferredTimeToContact
 preferredTimeToContact True string
doNotCall
 doNotCall boolean

호출 안 함으로 플래그를 지정하는 true/false
doNotText
 doNotText boolean

true/false를 사용하여 텍스트 안 함 플래그 지정
preferCall
 preferCall boolean

고객이 전화로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.
preferText
 preferText boolean

고객이 텍스트로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.
주소줄1
 addressLine1 string

고객 주소 줄 1
주소줄2
 addressLine2 string

고객 주소 줄 2
city
 city string

고객 도시
주
 state string

고객 상태
지퍼
 zip True string

고객 우편 번호
country
 country string

고객 국가
군
 county string

고객 군
doNotMail
 doNotMail boolean

true/false를 사용하여 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 주소인지 여부를 true/false로 지정합니다.

반환

몸
Customer

고객 업데이트

작업 ID:
Customers_UpdateCustomer

잠재 고객/고객 정보 업데이트

매개 변수

Name 키 필수 형식 Description
고객 ID
 customerId True string

형식 - uuid.
클라이언트 ID
 client_id True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 ID입니다.
클라이언트 암호
 client_secret True string

솔루션을 빌드하는 개발자/솔루션 공급자에게 고유해야 하는 클라이언트 암호입니다.
구독 ID
 subscription_id True string

지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
Accept
 Accept string

Accept Header
Accept-Charset
 Accept-Charset string

Accept-Charset 헤더
Accept-Encoding (인코딩 허용)
 Accept-Encoding string

Accept-Encoding 헤더
여러 언어 수용 (Accept-Language)
 Accept-Language string

Accept-Language 헤더
If-Match
 If-Match string

If-Match 헤더
If-None-Match
 If-None-Match string

If-None-Match 헤더
선호하다
 Prefer string

고객의 기본 설정
요청 ID
 Request-Id True string

형식 - guid입니다. 지정된 요청의 반환을 나타내기 위해 호출자에게 다시 반환되어야 하는 상관 관계 ID입니다.
isBusiness
 isBusiness boolean

이 고객이 비즈니스인지 여부에 관계없이 true/false
businessName
 businessName string

비즈니스 이름, isBusiness가 true인 경우 설정
businessContact
 businessContact string

isBusiness가 true일 때 설정된 고객사 연락처의 이름
title
 title string

고객의 제목
이름 (첫 번째 이름)
 firstName string

고객 이름
중간 이름
 middleName string

고객 중간 이름
lastName
 lastName string

고객 성
별명
 nickname string

고객 애칭
생일
 birthday date-time

고객 생일
address
 address True string

고객 전자 메일 주소
emailType
 emailType True string
doNotEmail
 doNotEmail boolean

true/false를 사용하여 전자 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 전자 메일 주소인지 여부를 true/false로 지정합니다.
숫자
 number True string

전화번호
phoneType
 phoneType True string
preferredTimeToContact
 preferredTimeToContact True string
doNotCall
 doNotCall boolean

호출 안 함으로 플래그를 지정하는 true/false
doNotText
 doNotText boolean

true/false를 사용하여 텍스트 안 함 플래그 지정
preferCall
 preferCall boolean

고객이 전화로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.
preferText
 preferText boolean

고객이 텍스트로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.
주소줄1
 addressLine1 string

고객 주소 줄 1
주소줄2
 addressLine2 string

고객 주소 줄 2
city
 city string

고객 도시
주
 state string

고객 상태
지퍼
 zip True string

고객 우편 번호
country
 country string

고객 국가
군
 county string

고객 군
doNotMail
 doNotMail boolean

true/false를 사용하여 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 주소인지 여부를 true/false로 지정합니다.

반환

몸
Customer

정의

고객

Name 경로 형식 Description
아이디
 id uuid

고유한 고객 식별자
isBusiness
 isBusiness boolean

이 고객이 비즈니스인지 여부에 관계없이 true/false
businessName
 businessName string

비즈니스 이름, isBusiness가 true인 경우 설정
businessContact
 businessContact string

isBusiness가 true일 때 설정된 고객사 연락처의 이름
title
 title string

고객의 제목
이름 (첫 번째 이름)
 firstName string

고객 이름
중간 이름
 middleName string

고객 중간 이름
lastName
 lastName string

고객 성
별명
 nickname string

고객 애칭
생일
 birthday date-time

고객 생일
전자 메일
 emails array of CustomerEmail

고객 전자 메일 주소
전화
 phones array of CustomerPhone

고객 전화 번호
address
 address CustomerAddress
links
 links array of LinkDescriptionObject

HATEOAS 링크의 컬렉션

고객 이메일

Name 경로 형식 Description
address
 address string

고객 전자 메일 주소
emailType
 emailType string
doNotEmail
 doNotEmail boolean

true/false를 사용하여 전자 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 전자 메일 주소인지 여부를 true/false로 지정합니다.

CustomerPhone

Name 경로 형식 Description
숫자
 number string

전화번호
phoneType
 phoneType string
preferredTimeToContact
 preferredTimeToContact string
doNotCall
 doNotCall boolean

호출 안 함으로 플래그를 지정하는 true/false
doNotText
 doNotText boolean

true/false를 사용하여 텍스트 안 함 플래그 지정
preferCall
 preferCall boolean

고객이 전화로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.
preferText
 preferText boolean

고객이 텍스트로 연락하는 것을 선호하는지 여부를 true/false로 설정합니다.

CustomerAddress

Name 경로 형식 Description
주소줄1
 addressLine1 string

고객 주소 줄 1
주소줄2
 addressLine2 string

고객 주소 줄 2
city
 city string

고객 도시
주
 state string

고객 상태
지퍼
 zip string

고객 우편 번호
country
 country string

고객 국가
군
 county string

고객 군
doNotMail
 doNotMail boolean

true/false를 사용하여 메일 아님으로 플래그 지정
isP 참조
 isPreferred boolean

고객이 선호하는 주소인지 여부를 true/false로 지정합니다.

SearchCustomersResponse

Name 경로 형식 Description
items
 items array of SearchCustomer

고객 검색 결과 컬렉션
총 항목
 totalItems integer

지정된 검색에 대한 총 고객 수
totalPages
 totalPages integer

지정된 검색에 대한 총 고객 페이지 수
pageNumber
 pageNumber integer

이 페이징된 결과 집합의 현재 페이지 번호
pageSize
 pageSize integer

이 페이징된 결과 집합의 페이지 크기
links
 links array of LinkDescriptionObject

HATEOAS 링크의 컬렉션

SearchCustomer

Name 경로 형식 Description
아이디
 id uuid

이 고객의 고유 식별자
이름 (첫 번째 이름)
 firstName string

고객 이름
lastName
 lastName string

고객 성
전자 메일
 emails array of CustomerEmail

고객 전자 메일 주소
전화
 phones array of CustomerPhone

고객 전화 번호
address
 address CustomerAddress
순위
 rank float

이 고객 검색 결과의 관련성 순위

CustomerVehicleCollection

Name 경로 형식 Description
아이디
 id uuid

이 차량의 고유 식별자
exteriorColor
 exteriorColor string

차량의 외부 색
interiorColor
 interiorColor string

차량의 내부 색
마일리지
 mileage integer

차량의 마일리지
milesPerWeek
 milesPerWeek integer

주당 평균 주행 마일 수
년
 year integer

제조 연도
만들다
 make string

차량 브랜드
model
 model string

차량의 이름
다듬다
 trim integer

트리밍에 대한 설명
빈 (vin)
 vin string

차량 식별 번호
options
 options CustomerVehicleOptions

차량 옵션
vehicleOwner
 vehicleOwner CustomerVehicleOwner

차량 소유자

CustomerVehicleOptions

차량 옵션

Name 경로 형식 Description
fuelType
 fuelType string

연료 종류
interiorType
 interiorType string

내부 유형
vehicleCondition
 vehicleCondition string

차량 상태
bodyStyle
 bodyStyle string

차량 본문 스타일
engineDescription
 engineDescription string

엔진 유형
modelCode
 modelCode string

모델 코드
numberOfCylinders
 numberOfCylinders integer

실린더 수
numberOfDoors
 numberOfDoors byte

문 수
전파
 transmission string

전송 유형
isAutomaticTransmission
 isAutomaticTransmission boolean

차량에 자동 변속기가 있는지 여부 true/false
hasAirBags
 hasAirBags boolean

차량에 에어백이 있는지 여부 true/false
hasCruiseControl
 hasCruiseControl boolean

차량에 크루즈 컨트롤이 있는지 여부 true/false
hasAirConditioning
 hasAirConditioning boolean

차량에 에어컨이 있는지 여부 true/false

CustomerVehicleOwner

차량 소유자

Name 경로 형식 Description
isActive
 isActive boolean

소유자가 활성 상태인지 여부 true/false
customerId
 customerId uuid

차량 소유자의 고유 식별자
vehicleId
 vehicleId uuid

차량의 고유 식별자

LinkDescriptionObject

Name 경로 형식 Description
href
 href string

대상 URI
rel (rel)
 rel string

링크 관계 유형
method
 method string

링크 대상에 대한 요청을 만드는 데 사용해야 하는 HTTP 동사입니다.
title
 title string

개체를 설명하는 제목입니다.