웹훅은 정의된 조건이 충족될 때 타사 앱이나 웹사이트에 HTTP 요청을 보내는 이벤트 기반 트리거입니다.
간단히 말해, 웹훅은 조건이 충족될 때 웹페이지나 제품에 변경을 가할 수 있는 자동화입니다.
Freshsales에서는 웹훅을 사용하여 타사 웹사이트로 데이터를 보내거나 트리거 조건에 따라 CRM 내에 새 레코드를 생성할 수 있습니다.
예를 들어, 거래가 체결되면 자동으로 송장을 보내도록 조건에 따라 트리거되는 웹훅을 설정할 수 있습니다.
이 워크플로우는 타사 송장 생성 도구를 사용하여 구현할 수 있습니다.
Invoiced에서 제공하는 무료 송장 생성기 도구를 사용해 보겠습니다. Invoice Generator는 사용자가 전문적인 송장을 생성하고 보낼 수 있는 송장 템플릿을 제공합니다. 또한 API 호출을 지원합니다. 이를 통해 웹훅 사용 사례의 일부로 사용할 수 있습니다.
워크플로우:

- 웹훅 설정은 REST API에 대한 기본적인 이해가 필요합니다. 코딩에 익숙하지 않은 경우, 웹훅 설정을 위해 개발자의 도움을 받는 것이 좋습니다.
- 이 사용 사례에서는 Invoiced의 Invoice Generator가 선택되었습니다. 이는 등록된 사용자가 API를 통해 무료로 인보이스를 생성할 수 있도록 하기 때문입니다. 도구에 대한 더 나은 이해를 위해 Invoiced의 API 문서 를 참조하세요.
이제 예제를 기반으로 웹훅을 구성하는 방법을 이해해 봅시다— 연락처 조건에 따라 새로운 거래를 생성합니다. 웹훅은 워크플로우의 작업의 일환으로 트리거됩니다. 워크플로우 트리거 및 조건을 구성하는 방법을 배우려면, 이 문서를 참조하세요.
웹훅의 구성 요소는 무엇인가?
웹훅 설정은 다음을 구성하는 것을 포함합니다:
요청 유형
콜백 URL
인코딩 유형
내용
요청 유형
요청 유형 | 목적 |
POST | 객체 생성 |
GET | 하나 이상의 객체 가져오기 |
PUT/PATCH | 객체 업데이트 |
DELETE | 객체 제거 |

우리의 예시에서는 거래를 생성하기 위해 Freshsales에 API 요청을 게시하므로 POST를 선택합니다.
콜백 URL: API 요청에 의해 타격을 받는 앱 또는 웹 서비스의 URL을 콜백 URL이라고 합니다. 우리의 예시에서는 거래를 생성하려고 합니다. 따라서 거래 페이지 URL을 사용하여 거래를 생성할 수 있습니다.
인보이스 생성기를 통한 인보이스 생성 콜백 URL:
https://invoice-generator.com
인증 (선택 사항): 콜백 URL이 통과하기 위해 인증이 필요한 경우, 사용자 이름과 비밀번호 또는 API 키를 추가할 수 있습니다.
우리의 예시에서는, Invoiced는 API 또는 사용자 이름-비밀번호를 통한 인증이 필요하지 않습니다.
클릭 사용자 정의 헤더 추가 를 클릭하여 보안 세부 정보, API 버전 정보 등과 같은 내용을 포함시킵니다. 사용자 정의 헤더는 다음 형식으로 헤더-값 쌍으로 입력해야 합니다: X-Sample-CustomHeader1: VALUE.
참고:
1. 헤더에 공백이 있는 경우 트리거가 실행되지 않습니다. 그러나 헤더 끝에 공백이 입력된 경우(X-Sample-CustomHeader1 : VALUE), 이는 무시됩니다.
2. 하나 이상의 값을 가진 헤더는 구분 기호로 구분해야 합니다(쉼표나 콜론 사용 금지).
3. 두 번째 헤더를 추가하려면 다음 줄에 사용자 정의 헤더와 값 쌍을 입력하십시오.인코딩 유형: JSON, XML, 또는 X-FORM-ENCODED 중에서 선택
내용: 웹훅의 일부로 두 가지 유형의 콘텐츠를 보낼 수 있습니다— 필드 또는 엔드포인트. 웹훅 요청의 일부로 보내야 하는 간단하거나 고급 콘텐츠(거래 세부 정보)를 선택하십시오.
간단한: 웹훅의 일부로 보내기 위해 선택한 레코드 유형의 필드를 선택하십시오.

고급: 콜백 URL로 엔드포인트를 보낼 수 있습니다. 엔드포인트는 콜백 URL로 전달되는 코드/정보를 의미합니다. 관련 API를 사용하여 플레이스홀더로 엔드포인트를 생성하십시오. 다양한 작업에 대한 API를 찾으려면 Freshsales 개발자 문서를 참조하십시오.
우리의 예시에서는 거래 가치를 사용하여 거래에 대한 새 인보이스를 생성할 수 있습니다.
요청 유형 | 필드 |
GET 또는 DELETE |
|
POST, PUT 또는 PATCH |
|
웹훅이 트리거되면 Freshsales에서 새 거래가 생성된 영업 계정으로 송장이 전송됩니다.
웹훅 테스트
웹훅을 구성한 후, 웹훅을 테스트하려면 버튼을 클릭하세요. 구성이 올바르면 성공 메시지를 받게 됩니다. 잘못 구성된 경우 오류 코드가 표시될 수 있습니다. 오류 코드를 이해하고 적절히 수정하려면 이 문서를 참조하세요.
이 문서가 도움이 되었나요? 같은 폴더의 문서Freshsales AI 도우미Freshsales에서 웹훅과 함께 워크플로를 사용하는 방법은 무엇인가요? AI 어시스턴트 초기화 중... |