Introduzione al connettore webhookGet started with the webhook connector

Con l'azione e il trigger webhook è possibile attivare, sospendere e riprendere flussi per eseguire queste attività:With the webhook action and trigger, you can start, pause, and resume flows to perform these tasks:

  • Eseguire l'attivazione da un Hub eventi di Azure alla ricezione di un elementoTrigger from an Azure Event Hub when an item is received
  • Attendere l'approvazione prima di continuare un flusso di lavoroWait for an approval before continuing a workflow

Altre informazioni su come creare API personalizzate che supportano un webhook.Learn more about how to create custom APIs that support a webhook.

Usare il trigger webhookUse the webhook trigger

Un trigger è un evento che avvia un flusso di lavoro nell'app per la logica.A trigger is an event that starts a logic app workflow. Un trigger webhook è basato su eventi e non si basa sul polling per nuovi elementi.A webhook trigger is event-based and doesn't rely on polling for new items. Come il trigger di richiesta, l'app per la logica viene attivata nel momento in cui si verifica un evento.Like the request trigger, the logic app fires the instant that an event happens. Il trigger webhook registra un URL di callback a un servizio e usa l'URL per attivare l'app per la logica in base alle esigenze.The webhook trigger registers a callback URL to a service and uses that URL to fire the logic app as needed.

Ecco un esempio che mostra come configurare un trigger HTTP in Progettazione app per la logica.Here's an example that shows how to set up an HTTP trigger in the Logic App Designer. I passaggi presuppongono che un'API sia già stata distribuita o che si stia accedendo all'API che segue il modello di "subscribe" e "unsubscribe" del webhook nelle app per la logica.The steps assume that you have already deployed or are accessing an API that follows the webhook subscribe and unsubscribe pattern in logic apps. La chiamata "subscribe" viene eseguita ogni volta che un'app per la logica viene salvata con un nuovo webhook o che passa da uno stato disabilitato ad abilitato.The subscribe call is made whenever a logic app is saved with a new webhook, or switched from disabled to enabled. La chiamata "unsubscribe" viene eseguita quando un trigger webhook dell'app per la logica viene rimosso e salvato o passa dallo stato abilitato a disabilitato.The unsubscribe call is made when a logic app webhook trigger is removed and saved, or switched from enabled to disabled.

Per aggiungere il trigger webhookTo add the webhook trigger

  1. Aggiungere il trigger HTTP Webhook come primo passaggio in un'app per la logica.Add the HTTP Webhook trigger as the first step in a logic app.
  2. Specificare i parametri per le chiamate "subscribe" e "unsubscribe" del webhook.Fill in the parameters for the webhook subscribe and unsubscribe calls.

    Questo passaggio segue lo stesso modello del formato dell'azione HTTP.This step follows the same pattern as the HTTP action format.

    Trigger HTTP

  3. Aggiungere almeno un'azione.Add at least one action.

  4. Fare clic su Salva per pubblicare l'app per la logica.Click Save to publish the logic app. Questo passaggio chiama l'endpoint "subscribe" con l'URL di callback necessario per attivare questa app per la logica.This step calls the subscribe endpoint with the callback URL needed to trigger this logic app.
  5. Ogni volta che il servizio esegue un HTTP POST all'URL di callback, viene attivata l'app per la logica, inclusi i dati passati nella richiesta.Whenever the service makes an HTTP POST to the callback URL, the logic app fires, and includes any data passed into the request.

Usare l'azione webhookUse the webhook action

Un'azione è un'operazione eseguita dal flusso di lavoro e definita in un'app per la logica.An action is an operation carried out by the workflow defined in a logic app. Un'azione webhook registra un URL di callback con un servizio e attende che l'URL venga chiamato prima di riprendere le operazioni.A webhook action registers a callback URL with a service and waits until the URL is called before resuming. "Send Approval Email" è un esempio di connettore che segue questo modello.The "Send Approval Email" is an example of a connector that follows this pattern. È possibile estendere questo modello in qualsiasi servizio tramite l'azione webhook.You can extend this pattern into any service through the webhook action.

Ecco un esempio che mostra come configurare un azione webhook in Progettazione app per la logica.Here's an example that shows how to set up a webhook action in the Logic App Designer. I passaggi presuppongono che un'API sia già stata distribuita o che si stia accedendo a un'API che segue il modello di "subscribe" e "unsubscribe" del webhook usato nelle app per la logica.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. Quando un'app per la logica esegue l'azione webhook, viene eseguita la chiamata "subscribe".The subscribe call is made when a logic app executes the webhook action. Quando un'esecuzione viene annullata in attesa di una risposta o prima che si verifichi il timeout dell'app per la logica, viene eseguita la chiamata "unsubscribe".The unsubscribe call is made when a run is canceled while waiting for a response, or before the logic app times out.

Per aggiungere un'azione webhookTo add a webhook action

  1. Scegliere Nuovo passaggio > Aggiungi un'azione.Choose New Step > Add an action.

  2. Nella casella di ricerca digitare "webhook" per trovare l'azione HTTP Webhook.In the search box, type "webhook" to find the HTTP Webhook action.

    Selezionare l'azione di query

  3. Specificare i parametri per le chiamate "subscribe" e "unsubscribe" del webhookFill in the parameters for the webhook subscribe and unsubscribe calls

    Questo passaggio segue lo stesso modello del formato dell'azione HTTP.This step follows the same pattern as the HTTP action format.

    Completare l'azione di query

    In fase di esecuzione, l'app per la logica chiama l'endpoint "subscribe" dopo il raggiungimento di tale passaggio.At runtime, the logic app calls the subscribe endpoint after reaching that step.

  4. Fare clic su Salva per pubblicare l'app per la logica.Click Save to publish the logic app.

Dettagli tecniciTechnical details

Di seguito altre informazioni sui trigger e sulle azioni che supporta webhook.Here are more details about the triggers and actions that webhook supports.

Trigger webhookWebhook triggers

AzioneAction DescrizioneDescription
HTTP WebhookHTTP Webhook Sottoscrivere un URL callback a un servizio in grado di chiamare l'URL per attivare l'app per la logica in base alle esigenze.Subscribe a callback URL to a service that can call the URL to fire logic app as needed.

Dettagli del triggerTrigger details

HTTP WebhookHTTP Webhook

Sottoscrivere un URL callback a un servizio in grado di chiamare l'URL per attivare l'app per la logica in base alle esigenze.Subscribe a callback URL to a service that can call the URL to fire logic app as needed. L'asterisco (*) indica che il campo è obbligatorio.An * means required field.

Nome visualizzatoDisplay Name Nome proprietàProperty Name DescrizioneDescription
Subscribe MethodSubscribe Method staticomethod Metodo HTTP da usare per la richiesta di sottoscrizioneHTTP Method to use for subscribe request
Subscribe URISubscribe URI Uriuri URI HTTP da usare per la richiesta di sottoscrizioneHTTP URI to use for subscribe request
Unsubscribe MethodUnsubscribe Method staticomethod Metodo HTTP da usare per annullare la richiesta di sottoscrizioneHTTP method to use for unsubscribe request
Unsubscribe URIUnsubscribe URI Uriuri URI HTTP da usare per annullare la richiesta di sottoscrizioneHTTP URI to use for unsubscribe request
Subscribe BodySubscribe Body bodybody Request body HTTP per la sottoscrizioneHTTP request body for subscribe
Subscribe HeadersSubscribe Headers headersheaders Intestazioni della richiesta HTTP per la sottoscrizioneHTTP request headers for subscribe
Subscribe AuthenticationSubscribe Authentication authenticationauthentication Autenticazione HTTP da usare per la sottoscrizione.HTTP authentication to use for subscribe. Vedere Connettore HTTP per informazioni dettagliateSee HTTP connector for details
Unsubscribe BodyUnsubscribe Body bodybody Request body HTTP per annullare la sottoscrizioneHTTP request body for unsubscribe
Unsubscribe HeadersUnsubscribe Headers headersheaders Intestazioni della richiesta HTTP per annullare la sottoscrizioneHTTP request headers for unsubscribe
Unsubscribe AuthenticationUnsubscribe Authentication authenticationauthentication Autenticazione HTTP da usare per annullare la sottoscrizione.HTTP authentication to use for unsubscribe. Vedere Connettore HTTP per informazioni dettagliateSee HTTP connector for details

Dettagli dell'outputOutput Details

Richiesta WebhookWebhook request

Nome proprietàProperty Name Tipo di datiData Type DescrizioneDescription
headersHeaders objectobject Intestazioni della richiesta webhookWebhook request headers
bodyBody objectobject Oggetto della richiesta webhookWebhook request object
Codice di statoStatus Code intint Codice di stato della richiesta webhookWebhook request status code

Azioni webhookWebhook actions

AzioneAction DescrizioneDescription
HTTP WebhookHTTP Webhook Sottoscrivere un URL callback a un servizio in grado di chiamare l'URL per riprendere un passaggio del flusso di lavoro in base alle esigenze.Subscribe a callback URL to a service that can call the URL to resume a workflow step as needed.

Informazioni dettagliate sulle azioniAction details

HTTP WebhookHTTP Webhook

Sottoscrivere un URL callback a un servizio in grado di chiamare l'URL per riprendere un passaggio del flusso di lavoro in base alle esigenze.Subscribe a callback URL to a service that can call the URL to resume a workflow step as needed. L'asterisco (*) indica che il campo è obbligatorio.An * means required field.

Nome visualizzatoDisplay Name Nome proprietàProperty Name DescrizioneDescription
Subscribe MethodSubscribe Method staticomethod Metodo HTTP da usare per la richiesta di sottoscrizioneHTTP Method to use for subscribe request
Subscribe URISubscribe URI Uriuri URI HTTP da usare per la richiesta di sottoscrizioneHTTP URI to use for subscribe request
Unsubscribe MethodUnsubscribe Method staticomethod Metodo HTTP da usare per annullare la richiesta di sottoscrizioneHTTP method to use for unsubscribe request
Unsubscribe URIUnsubscribe URI Uriuri URI HTTP da usare per annullare la richiesta di sottoscrizioneHTTP URI to use for unsubscribe request
Subscribe BodySubscribe Body bodybody Request body HTTP per la sottoscrizioneHTTP request body for subscribe
Subscribe HeadersSubscribe Headers headersheaders Intestazioni della richiesta HTTP per la sottoscrizioneHTTP request headers for subscribe
Subscribe AuthenticationSubscribe Authentication authenticationauthentication Autenticazione HTTP da usare per la sottoscrizione.HTTP authentication to use for subscribe. Vedere Connettore HTTP per informazioni dettagliateSee HTTP connector for details
Unsubscribe BodyUnsubscribe Body bodybody Request body HTTP per annullare la sottoscrizioneHTTP request body for unsubscribe
Unsubscribe HeadersUnsubscribe Headers headersheaders Intestazioni della richiesta HTTP per annullare la sottoscrizioneHTTP request headers for unsubscribe
Unsubscribe AuthenticationUnsubscribe Authentication authenticationauthentication Autenticazione HTTP da usare per annullare la sottoscrizione.HTTP authentication to use for unsubscribe. Vedere Connettore HTTP per informazioni dettagliateSee HTTP connector for details

Dettagli dell'outputOutput Details

Richiesta WebhookWebhook request

Nome proprietàProperty Name Tipo di datiData Type DescrizioneDescription
headersHeaders objectobject Intestazioni della richiesta webhookWebhook request headers
bodyBody objectobject Oggetto della richiesta webhookWebhook request object
Codice di statoStatus Code intint Codice di stato della richiesta webhookWebhook request status code

Passaggi successiviNext steps