Documentație
Conectarea Slack printr-un webhook de intrare
Creați un webhook de intrare Slack pentru un canal, adăugați-l în AutoPSEO, trimiteți un mesaj de test și remediați erorile returnate de Slack atunci când o postare eșuează.
AutoPSEO postează în Slack prin webhook-uri de intrare. Slack vă oferă un URL care scrie într-un singur canal, îl lipiți în AutoPSEO, iar rapoartele și alertele încep să apară acolo. AutoPSEO nu instalează nimic în workspace-ul dvs.: nu poate citi mesaje, nu poate lista canalele și nu poate posta în alt loc decât cel către care indică webhook-ul. Adăugați câte o intrare pentru fiecare canal în care doriți să primiți mesaje.
Crearea webhook-ului în Slack
Slack emite webhook-urile de intrare prin intermediul unei aplicații Slack. Conform ghidului Slack pentru webhook-uri de intrare:
- Creați o aplicație Slack pentru workspace-ul dvs. sau deschideți una pe care o folosiți deja pentru notificări. Alegeți un nume pe care echipa îl va recunoaște ușor, de exemplu Rapoarte SEO.
- În setările aplicației, deschideți Incoming Webhooks și activați Activate Incoming Webhooks.
- Faceți clic pe Add New Webhook to Workspace, alegeți canalul și aprobați. Pentru un canal privat trebuie mai întâi să fiți membru al acestuia.
- Copiați noul URL din Webhook URLs for Your Workspace. Acesta începe cu
https://hooks.slack.com/services/.
Repetați pașii 3 și 4 pentru fiecare canal suplimentar; o aplicație poate conține mai multe webhook-uri. Un URL creat cu webhook-urile mai vechi din integrările personalizate Slack funcționează în continuare, deși Slack recomandă migrarea lor către o aplicație.
Slack tratează URL-ul ca pe un secret: oricine îl deține poate posta în canal. Lipiți-l în AutoPSEO și nu îl includeți în tichete, wiki-uri sau capturi de ecran.
Adăugarea în AutoPSEO
- În Slack, Teams & Webhooks, găsiți Slack - Connected workspaces și faceți clic pe Add to Slack. Se deschide formularul New channel, cu Slack deja selectat ca destinație.
- Name: o etichetă pentru listele din AutoPSEO, istoricul livrărilor și mesajul de test, de exemplu
#seo-alerts. - Webhook URL: lipiți URL-ul Slack. Pentru o intrare Slack, AutoPSEO acceptă doar adrese
httpsde pe slack.com și vă anunță imediat dacă URL-ul nu se potrivește. - Faceți clic pe Add channel, apoi pe Send test în rândul nou. Un mesaj scurt care menționează numele intrării ar trebui să apară în Slack în câteva secunde, iar AutoPSEO raportează cât timp a durat răspunsul Slack.
URL-ul este stocat criptat (AES-GCM). De atunci, lista afișează doar gazda și ultimele caractere, așa că alegeți nume care arată clar ce canal Slack alimentează fiecare intrare.
Apoi, dați-i ceva de postat: un raport programat sau o alertă. Tabelul Slack - Subscriptions de sub listă afișează apoi, pentru fiecare canal Slack, toate regulile care postează acolo, programul lor și dacă sunt active sau în pauză.
Mai multe canale și workspace-uri
Un URL de webhook aparține unui singur canal dintr-un singur workspace, iar Slack nu permite ca un mesaj să înlocuiască canalul pentru care a fost creat webhook-ul. Asta păstrează lucrurile previzibile:
- Un canal Slack, o intrare. Pentru a împărți clienții între
#client-ași#client-b, creați câte un webhook pentru fiecare și adăugați-le pe ambele. - Mai multe workspace-uri funcționează la fel, deoarece fiecare webhook aparține workspace-ului în care l-ați creat.
- O intrare poate avea mai multe reguli. Trimiteți raportul săptămânal și alerta de scădere a traficului către aceeași intrare sau păstrați alertele într-un canal separat, mai aglomerat.
De ce nu a ajuns un mesaj
Send test afișează motivul imediat. Pentru mesajele programate, deschideți Delivery history, care păstrează răspunsul Slack pentru fiecare încercare eșuată.
| Ce afișează AutoPSEO | Ce înseamnă | Ce de făcut |
|---|---|---|
| Slack a respins URL-ul (no_service) | Webhook-ul a fost șters sau dezactivat în Slack, ori URL-ul este scris greșit | Creați un webhook nou, adăugați-l, apoi ștergeți intrarea veche |
| Canalul Slack nu mai există sau este arhivat | Slack a răspuns channel_not_found sau channel_is_archived | Creați un webhook pentru un canal care este încă folosit |
| Slack aplică o limită de rată | Slack a răspuns cu HTTP 429 | Așteptați puțin, apoi folosiți Send now sau Test rule |
| Timp expirat după 10 secunde | Slack nu a răspuns la timp | Încercați din nou mai târziu |
| Perioada de probă s-a încheiat | Nu există un plan activ sau o perioadă de probă | Alegeți un plan; livrările programate se reiau odată cu acesta |
Un raport programat eșuat nu este retrimis în aceeași perioadă, așa că folosiți Send now după ce ați remediat cauza. O alertă care nu a putut fi postată este evaluată din nou la următoarea verificare (când rulează alertele).
Eliminarea unui canal Slack
Delete din rândul intrării elimină URL-ul stocat și, după o confirmare care vă indică numărul, toate regulile care postează acolo. AutoPSEO nu modifică nimic în Slack: webhook-ul continuă să funcționeze până când cineva îl elimină din aplicația Slack, așa că faceți și acest lucru dacă URL-ul ar fi putut fi văzut de alte persoane.