Documentazione
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.
AutoPSEO pubblica su Slack tramite webhook in entrata. Slack ti fornisce un URL che scrive in un solo canale, tu incolli quell'URL in AutoPSEO e da quel momento report e avvisi iniziano ad arrivare lì. AutoPSEO non installa nulla nel tuo workspace: non può leggere i messaggi, elencare i tuoi canali né pubblicare in posti diversi da quello a cui punta il webhook. Aggiungi una voce per ogni canale in cui vuoi ricevere messaggi.
Creare il webhook in Slack
Slack emette i webhook in entrata tramite un'app Slack. Seguendo la guida di Slack ai webhook in entrata:
- Crea un'app Slack per il tuo workspace, oppure apri una che usi già per le notifiche. Scegli un nome che il tuo team riconosca facilmente, come Report SEO.
- Nelle impostazioni dell'app, apri Incoming Webhooks e attiva Activate Incoming Webhooks.
- Fai clic su Add New Webhook to Workspace, scegli il canale e conferma. Per un canale privato devi esserne prima membro.
- Copia il nuovo URL da Webhook URLs for Your Workspace. Inizia con
https://hooks.slack.com/services/.
Ripeti i passaggi 3 e 4 per ogni altro canale: una sola app può contenere più webhook. Funziona ancora anche un URL creato con i vecchi webhook di integrazione personalizzata di Slack, anche se Slack consiglia di passare a un'app.
Slack tratta l'URL come un segreto: chiunque lo possieda può pubblicare nel canale. Incollalo in AutoPSEO e tienilo fuori da ticket, wiki e screenshot.
Aggiungerlo ad AutoPSEO
- In Slack, Teams & Webhooks, trova Slack - Connected workspaces e fai clic su Add to Slack. Si apre il modulo New channel con Slack già selezionato come destinazione.
- Name: un'etichetta per gli elenchi di AutoPSEO, per la cronologia degli invii e per il messaggio di prova, ad esempio
#seo-alerts. - Webhook URL: incolla l'URL di Slack. Per una voce Slack AutoPSEO accetta solo indirizzi
httpssu slack.com e ti avvisa subito se l'URL non è valido. - Fai clic su Add channel, quindi su Send test nella nuova riga. Entro pochi secondi in Slack dovrebbe comparire un breve messaggio con il nome della voce, e AutoPSEO indica quanto tempo ha impiegato Slack a rispondere.
L'URL viene salvato cifrato (AES-GCM). Da quel momento l'elenco ne mostra solo l'host e gli ultimi caratteri, quindi scegli nomi che chiariscano quale canale Slack alimenta ciascuna voce.
Poi dagli qualcosa da pubblicare: un report programmato o un avviso. La tabella Slack - Subscriptions sotto l'elenco mostra quindi, per ogni canale Slack, tutte le regole che vi pubblicano, la loro pianificazione e se sono attive o in pausa.
Più canali e workspace
Un URL webhook appartiene a un solo canale in un solo workspace, e Slack non consente a un messaggio di sostituire il canale per cui il webhook è stato creato. Questo rende tutto prevedibile:
- Un canale Slack, una voce. Per separare i clienti tra
#client-ae#client-b, crea un webhook per ciascuno e aggiungili entrambi. - Più workspace funzionano allo stesso modo, perché ogni webhook risiede nel workspace in cui lo hai creato.
- Una voce può gestire molte regole. Invia il report settimanale e l'avviso di calo del traffico alla stessa voce, oppure tieni gli avvisi in un canale più frequentato, dedicato solo a loro.
Perché un messaggio non è arrivato
Send test mostra subito il motivo. Per i messaggi programmati, apri Delivery history, che conserva la risposta di Slack per ogni tentativo non riuscito.
| Cosa mostra AutoPSEO | Cosa significa | Cosa fare |
|---|---|---|
| Slack ha rifiutato l'URL (no_service) | Il webhook è stato rimosso o disattivato in Slack, oppure l'URL contiene un errore di battitura | Crea un nuovo webhook, aggiungilo, poi elimina la vecchia voce |
| Il canale Slack non esiste più o è archiviato | Slack ha risposto channel_not_found o channel_is_archived | Crea un webhook per un canale ancora in uso |
| Slack sta limitando le richieste | Slack ha risposto con HTTP 429 | Attendi un po', poi usa Send now o Test rule |
| Timeout dopo 10 secondi | Slack non ha risposto in tempo | Riprova più tardi |
| La prova è terminata | Nessun piano o prova attivi | Scegli un piano; gli invii programmati riprenderanno con quello |
Un report programmato non riuscito non viene inviato di nuovo nello stesso periodo, quindi usa Send now dopo aver risolto la causa. Un avviso che non è stato possibile pubblicare viene valutato di nuovo al controllo successivo (quando vengono eseguiti gli avvisi).
Rimuovere un canale Slack
Delete nella riga della voce rimuove l'URL salvato e, dopo una conferma che ti indica quante sono, tutte le regole che pubblicano lì. AutoPSEO non modifica nulla in Slack: il webhook continua a funzionare finché qualcuno non lo rimuove dall'app Slack, quindi fallo anche tu se l'URL potrebbe essere stato visto da altri.