Passa al contenuto principale

Webhook

I webhook notificano un sistema esterno quando un'esportazione si completa. Sono forniti dall'app Exportelier Automation e restano disattivati finché un amministratore del sito non abilita l'egress dei webhook.

Tipi di webhook disponibili​

  • Webhook in ingresso Slack — pubblica il riepilogo dell'esportazione in Slack.
  • Webhook Microsoft Teams Workflow — pubblica una Adaptive Card 1.2 tramite un workflow Teams creato dal cliente.

Configurazione del webhook Gli endpoint webhook con tipo, riferimento mascherato e stato.

Webhook Microsoft Teams Workflow​

Microsoft ha ritirato i webhook Office 365 Connectors nel maggio 2026. Exportelier accetta quindi nuovi endpoint Teams solo da Microsoft Teams Workflows.

  1. Nel canale Teams di destinazione, apri Altre opzioni (…) → Workflows.
  2. Seleziona Send webhook alerts to a channel. È il modello Anyone. Se crei il workflow da zero, usa il trigger When a Teams webhook request is received e imposta il tipo di autenticazione su Anyone.
  3. Autentica l'account Microsoft che sarà proprietario del workflow, seleziona team e canale e aggiungi il workflow. Microsoft indica che questi modelli webhook di Teams non richiedono una licenza premium.
  4. Copia l'URL generato. Trattalo come una password: chiunque disponga di questo URL firmato può attivare il workflow.
  5. In Exportelier Automation, abilita Settings → Egress → Webhooks. In Webhook endpoints, aggiungi l'URL come Microsoft Teams Workflow webhook.
  6. Seleziona il nuovo endpoint in ogni pianificazione che deve inviare la notifica.

Exportelier archivia l'URL come segreto Forge cifrato e non lo restituisce mai al browser dopo il salvataggio. Gli URL supportati usano HTTPS su un sottodominio di environment.api.powerplatform.com o logic.azure.com. Exportelier invia una Adaptive Card con il nome della pianificazione, il nome file e il numero di ticket. Non invia un header OAuth; l'URL segreto Anyone autorizza la richiesta.

I messaggi vengono visualizzati con l'identità predefinita del bot Workflows di Microsoft. Microsoft non supporta un nome o un'icona personalizzati per questi post webhook.

Office 365 Connectors ritirati

Gli endpoint *.webhook.office.com salvati restano visibili come Action required per evitare modifiche silenziose alle pianificazioni. Crea e prova un nuovo endpoint Workflow, aggiorna tutte le pianificazioni interessate e solo dopo elimina l'endpoint legacy. Gli endpoint legacy non sono disponibili per nuove pianificazioni e falliscono localmente prima dell'invio di qualsiasi richiesta.

Affidabilità e sicurezza​

  • L'egress dei webhook è disattivato per impostazione predefinita e richiede una conferma esplicita dell'amministratore.
  • I segreti vengono mascherati dopo il salvataggio e non devono comparire in ticket, screenshot o log.
  • Le richieste scadono dopo 10 secondi e vengono ritentate una sola volta per errori di rete, HTTP 429 o 5xx.
  • Una risposta corretta del provider, inclusi HTTP 200 o 202, contrassegna la destinazione come consegnata.

Consulta Architettura di sicurezza per come viene isolato l'egress e la pagina API per l'attivazione programmatica.