Dokumentáció
Slack összekötése bejövő webhookkal
Hozz létre Slack bejövő webhookot egy csatornához, add hozzá az AutoPSEO-hoz, küldj tesztüzenetet, és javítsd ki azokat a hibákat, amelyeket a Slack sikertelen küldéskor visszaad.
Az AutoPSEO bejövő webhookokon keresztül küld üzeneteket a Slackbe. A Slack ad egy URL-t, amely egyetlen csatornába ír; ezt az URL-t beilleszted az AutoPSEO-ba, és a jelentések és riasztások onnantól oda érkeznek. Maga az AutoPSEO nem telepít semmit a munkaterületedre: nem tud üzeneteket olvasni, csatornákat listázni, és olyan helyre sem tud küldeni, amelyre a webhook nem mutat. Minden csatornához, amelyben üzeneteket szeretnél látni, vegyél fel egy külön bejegyzést.
A webhook létrehozása a Slackben
A Slack a bejövő webhookokat egy Slack-alkalmazáson keresztül adja ki. A Slack bejövő webhookokról szóló útmutatóját követve:
- Hozz létre egy Slack-alkalmazást a munkaterületedhez, vagy nyiss meg egy olyat, amelyet már használsz értesítésekhez. Válassz olyan nevet, amelyet a csapatod könnyen felismer, például SEO reports.
- Az alkalmazás beállításaiban nyisd meg az Incoming Webhooks menüpontot, és kapcsold be az Activate Incoming Webhooks opciót.
- Kattints az Add New Webhook to Workspace gombra, válaszd ki a csatornát, és hagyd jóvá. Privát csatorna esetén előbb tagnak kell lenned benne.
- Másold ki az új URL-t a Webhook URLs for Your Workspace szakaszból. Az URL így kezdődik:
https://hooks.slack.com/services/.
Minden további csatornához ismételd meg a 3. és a 4. lépést; egy alkalmazás több webhookot is tárolhat. A Slack régebbi, egyéni integrációs webhookjaival létrehozott URL is továbbra is működik, bár a Slack azt javasolja, hogy ezeket költöztesd át alkalmazásba.
A Slack titokként kezeli az URL-t: aki ismeri, az a csatornába írhat. Illeszd be az AutoPSEO-ba, de ne tedd ki jegyekbe, wikikbe vagy képernyőképekre.
Hozzáadás az AutoPSEO-hoz
- A Slack, Teams & Webhooks oldalon keresd meg a Slack - Connected workspaces szakaszt, és kattints az Add to Slack gombra. Megnyílik a New channel űrlap, amelyen a Slack már célként van kiválasztva.
- Name: az AutoPSEO listáiban, a küldési előzményekben és a tesztüzenetben megjelenő címke, például
#seo-alerts. - Webhook URL: illeszd be a Slack URL-t. Slack-bejegyzéshez az AutoPSEO csak a slack.com tartományon lévő
httpscímeket fogadja el, és azonnal jelzi, ha az URL nem felel meg. - Kattints az Add channel gombra, majd az új soron a Send test gombra. Néhány másodpercen belül meg kell jelennie a Slackben egy rövid üzenetnek, amely megnevezi a bejegyzést, az AutoPSEO pedig jelzi, mennyi idő alatt válaszolt a Slack.
Az URL titkosítva tárolódik (AES-GCM). Ezután a lista csak a gazdagépnevét és az utolsó karaktereit mutatja, ezért olyan neveket válassz, amelyekből egyértelmű, hogy az egyes bejegyzések melyik Slack-csatornát szolgálják.
Következő lépésként adj neki valamit, amit küldhet: egy ütemezett jelentést vagy egy riasztást. A lista alatti Slack - Subscriptions táblázat ezután Slack-csatornánként megmutatja az oda küldő szabályokat, azok ütemezését, valamint azt, hogy aktívak vagy szüneteltetve vannak.
Több csatorna és munkaterület
Egy webhook URL egy munkaterület egy csatornájához tartozik, és a Slack nem engedi, hogy egy üzenet felülbírálja azt a csatornát, amelyhez az URL készült. Ez kiszámíthatóvá teszi a működést:
- Egy Slack-csatorna, egy bejegyzés. Ha az ügyfeleket szét szeretnéd osztani a
#client-aés a#client-bcsatorna között, hozz létre mindkettőhöz egy webhookot, és vedd fel mindkettőt. - Több munkaterület ugyanígy működik, mivel minden webhook abban a munkaterületben él, ahol létrehoztad.
- Egy bejegyzés több szabályt is kiszolgálhat. Küldheted a heti jelentést és a forgalomcsökkenési riasztást ugyanarra a bejegyzésre, vagy tarthatod a riasztásokat egy forgalmasabb, külön csatornában.
Miért nem érkezett meg egy üzenet
A Send test azonnal megmutatja az okot. Az ütemezett üzeneteknél nyisd meg a Delivery history nézetet, amely minden sikertelen kísérletnél megőrzi a Slack válaszát.
| Amit az AutoPSEO mutat | Jelentése | Teendő |
|---|---|---|
| Slack rejected the URL (no_service) | A webhookot eltávolították vagy letiltották a Slackben, vagy elgépelték az URL-t | Hozz létre új webhookot, add hozzá, majd töröld a régi bejegyzést |
| The Slack channel no longer exists, or is archived | A Slack channel_not_found vagy channel_is_archived választ adott | Hozz létre webhookot egy még használatban lévő csatornához |
| Slack is rate limiting us | A Slack HTTP 429 választ adott | Várj egy kicsit, majd használd a Send now vagy a Test rule gombot |
| Timed out after 10 seconds | A Slack nem válaszolt időben | Próbáld meg később újra |
| Your trial has ended | Nincs aktív csomag vagy próbaidőszak | Válassz csomagot; az ütemezett küldések ezzel újraindulnak |
A sikertelen ütemezett jelentést az AutoPSEO ugyanabban az időszakban nem küldi el újra, ezért az ok kijavítása után használd a Send now gombot. Az a riasztás, amelyet nem sikerült elküldeni, a következő ellenőrzéskor újra kiértékelődik (mikor futnak a riasztások).
Slack-csatorna eltávolítása
A bejegyzés sorában a Delete eltávolítja a tárolt URL-t, valamint egy megerősítést követően, amely megmondja, hány van belőlük, az összes oda küldő szabályt is. Az AutoPSEO semmit nem módosít a Slackben: a webhook addig működik tovább, amíg valaki nem törli a Slack-alkalmazásban, ezért ha az URL mások szeme elé kerülhetett, ezt is tedd meg.