Webhook

Comprendi la pagina Webhook del progetto e recupera quando il suo portale incorporato non è pronto.

I webhook consentono a un altro servizio di ricevere eventi selezionati da un progetto di Runner. Questa è una funzione avanzata e sensibile alla sicurezza: usala solo quando sai quale servizio dovrebbe ricevere gli eventi e come quel servizio li verifica.

Percorso di accesso

Apri la pagina Webhook del progetto solo attraverso una voce che Runner rende disponibile per la tua area di lavoro. Se non c'è una voce, non indovinare un URL; vedi Disponibilità delle funzioni o chiedi al supporto se la funzione è abilitata.

Prima di iniziare

Utilizza Webhook solo quando Runner o il supporto espone una voce approvata.
Conosci il servizio ricevente previsto e come verifica gli eventi.
Tratta gli indirizzi degli endpoint, i segreti di firma e i dati consegnati come sensibili.

Cosa mostra Runner

Runner prepara il servizio webhook prima di visualizzare il portale di gestione incorporato.

Stato della pagina o controllo	Cosa significa o fa
Caricamento in corso…	Runner sta controllando se il servizio webhook è pronto.
La piattaforma webhook si sta inizializzando	La configurazione è ancora in corso. Aspetta e mantieni la pagina aperta, o ritorna più tardi.
L'inizializzazione sta richiedendo più tempo del previsto	La configurazione non è stata completata dopo l'attesa normale. Riprova chiede a Runner di eseguire di nuovo il provisioning del servizio.
Riprovando in corso…	Il tentativo è in corso; il pulsante rimane non disponibile fino al completamento della richiesta.
Messaggio di errore	Runner non ha potuto preparare il servizio. Mantieni il messaggio visibile per il supporto.
Portale webhook incorporato	Il servizio è pronto. Le etichette e i controlli esatti all'interno di questo portale gestito dal provider possono cambiare, quindi segui le istruzioni mostrate lì piuttosto che fare affidamento su nomi di pulsanti fissi in questa guida.
Riconnetti Shopify	Apre la pagina di integrazione di Shopify quando una connessione Shopify più vecchia necessita di nuove autorizzazioni webhook. Riconnetti prima di aspettarti che gli eventi di Shopify arrivino.

Recupera da un'inizializzazione lunga

Aspetta che il messaggio di inizializzazione finisca.
Se L'inizializzazione sta richiedendo più tempo del previsto appare, seleziona Riprova una volta.
Aspetta che il portale incorporato sostituisca la schermata di inizializzazione.
Se un errore appare di nuovo, salva il nome del progetto e il messaggio esatto, quindi contatta il supporto invece di riprovare ripetutamente.

Riconnetti Shopify quando richiesto

Leggi l'avviso Riconnetti il tuo negozio Shopify.
Seleziona Riconnetti Shopify.
Completa il flusso di connessione sulla pagina di integrazione di Shopify.
Ritorna a Webhook e conferma che l'avviso di riconnessione è scomparso prima di fare affidamento sulla consegna degli eventi.

La riconnessione modifica l'autorizzazione di integrazione del negozio. Solo una persona autorizzata a gestire quella connessione del negozio dovrebbe continuare.

Note sulla sicurezza

Tratta gli indirizzi degli endpoint, i segreti di firma e i contenuti degli eventi come sensibili.
Aggiungi o modifica una destinazione solo quando il suo proprietario ha fornito l'indirizzo sicuro corretto.
Rivedi ogni conferma mostrata all'interno del portale incorporato; le sue azioni possono influire sulle consegne future.
Se un valore di firma è esposto, sostituiscilo sia nel servizio webhook di Runner che nel sistema ricevente prima di inviare altri eventi.

Risoluzione dei problemi

Problema	Passo successivo
Nessuna voce Webhook	La funzione non è esposta in questa area di lavoro. Controlla Disponibilità delle funzioni.
L'inizializzazione non finisce	Utilizza Riprova una volta, quindi segnala lo stato esatto se si ripete.
Appare un messaggio di errore	Mantieni il messaggio completo e il nome del progetto per il supporto.
L'avviso di riconnessione di Shopify rimane	Completa la riconnessione dalla pagina di integrazione, quindi ricarica Webhook una volta.
Il portale incorporato è vuoto o si comporta diversamente	Ricarica una volta. Se persiste, cattura cosa è visibile; l'interfaccia del provider incorporato potrebbe differire per account o rilascio.