웹후크 커넥터 시작Get started with the webhook connector

웹후크 동작 및 트리거를 사용하여 다음 작업을 수행하기 위한 흐름을 시작, 일시 중지 및 계속할 수 있습니다.With the webhook action and trigger, you can start, pause, and resume flows to perform these tasks:

  • 항목이 수신되자마자 Azure 이벤트 허브에서 트리거Trigger from an Azure Event Hub when an item is received
  • 워크플로를 계속하기 전에 승인을 대기합니다.Wait for an approval before continuing a workflow

웹후크를 지원하는 사용자 지정 API를 만드는 방법에 대해 자세히 알아봅니다.Learn more about how to create custom APIs that support a webhook.

웹후크 트리거 사용Use the webhook trigger

트리거는 논리 앱에서 워크플로를 시작하는 이벤트입니다.A trigger is an event that starts a logic app workflow. 웹후크 트리거는 이벤트 기반이며 새 항목에 대한 폴링에 의존하지 않습니다.A webhook trigger is event-based and doesn't rely on polling for new items. 요청 트리거와 마찬가지로, 논리 앱은 이벤트가 발생하는 인스턴트를 발생시킵니다.Like the request trigger, the logic app fires the instant that an event happens. 웹후크 트리거는 콜백 URL을 서비스에 등록하고 해당 URL을 사용해서 필요에 따라 논리 앱을 발생시킵니다.The webhook trigger registers a callback URL to a service and uses that URL to fire the logic app as needed.

논리 앱 디자이너에서 HTTP 트리거를 설정하는 방법을 보여 주는 예제는 다음과 같습니다.Here's an example that shows how to set up an HTTP trigger in the Logic App Designer. 이러한 단계에서는 Logic Apps에서 사용되는 웹후크 구독 및 구독 취소 패턴을 따라 API를 이미 배포했거나 액세스하고 있다고 가정합니다.The steps assume that you have already deployed or are accessing an API that follows the webhook subscribe and unsubscribe pattern in logic apps. 구독 호출은 논리 앱이 새 웹후크와 함께 저장되거나 사용 안 함 상태에서 사용 상태로 전환될 때마다 수행됩니다.The subscribe call is made whenever a logic app is saved with a new webhook, or switched from disabled to enabled. 구독 취소 호출은 논리 앱 웹후크 트리거가 제거 또는 저장되거나 사용 상태에서 사용 안 함 상태로 전환될 때 수행됩니다.The unsubscribe call is made when a logic app webhook trigger is removed and saved, or switched from enabled to disabled.

웹후크 트리거를 사용하려면To add the webhook trigger

  1. HTTP 웹후크 트리거를 논리 앱의 첫 번째 단계로 추가합니다.Add the HTTP Webhook trigger as the first step in a logic app.
  2. 웹후크 구독 및 구독 취소 호출에 대한 매개 변수를 입력합니다.Fill in the parameters for the webhook subscribe and unsubscribe calls.

    이 단계는 HTTP 동작 형식과 동일한 패턴을 따릅니다.This step follows the same pattern as the HTTP action format.

    HTTP 트리거

  3. 하나 이상의 동작을 추가합니다.Add at least one action.

  4. 저장을 클릭하여 논리 앱을 게시합니다.Click Save to publish the logic app. 이 단계를 수행하면 이 Logic App을 트리거하는 데 필요한 콜백 URL을 사용하여 구독 끝점이 호출됩니다.This step calls the subscribe endpoint with the callback URL needed to trigger this logic app.
  5. 서비스에서 콜백 URL에 댛 HTTP POST 를 수행할 때마다 논리 앱이 실행됩니다(논리 앱에는 요청에 전달된 모든 데이터가 포함됨).Whenever the service makes an HTTP POST to the callback URL, the logic app fires, and includes any data passed into the request.

웹후크 동작 사용Use the webhook action

동작은 논리 앱에 정의된 워크플로에 의해 수행되는 작업입니다.An action is an operation carried out by the workflow defined in a logic app. 웹후크 동작은 서비스에 콜백 URL 을 등록하고, 다시 시작하기 전에 URL이 호출될 때까지 대기합니다.A webhook action registers a callback URL with a service and waits until the URL is called before resuming. "승인 전자 메일 보내기" 는 이 패턴을 따르는 커넥터의 예입니다.The "Send Approval Email" is an example of a connector that follows this pattern. 이 패턴을 웹후크 동작을 통해 서비스로 확장할 수 있습니다.You can extend this pattern into any service through the webhook action.

논리 앱 디자이너에서 웹후크 동작을 설정하는 방법을 보여 주는 예제는 다음과 같습니다.Here's an example that shows how to set up a webhook action in the Logic App Designer. 이러한 단계에서는 Logic Apps에서 사용되는 웹후크 구독 및 구독 취소 패턴을 따라 API를 이미 배포했거나 액세스하고 있다고 가정합니다.These steps assume that you have already deployed or are accessing an API that follows the webhook subscribe and unsubscribe pattern used in logic apps. 논리 앱이 웹후크 동작을 실행할 때 구독 호출이 수행됩니다.The subscribe call is made when a logic app executes the webhook action. 응답을 기다리는 동안 또는 논리 앱 실행이 시간 초과되기 전에 실행이 취소될 때 구독 취소 호출이 수행됩니다.The unsubscribe call is made when a run is canceled while waiting for a response, or before the logic app times out.

웹후크 동작을 추가하려면To add a webhook action

  1. 다음 단계 > 동작 추가를 선택합니다.Choose New Step > Add an action.

  2. 검색 상자에 "웹후크"를 입력하여 HTTP 웹후크 동작을 찾습니다.In the search box, type "webhook" to find the HTTP Webhook action.

    쿼리 동작 선택

  3. 웹후크 구독 및 구독 취소 호출에 대한 매개 변수를 입력합니다.Fill in the parameters for the webhook subscribe and unsubscribe calls

    이 단계는 HTTP 동작 형식과 동일한 패턴을 따릅니다.This step follows the same pattern as the HTTP action format.

    쿼리 동작 완료

    런타임 시 논리 앱은 해당 단계에 도달한 후 구독 끝점을 호출합니다.At runtime, the logic app calls the subscribe endpoint after reaching that step.

  4. 저장을 클릭하여 논리 앱을 게시합니다.Click Save to publish the logic app.

기술 세부 정보Technical details

웹후크가 지원하는 트리거 및 동작에 대한 자세한 내용은 다음과 같습니다.Here are more details about the triggers and actions that webhook supports.

웹후크 트리거Webhook triggers

조치Action 설명Description
HTTP 웹후크HTTP Webhook 필요에 따라 URL을 호출할 수 있는 서비스에 대한 콜백 URL을 구독하여 논리 앱을 실행합니다.Subscribe a callback URL to a service that can call the URL to fire logic app as needed.

트리거 세부 정보Trigger details

HTTP 웹후크HTTP Webhook

필요에 따라 URL을 호출할 수 있는 서비스에 대한 콜백 URL을 구독하여 논리 앱을 실행합니다.Subscribe a callback URL to a service that can call the URL to fire logic app as needed. *는 필수 필드를 의미합니다.An * means required field.

표시 이름Display Name 속성 이름Property Name 설명Description
구독 메서드*Subscribe Method* 메서드method 구독 요청에 사용할 HTTP 메서드HTTP Method to use for subscribe request
구독 URI*Subscribe URI* uriuri 구독 요청에 사용할 HTTP URIHTTP URI to use for subscribe request
구독 취소 메서드*Unsubscribe Method* 메서드method 구독 취소 요청에 사용할 HTTP 메서드HTTP method to use for unsubscribe request
구독 취소 URI*Unsubscribe URI* uriuri 구독 취소 요청에 사용할 HTTP URIHTTP URI to use for unsubscribe request
구독 본문Subscribe Body bodybody 구독의 HTTP 요청 본문HTTP request body for subscribe
구독 헤더Subscribe Headers headersheaders 구독의 HTTP 요청 헤더HTTP request headers for subscribe
구독 인증Subscribe Authentication 인증authentication 구독에 사용할 HTTP 인증HTTP authentication to use for subscribe. 자세한 내용은 HTTP 커넥터를 참조하세요.See HTTP connector for details
구독 취소 본문Unsubscribe Body 본문body 구독 취소의 HTTP 요청 본문HTTP request body for unsubscribe
구독 취소 헤더Unsubscribe Headers headersheaders 구독 취소의 HTTP 요청 헤더HTTP request headers for unsubscribe
구독 취소 인증Unsubscribe Authentication authenticationauthentication 구독 취소에 사용할 HTTP 인증HTTP authentication to use for unsubscribe. 자세한 내용은 HTTP 커넥터를 참조하세요.See HTTP connector for details

출력 세부 정보Output Details

웹후크 요청Webhook request

속성 이름Property Name 데이터 형식Data Type 설명Description
headersHeaders objectobject 웹후크 요청 헤더Webhook request headers
본문Body objectobject 웹후크 요청 개체Webhook request object
상태 코드Status Code intint 웹후크 요청 상태 코드Webhook request status code

웹후크 작업Webhook actions

조치Action 설명Description
HTTP 웹후크HTTP Webhook 필요에 따라 URL을 호출할 수 있는 서비스에 대한 콜백 URL을 구독하여 워크플로 단계를 다시 시작합니다.Subscribe a callback URL to a service that can call the URL to resume a workflow step as needed.

작업 세부 정보Action details

HTTP 웹후크HTTP Webhook

필요에 따라 URL을 호출할 수 있는 서비스에 대한 콜백 URL을 구독하여 워크플로 단계를 다시 시작합니다.Subscribe a callback URL to a service that can call the URL to resume a workflow step as needed. *는 필수 필드를 의미합니다.An * means required field.

표시 이름Display Name 속성 이름Property Name 설명Description
구독 메서드*Subscribe Method* 메서드method 구독 요청에 사용할 HTTP 메서드HTTP Method to use for subscribe request
구독 URI*Subscribe URI* uriuri 구독 요청에 사용할 HTTP URIHTTP URI to use for subscribe request
구독 취소 메서드*Unsubscribe Method* 메서드method 구독 취소 요청에 사용할 HTTP 메서드HTTP method to use for unsubscribe request
구독 취소 URI*Unsubscribe URI* uriuri 구독 취소 요청에 사용할 HTTP URIHTTP URI to use for unsubscribe request
구독 본문Subscribe Body bodybody 구독의 HTTP 요청 본문HTTP request body for subscribe
구독 헤더Subscribe Headers headersheaders 구독의 HTTP 요청 헤더HTTP request headers for subscribe
구독 인증Subscribe Authentication 인증authentication 구독에 사용할 HTTP 인증HTTP authentication to use for subscribe. 자세한 내용은 HTTP 커넥터를 참조하세요.See HTTP connector for details
구독 취소 본문Unsubscribe Body 본문body 구독 취소의 HTTP 요청 본문HTTP request body for unsubscribe
구독 취소 헤더Unsubscribe Headers headersheaders 구독 취소의 HTTP 요청 헤더HTTP request headers for unsubscribe
구독 취소 인증Unsubscribe Authentication authenticationauthentication 구독 취소에 사용할 HTTP 인증HTTP authentication to use for unsubscribe. 자세한 내용은 HTTP 커넥터를 참조하세요.See HTTP connector for details

출력 세부 정보Output Details

웹후크 요청Webhook request

속성 이름Property Name 데이터 형식Data Type 설명Description
headersHeaders objectobject 웹후크 요청 헤더Webhook request headers
본문Body objectobject 웹후크 요청 개체Webhook request object
상태 코드Status Code intint 웹후크 요청 상태 코드Webhook request status code

다음 단계Next steps