Dokumentasyon

Pagkonekta ng Slack gamit ang incoming webhook

Gumawa ng Slack incoming webhook para sa isang channel, idagdag ito sa AutoPSEO, magpadala ng test message, at ayusin ang mga error na ibinabalik ng Slack kapag pumalya ang pag-post.

Account → Slack, Teams at Webhooks → Slack - Mga konektadong workspaceKailangan ng subscription o trial4 min na pagbasa

Nagpo-post ang AutoPSEO sa Slack sa pamamagitan ng mga incoming webhook. Magbibigay ang Slack ng URL na nagsusulat sa isang channel, ipe-paste mo ang URL na iyon sa AutoPSEO, at doon na darating ang mga report at alerto. Walang ini-install ang AutoPSEO sa iyong workspace: hindi nito mababasa ang mga mensahe, hindi nito malilista ang iyong mga channel, at hindi ito makakapag-post sa anumang lugar na hindi tinutukoy ng webhook. Magdagdag ng isang entry para sa bawat channel na gusto mong padalhan ng mga mensahe.

Gumawa ng webhook sa Slack

Nag-iisyu ang Slack ng mga incoming webhook sa pamamagitan ng isang Slack app. Ayon sa gabay ng Slack sa incoming webhook:

Gumawa ng Slack app para sa iyong workspace, o magbukas ng app na ginagamit mo na para sa mga notification. Pumili ng pangalang madaling makilala ng iyong team, gaya ng SEO reports.
Sa mga setting ng app, buksan ang Incoming Webhooks at i-on ang Activate Incoming Webhooks.
I-click ang Add New Webhook to Workspace, piliin ang channel at aprubahan. Para sa private channel, kailangan mo munang maging miyembro nito.
Kopyahin ang bagong URL mula sa Webhook URLs for Your Workspace. Nagsisimula ito sa https://hooks.slack.com/services/.

Ulitin ang hakbang 3 at 4 para sa bawat karagdagang channel; maaaring maglaman ang isang app ng maraming webhook. Gumagana pa rin ang URL na ginawa gamit ang mas lumang custom-integration webhook ng Slack, bagaman inirerekomenda ng Slack na ilipat ang mga iyon sa isang app.

Itinuturing ng Slack na sikreto ang URL: sinumang may hawak nito ay makakapag-post sa channel. I-paste ito sa AutoPSEO at huwag ilagay sa mga ticket, wiki, at screenshot.

Idagdag ito sa AutoPSEO

Sa Slack, Teams & Webhooks, hanapin ang Slack - Connected workspaces at i-click ang Add to Slack. Magbubukas ang form na New channel na naka-set na ang Slack bilang destinasyon.
Name: isang label para sa mga listahan ng AutoPSEO, sa kasaysayan ng delivery, at sa test message, halimbawa #seo-alerts.
Webhook URL: i-paste ang Slack URL. Para sa Slack entry, tumatanggap lang ang AutoPSEO ng mga https address sa slack.com, at agad nitong sasabihin kung hindi tumutugma ang URL.
I-click ang Add channel, saka ang Send test sa bagong row. Dapat lumabas sa Slack sa loob ng ilang segundo ang maikling mensaheng may pangalan ng entry, at iuulat ng AutoPSEO kung gaano katagal sumagot ang Slack.

Naka-encrypt (AES-GCM) ang pagkaka-imbak ng URL. Mula noon, host at huling mga karakter lang nito ang ipapakita ng listahan, kaya pumili ng mga pangalang malinaw na nagsasabi kung aling Slack channel ang pinapadalhan ng bawat entry.

Susunod, bigyan ito ng ipo-post: isang naka-iskedyul na report o isang alerto. Ipapakita naman ng talahanayang Slack - Subscriptions sa ibaba ng listahan, para sa bawat Slack channel, ang bawat rule na nagpo-post doon, ang iskedyul nito, at kung aktibo o naka-pause ito.

Maraming channel at workspace

Nasa isang channel sa isang workspace ang bawat webhook URL, at hindi pinapayagan ng Slack na baguhin ng isang mensahe ang channel kung saan ginawa ang webhook. Dahil dito, madaling hulaan ang takbo ng mga bagay:

Isang Slack channel, isang entry. Para hatiin ang mga kliyente sa pagitan ng #client-a at #client-b, gumawa ng webhook para sa bawat isa at idagdag ang dalawa.
Ganoon din ang paraan para sa maraming workspace, dahil nasa workspace kung saan mo ginawa ang bawat webhook.
Puwedeng magkaroon ng maraming rule ang isang entry. Ipadala ang lingguhang report at ang alerto sa pagbaba ng traffic sa iisang entry, o ilagay ang mga alerto sa sarili nilang channel na mas aktibo.

Bakit hindi dumating ang mensahe

Agad na ipinapakita ng Send test ang dahilan. Para sa mga naka-iskedyul na mensahe, buksan ang Delivery history, na nag-iingat ng sagot ng Slack sa bawat pumalyang pagtatangka.

Ipinapakita ng AutoPSEO	Ibig sabihin	Ano ang gagawin
Tinanggihan ng Slack ang URL (no_service)	Inalis o na-disable ang webhook sa Slack, o mali ang pagkakatype ng URL	Gumawa ng bagong webhook, idagdag ito, saka burahin ang lumang entry
Wala na ang Slack channel, o naka-archive na ito	Sumagot ang Slack ng `channel_not_found` o `channel_is_archived`	Gumawa ng webhook para sa channel na ginagamit pa
Nililimitahan ng Slack ang dami ng request natin	Sumagot ang Slack ng HTTP 429	Maghintay sandali, saka gamitin ang Send now o Test rule
Nag-time out pagkalipas ng 10 segundo	Hindi sumagot ang Slack sa takdang oras	Subukan ulit mamaya
Tapos na ang iyong trial	Walang aktibong plano o trial	Pumili ng plano; babalik ang mga naka-iskedyul na delivery kasabay nito

Hindi na ipinapadala ulit sa parehong panahon ang naka-iskedyul na report na pumalya, kaya gamitin ang Send now kapag naayos na ang sanhi. Ang alertong hindi na-post ay susuriin muli sa susunod nitong check (kailan tumatakbo ang mga alerto).

Pag-alis ng Slack channel

Ang Delete sa row ng entry ay nag-aalis ng naka-imbak na URL at, pagkatapos ng kumpirmasyong nagsasabi kung ilan, ng bawat rule na nagpo-post doon. Walang binabago ang AutoPSEO sa Slack: patuloy na gagana ang webhook hanggang may mag-alis nito sa Slack app, kaya gawin din iyon kung maaaring nakita ng iba ang URL.