딜 수정

특정 id를 갖는 딜의 정보를 수정합니다.

POST

• Example Request

curl --location 'https://salesmap.kr/api/v1/deal/<dealId>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data '{
  "name":"Example_Deal",
  "pipelineName":"영업a파이프라인",
  "fieldList": [
    {"name":"수주 예정일", "dateValue":"2024-01-01"}
  ],
  "peopleName":"Exmaple_People",
  "peopleEmail":"[e-mail]",
  "peopleFieldList": [
    {"name":"포지션", "stringValue":"CEO"}
  ],
  "organizationName":"Example_Organization",
  "organizationFieldList": [
    {"name":"주소", "stringValue":"서울시 강남구"},
    {"name":"직원수", "numberValue":"15"},
  ]
}'
'

• Example Response

{
  "success": true,
  "data": {
    "id": "644218b950e381db28bc486f",
    "name": "Example_Lead",
    "price": 50000,
    "people": {
      "id": "644215c250e381db28bc4704",
      "name": "Exmaple_People",
      "email": "[e-mail]",
      "phoneNumber": "01011112222"
    },
    "organization": {
      "id": "644215a350e381db28bc467f",
      "name": "Example_Organization"
    },
    "createdAt": "2023-04-21T05:01:45.939Z"
  }
}

Header

• Authorization

  • required string

Bearer 토큰을 포함한 인증 헤더입니다.

Path Parameter

• dealId

  • required string

수정할 대상이 되는 딜의 id값 입니다.

​Body

• name

  • string

  • 딜의 이름을 설정합니다.

• price

  • string

  • 딜의 금액을 설정합니다.

• source

  • string

  • 딜의 소스를 설정합니다.

  • 딜/리드 데이터필드에서 소스의 선택리스트를 확인해주세요.

  • 소스는 선택리스트 중 하나의 값으로만 설정 가능합니다. source 값을 전달하지 않는 경우 “직접 생성”으로 설정됩니다.

• ownerName

  • string

  • 딜의 담당자를 지정합니다.

  • 같은 워크스페이스에 등록된 담당자의 이름을 지정해주세요.

  • 해당필드 없이 post 요청을 하면, 해당 요청의 토큰에 해당하는 user가 담당자로 지정됩니다.

• fieldList

  • json

  • 딜의 이름, 금액, 소스, 담당자를 제외한 필드값을 설정합니다.

  • 세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 리드의 데이터 필드를 확인할 수 있습니다.

  • name 에는 field 의 이름을 입력합니다.

  • field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.

• peopleName

  • string

  • 딜와 연결된 고객의 이름을 설정합니다. peopleName과 peopleEmail을 입력하는 경우 두 값이 모두 필요합니다.

• peopleEmail

  • string

  • 딜와 연결된 고객의 이메일을 설정합니다.

  • 같은 이메일의 고객이 존재하는 경우 기존의 고객과 연결하고, 같은 이메일의 고객이 존재하지 않는 경우 새로운 고객을 생성하고 리드와 연결합니다.

• peopleFieldList

  • json

  • 딜와 연결된 고객의 이름과 이메일을 제외한 필드값을 설정합니다.

  • 세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 고객의 데이터 필드를 확인할 수 있습니다.

  • name 에는 field 의 이름을 입력합니다.

  • field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.

• organizationName

  • string

  • 딜와 연결된 회사의 이름을 설정합니다.

  • 같은 이름의 회사가 존재하는 경우 기존의 회사와 연결하고, 같은 이름의 회사가 존재하지 않는 경우 새로운 회사를 생성하고 리드와 연결합니다.

• organizationFieldList

  • json

  • 딜와 연결된 회사의 이름을 제외한 필드값을 설정합니다.

  • 세일즈맵 탭에서 [회사 설정] - [데이터 필드 관리]을 클릭하면 회사의 데이터 필드를 확인할 수 있습니다.

  • name 에는 field 의 이름을 입력합니다.

  • field 의 유형이 텍스트나 단일 선택인 경우에는 stringValue 에 값을 설정하고, field 의 유형이 숫자인 경우에는 numberValue 에 값을 설정하고, field 의 유형이 날짜인 경우에는 dateValue 에 값을 설정합니다. field 의 유형이 복수 선택인 경우에는 stringValueList에 string list 형태로 값을 설정합니다.

​Response

• success

  • boolean

  • 요청을 성공적으로 완료한 경우 true, 실패한 경우 false 입니다.

• data

  • object

  • 수정한 딜 정보입니다.

  • 리드 정보 데이터

    • id

      • string

      • 수정 된 딜의 고유 id 입니다.

    • name

      • string

      • 수정한 딜의 이름입니다.

    • price

      • string

      • 수정한 딜의 금액입니다.

    • source

      • string

      • 수정한 딜의 소스입니다.

    • people

      • string

      • 수정한 딜의 고객 정보입니다.

    • organization

      • string

      • 수정한 딜의 회사 정보입니다.

    • createdAt

      • string

      • 딜이 생성된 날짜입니다.