Freshsales에서 웹훅과 함께 워크플로를 사용하는 방법은 무엇인가요?

업무 흐름
적용 가능한 플랜
Sprout Blossom Garden EstateForest


웹훅은 정의된 조건이 충족될 때 타사 앱이나 웹사이트에 HTTP 요청을 보내는 이벤트 기반 트리거입니다. 


간단히 말해, 웹훅은 조건이 충족될 때 웹페이지나 제품에 변경을 가할 수 있는 자동화입니다.


Freshsales에서는 웹훅을 사용하여 타사 웹사이트로 데이터를 보내거나 트리거 조건에 따라 CRM 내에 새 레코드를 생성할 수 있습니다. 


예를 들어, 거래가 체결되면 자동으로 송장을 보내도록 조건에 따라 트리거되는 웹훅을 설정할 수 있습니다. 

  

이 워크플로우는 타사 송장 생성 도구를 사용하여 구현할 수 있습니다.

Invoiced에서 제공하는 무료 송장 생성기 도구를 사용해 보겠습니다. 
Invoice Generator는 사용자가 전문적인 송장을 생성하고 보낼 수 있는 송장 템플릿을 제공합니다. 또한 API 호출을 지원합니다. 이를 통해 웹훅 사용 사례의 일부로 사용할 수 있습니다. 


워크플로우:


참고:
  • 웹훅 설정은 REST API에 대한 기본적인 이해가 필요합니다. 코딩에 익숙하지 않은 경우, 웹훅 설정을 위해 개발자의 도움을 받는 것이 좋습니다.

  • 이 사용 사례에서는 Invoiced의 Invoice Generator가 선택되었습니다. 이는 등록된 사용자가 API를 통해 무료로 인보이스를 생성할 수 있도록 하기 때문입니다. 도구에 대한 더 나은 이해를 위해 Invoiced의 API 문서 를 참조하세요.


이제 예제를 기반으로 웹훅을 구성하는 방법을 이해해 봅시다— 연락처 조건에 따라 새로운 거래를 생성합니다. 웹훅은 워크플로우의 작업의 일환으로 트리거됩니다. 워크플로우 트리거 및 조건을 구성하는 방법을 배우려면, 이 문서를 참조하세요.

웹훅의 구성 요소는 무엇인가?
웹훅 설정은 다음을 구성하는 것을 포함합니다:

  1. 요청 유형

  2. 콜백 URL

  3. 인코딩 유형

  4. 내용


  1. 요청 유형

Freshsales API는 표현 상태 전송(REST)을 지원합니다. 이는 CRM에서 데이터를 읽고, 수정하고, 추가하거나 삭제하는 'RESTful' 작업을 수행하는 API를 설정할 수 있음을 의미합니다. 웹훅을 구성할 때 다음 요청 유형 중 하나를 선택할 수 있습니다:

요청 유형

목적

POST

객체 생성

GET

하나 이상의 객체 가져오기

PUT/PATCH

객체 업데이트

DELETE

객체 제거




 

참고: 각 서드파티 앱은 요청 유형을 다르게 사용하지만, 대부분의 애플리케이션은 표준 방법을 따릅니다.



우리의 예시에서는 거래를 생성하기 위해 Freshsales에 API 요청을 게시하므로 POST를 선택합니다.

  1. 콜백 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. 두 번째 헤더를 추가하려면 다음 줄에 사용자 정의 헤더와 값 쌍을 입력하십시오.

     

  2. 인코딩 유형: JSON, XML, 또는 X-FORM-ENCODED 중에서 선택 

  3. 내용: 웹훅의 일부로 두 가지 유형의 콘텐츠를 보낼 수 있습니다— 필드 또는 엔드포인트. 웹훅 요청의 일부로 보내야 하는 간단하거나 고급 콘텐츠(거래 세부 정보)를 선택하십시오.

    1. 간단한: 웹훅의 일부로 보내기 위해 선택한 레코드 유형의 필드를 선택하십시오.

    2. 고급: 콜백 URL로 엔드포인트를 보낼 수 있습니다. 엔드포인트는 콜백 URL로 전달되는 코드/정보를 의미합니다. 관련 API를 사용하여 플레이스홀더로 엔드포인트를 생성하십시오. 다양한 작업에 대한 API를 찾으려면 Freshsales 개발자 문서를 참조하십시오.

      우리의 예시에서는 거래 가치를 사용하여 거래에 대한 새 인보이스를 생성할 수 있습니다.


요청 유형

필드

GET 또는 DELETE

  • 콜백 URL (필수)

  • 인증 매개변수 (선택)

  • 사용자 정의 헤더 (선택)

POST, PUT 또는 PATCH

  • 콜백 URL (필수)

  • 인증 매개변수 (선택)

  • 사용자 정의 헤더 (선택)

  • 인코딩 (필수)

  • 콘텐츠 유형 (필수)

  • 콘텐츠 (필수)


웹훅이 트리거되면 Freshsales에서 새 거래가 생성된 영업 계정으로 송장이 전송됩니다.

웹훅 테스트
웹훅을 구성한 후, 웹훅을 테스트하려면  버튼을 클릭하세요. 구성이 올바르면 성공 메시지를 받게 됩니다. 잘못 구성된 경우 오류 코드가 표시될 수 있습니다. 오류 코드를 이해하고 적절히 수정하려면 이 문서를 참조하세요.


오류 코드오류 코드 유형의미

301

영구 이동

요청한 리소스가 다른 URL로 영구적으로 이동되었습니다.

302

임시 이동

요청한 리소스가 다른 URL로 임시로 이동되었습니다.

400

잘못된 요청

보낸 요청이 잘못되었습니다 (구문에 잘못된 매개변수가 있거나 크기가 너무 클 수 있음).

401

권한 없음

리소스에 접근할 권한이 없습니다. 인증이 실패했거나 제공되지 않았습니다.

403

금지됨

요청이 올바르지만 요청된 작업을 수행할 권한이 없습니다.

404

찾을 수 없음

요청한 리소스를 현재 사용할 수 없습니다.

405

허용되지 않는 메서드

요청한 리소스에 대해 요청 메서드가 지원되지 않습니다.

409

충돌

서버의 다른 요청과 충돌이 발생하여 요청을 처리할 수 없습니다.

422

처리할 수 없는 엔티티

요청이 올바르게 구성되었지만 서버가 포함된 지시사항을 처리할 수 없습니다.

429

너무 많은 요청

최근에 많은 요청을 보냈습니다.

500

내부 서버 오류

서버에 내부 오류 또는 잘못된 구성 문제가 발생했습니다.

이 문서가 도움이 되었나요?

Freshsales AI 도우미

Freshsales에서 웹훅과 함께 워크플로를 사용하는 방법은 무엇인가요?

AI 어시스턴트 초기화 중...