Skip to main content

μ›Ήν›… μ„€μ •

웹훅을 μ‚¬μš©ν•˜λ €λ©΄ λ‹€μŒ 단계λ₯Ό λ”°λ₯΄μ„Έμš”
  1. μ›Ήν›… URL을 ν”ŒλŸ¬κ·Έ λŒ€μ‹œλ³΄λ“œ(λΉ„μ¦ˆλ‹ˆμŠ€ μ„€μ • -> μ›Ήν›… & API)μ—μ„œ μ„€μ •ν•©λ‹ˆλ‹€
  2. μˆ˜μ‹ ν•  이벀트 μœ ν˜•μ„ μ„ νƒν•©λ‹ˆλ‹€

지원 이벀트

ν”ŒλŸ¬κ·Έ APIμ—μ„œ μ§€μ›ν•˜λŠ” μ›Ήν›… 이벀트

의뒰 이벀트

  • 제λͺ© λ³€κ²½
  • 단계 λ³€κ²½
  • μ˜ˆμƒ 견적 λ³€κ²½
  • 문의 μΌμ‹œ λ³€κ²½
  • μ—°κ²° 고객 λ³€κ²½

κ²¬μ μ„œ 이벀트

  • 제λͺ© λ³€κ²½
  • 견적일자 λ³€κ²½
  • 견적번호 λ³€κ²½
  • λ‹΄λ‹Ήμž 정보 λ³€κ²½
  • μˆ˜μ‹ μž 정보 λ³€κ²½
  • κ²¬μ μ„œ μƒνƒœ λ³€κ²½
  • 톡화 λ³€κ²½
  • VAT μ˜΅μ…˜ λ³€κ²½
각 μ΄λ²€νŠΈλŠ” μ‚¬μš©μžκ°€ μ›Ήν›… μ„€μ •μ—μ„œ κ°œλ³„μ μœΌλ‘œ 선택할 수 μžˆμŠ΅λ‹ˆλ‹€. ν•„μš”ν•œ 이벀트만 μ„ νƒν•˜μ—¬ λΆˆν•„μš”ν•œ μ•Œλ¦Όμ„ 쀄일 수 μžˆμŠ΅λ‹ˆλ‹€.

μ›Ήν›… νŽ˜μ΄λ‘œλ“œ ꡬ쑰

λͺ¨λ“  웹훅은 λ‹€μŒκ³Ό 같은 κΈ°λ³Έ ꡬ쑰λ₯Ό κ°€μ§‘λ‹ˆλ‹€:
{
  "event_type": "inquiry",
  "timestamp": "2024-01-15T10:30:45.123456",
  "changed_fields": ["name", "status"],
  "data": {
     // 이벀트 κ΄€λ ¨ 데이터
  }
}

ν•„λ“œ μ„€λͺ…

ν•„λ“œνƒ€μž…μ„€λͺ…
event_typestringλ°œμƒν•œ 이벀트 μœ ν˜• (β€œinquiry” λ˜λŠ” β€œestimate”)
timestampstring이벀트 λ°œμƒ μ‹œκ°„ (ISO 8601 ν˜•μ‹)
changed_fieldsarrayλ³€κ²½λœ ν•„λ“œ λͺ©λ‘
dataobjectμ΄λ²€νŠΈμ™€ κ΄€λ ¨λœ μ‹€μ œ 데이터

μ΄λ²€νŠΈλ³„ νŽ˜μ΄λ‘œλ“œ μ˜ˆμ‹œ

의뒰 λ³€κ²½ 이벀트

  {
    "event_type": "inquiry",
    "timestamp": "2024-01-15T10:30:45.123456",
    "changed_fields": ["name", "status", "inquiry_date", "estimate", "client"],
    "data": {
      "id": 1234,
      "name": "λͺ¨λ°”일 μ•± 개발 ν”„λ‘œμ νŠΈ 의뒰",
      "status": {
        "id": 2,
        "title": "κ²€ν†  쀑"
      },
      "estimate": "15000000",
      "inquiry_date": "2024-01-15T09:00:00",
      "client": {
        "id": 567,
        "company_name": "(μ£Ό)ν…Œν¬μŠ€νƒ€νŠΈμ—…",
        "ceo_name": "κΉ€λŒ€ν‘œ",
        "email": "ceo@techstartup.co.kr",
        "contact": "010-1234-5678",
        "in_charge": "λ°•λ§€λ‹ˆμ €"
      }
    }
  }

κ²¬μ μ„œ λ³€κ²½ 이벀트

  {
    "data": {
      "id": 886,
      "note": "ν”„λ‘œμ νŠΈ κ΄€λ ¨ λ©”λͺ¨",
      "title": "λͺ¨λ°”일 μ•± 개발 κ²¬μ μ„œ",
      "status": "ν™•μ •",
      "has_vat": true,
      "vat_type": "λΆ€κ°€μ„Έ 별도",
      "total_vat": 0.0,
      "currency_code": "KRW",
      "discount_rate": 0,
      "estimate_date": "2024-01-16",
      "unique_number": "202401-001",
      "discount_amount": 0.0,
      "final_total_amount": 0.0,
      "total_supply_amount": 0.0,
      "total_category_amount": 0.0,
      "total_discount_amount": 0.0,
      "inquiry": {
        "id": 32030,
        "name": "λͺ¨λ°”일 μ•± 개발 ν”„λ‘œμ νŠΈ 의뒰"
      },
      "language": "KOR",
      "receiver": {
        "id": 853,
        "email": "customer@company.com",
        "contact": "010-1234-5678",
        "ceo_name": "κΉ€λŒ€ν‘œ",
        "company_name": "(μ£Ό)ν…Œν¬μŠ€νƒ€νŠΈμ—…",
        "company_address": "μ„œμšΈνŠΉλ³„μ‹œ 강남ꡬ ν…Œν—€λž€λ‘œ 123",
        "business_registration_number": "123-45-67890"
      },
      "supplier": {
        "id": 853,
        "email": "supplier@pluuug.com",
        "ceo_name": "λ°•ν”ŒλŸ¬κ·Έ",
        "company_name": "ν”ŒλŸ¬κ·Έκ°œλ°œ",
        "company_address": "μ„œμšΈνŠΉλ³„μ‹œ μ„œμ΄ˆκ΅¬ ν”ŒλŸ¬κ·Έλ‘œ 456",
        "business_registration_number": "987-65-43210"
      },
      "in_charge": {
        "id": 164,
        "name": "이담당",
        "email": "manager@pluuug.com",
        "phone": "0507-1234-5678"
      },
      "category_set": [
        {
          "id": 2546,
          "type": "ν’ˆλͺ©",
          "title": "κ°œλ°œλΉ„",
          "item_set": [
            {
              "id": 3706,
              "unit": "일",
              "title": "UI/UX λ””μžμΈ",
              "quantity": 0.0,
              "unit_cost": 0.0,
              "total_cost": 0.0,
              "description": "λͺ¨λ°”일 μ•± UI/UX λ””μžμΈ",
              "number_of_people": 1
            }
          ],
          "information_type": null,
          "item_display_name": "ν•­λͺ©",
          "total_item_amount": 0.0,
          "unit_display_name": "λ‹¨μœ„",
          "display_item_image": false,
          "information_content": null,
          "quantity_display_name": "μˆ˜λŸ‰",
          "unit_cost_display_name": "단가",
          "total_cost_display_name": "κΈˆμ•‘",
          "description_display_name": "μ„€λͺ…",
          "number_of_people_display_name": "인원"
        }
      ]
    },
    "timestamp": "2024-01-15T14:22:15.789012",
    "event_type": "estimate",
    "changed_fields": ["title", "status", "unique_number", "estimate_date", "currency_code", "vat_type", "in_charge", "receiver"]
  }

인증

μ›Ήν›… μš”μ²­μ˜ λ³΄μ•ˆμ„ μœ„ν•΄ Authorization 헀더에 토큰을 ν¬ν•¨ν•˜μ—¬ μ „μ†‘ν•©λ‹ˆλ‹€.

인증 방법

μ›Ήν›… μš”μ²­μ€ λ‹€μŒκ³Ό 같은 Authorization 헀더λ₯Ό ν¬ν•¨ν•©λ‹ˆλ‹€:
Authorization: Bearer your-webhook-token
μ›Ήν›… μ—”λ“œν¬μΈνŠΈμ—μ„œλŠ” 이 토큰을 κ²€μ¦ν•˜μ—¬ μš”μ²­μ˜ μœ νš¨μ„±μ„ 확인해야 ν•©λ‹ˆλ‹€.
⌘I