Documentazione
Slack, Teams e webhook
Invia report pianificati e avvisi di Search Console a Slack, Microsoft Teams o a qualsiasi endpoint HTTPS, il tutto gestito da un'unica pagina con un registro delle consegne.
AutoPSEO può portare i suoi numeri fuori dall'app in due modi: report pianificati con le cifre principali di Search Console di una proprietà e avvisi che scattano quando un rilevatore vede variazioni in clic, CTR, posizioni, indicizzazione, ranking monitorati o audit. Entrambi vengono inviati a un canale che aggiungi una sola volta: un webhook in entrata di Slack, un URL di Workflows di Microsoft Teams o qualsiasi endpoint HTTPS pubblico che accetti JSON firmato. Gestisci tutto da un'unica pagina.
Dove trovarlo
Apri Slack, Teams & Webhooks nella barra laterale sinistra, oppure vai su Account e scegli Manage nella scheda Slack, Teams & webhooks (aprila nell'app). La pagina ha una sezione per ogni destinazione (Slack - Connected workspaces, Microsoft Teams, Outbound webhooks), seguita da Scheduled reports, Alerts e Delivery history.
Canali, regole e consegne
La funzionalità si compone di tre elementi.
- Canale: un URL di destinazione, etichettato Slack, Microsoft Teams o Webhook. AutoPSEO memorizza l'URL in forma cifrata e in seguito ne mostra solo l'host e gli ultimi caratteri. Un account può contenere 25 canali.
- Regola: un report pianificato o un avviso, indirizzato esattamente a un canale. Un canale può alimentare un numero qualsiasi di regole, fino a 50 regole per account. Per ricevere lo stesso avviso sia in Slack sia in Teams, crea due regole.
- Consegna: un singolo tentativo di pubblicare un messaggio. Delivery history conserva gli ultimi 50 tentativi su tutti i canali, inclusi test e riepiloghi singoli, con lo stato (inviato, non riuscito o saltato), lo stato HTTP, il tempo impiegato dalla destinazione per rispondere e il motivo indicato in caso di errore.
Canali e regole appartengono al tuo login. Un collega che vuole ricevere avvisi nel proprio canale deve configurare i propri.
Dalla configurazione al primo messaggio
- Collega le proprietà di Search Console di cui vuoi creare i report (Collegare Search Console). La proprietà demo compare in ogni selettore, quindi puoi provare una regola prima ancora di avere i tuoi dati.
- Aggiungi un canale con Add to Slack, New Teams channel o New webhook: assegna un nome e incolla l'URL. Dove trovare ciascun URL: Slack, Microsoft Teams, webhook.
- Fai clic su Send test nella riga del canale e verifica che il messaggio sia arrivato.
- Crea una regola con New scheduled report o New alert. Entrambi i pulsanti restano disattivati finché non esiste almeno un canale.
Quando vengono inviati i messaggi
Un processo viene eseguito all'inizio di ogni ora (UTC) e stabilisce cosa è in scadenza.
| Messaggio | Quando viene inviato |
|---|---|
| Report pianificato | All'ora che scegli, con cadenza giornaliera, settimanale o mensile, al massimo una volta per periodo |
| Avviso su clic, CTR, posizione, query perse, monitoraggio dei ranking o audit | Controllato una volta al giorno, nell'esecuzione delle 06:00 UTC |
| Avviso sui cambi di indicizzazione | Controllato ogni ora |
| Send test, Send now, Test rule | Immediatamente |
| Send to Slack da una pagina di report | Immediatamente (Usare AutoPSEO in Slack) |
Le finestre temporali di report e avvisi terminano il giorno precedente all'esecuzione, perché Search Console pubblica i dati con un certo ritardo. Ogni messaggio indica le date utilizzate, così nessuno deve indovinare.
Cosa serve
- Un piano attivo o una prova in corso. Quando una prova termina senza che sia stato scelto un piano, report pianificati e avvisi si interrompono, e nuovi canali, modifiche alle regole, test e invii vengono rifiutati finché non ne scegli uno (piani e fatturazione).
- Una destinazione che controlli: l'autorizzazione a creare un webhook in entrata in Slack, un webhook di Workflows in un canale Teams o un endpoint HTTPS di tua proprietà.
Attenzione a chi può leggere il canale
Ogni messaggio contiene dati sulle prestazioni di ricerca: clic, impressioni, query e indirizzi delle pagine. Chiunque possa leggere il canale Slack o Teams, o il sistema dietro un webhook, li vede, quindi pubblica le proprietà dei clienti in canali privati. Anche l'URL di destinazione è un segreto: chi lo possiede può pubblicare nel tuo canale, come Slack segnala per i propri webhook. Per questo AutoPSEO non lo mostra più dopo il salvataggio.
Per approfondire
- Collegare Slack con un webhook in entrata: creare l'URL in Slack, aggiungerlo e gli errori che Slack può restituire.
- Report pianificati: tipi di report, periodi, cadenza e la regola del singolo invio per periodo.
- Avvisi: i nove rilevatori, le soglie, la gravità e il silenziamento.
- Usare AutoPSEO in Slack: cosa contiene un messaggio e come funziona Send to Slack.
- Microsoft Teams: URL di Workflows e Adaptive Card.
- Webhook in uscita: il corpo JSON, i tipi di evento e la verifica della firma.
Panoramiche dei prodotti: AutoPSEO per Slack e AutoPSEO per Microsoft Teams.
In questa sezione
Collegare Slack con un webhook in entrata
Crea un webhook in entrata di Slack per un canale, aggiungilo ad AutoPSEO, invia un messaggio di prova e risolvi gli errori che Slack restituisce quando un invio non va a buon fine.
Report programmati in Slack, Teams o tramite webhook
Pubblica in un canale, con cadenza giornaliera, settimanale o mensile, clic, impressioni, CTR e posizione di una proprietà, insieme alle query, alle pagine o alle variazioni di ranking principali.
Avvisi: rilevatori, soglie e gravità
Nove rilevatori monitorano clic, CTR, posizione, query perse, cambi di indicizzazione, posizionamenti e audit, e pubblicano su un canale solo quando viene superata una soglia.
Usare AutoPSEO in Slack
Che cosa contengono i messaggi Slack di AutoPSEO, come Send to Slack pubblica in un canale la tabella di qualsiasi report e che cosa puoi e non puoi fare direttamente da Slack.
Avvisi e report su Microsoft Teams
Crea un webhook Workflows in un canale Teams, aggiungilo ad AutoPSEO e ricevi avvisi e report pianificati come Adaptive Card colorate in base alla gravità.
Webhook in uscita: payload e firma
Ricevi gli avvisi e i report di AutoPSEO come JSON firmato su qualsiasi endpoint HTTPS: gli header della richiesta, i campi del body, i tipi di evento e come verificare la firma.