Dokumentace
Připojení Slacku pomocí příchozího webhooku
Vytvořte ve Slacku příchozí webhook pro kanál, přidejte ho do AutoPSEO, odešlete testovací zprávu a opravte chyby, které Slack vrací při neúspěšném odeslání.
AutoPSEO odesílá zprávy do Slacku pomocí příchozích webhooků. Slack vám vydá URL, které zapisuje do jednoho kanálu, vy ho vložíte do AutoPSEO a reporty i upozornění se začnou objevovat právě tam. AutoPSEO samo ve vašem workspace nic neinstaluje: nemůže číst zprávy, vypisovat vaše kanály ani přispívat jinam, než kam webhook míří. Pro každý kanál, do kterého chcete zprávy posílat, přidejte jednu položku.
Vytvoření webhooku ve Slacku
Slack vydává příchozí webhooky prostřednictvím aplikace Slack. Podle průvodce příchozími webhooky ve Slacku:
- Vytvořte pro svůj workspace aplikaci Slack, nebo otevřete tu, kterou už pro notifikace používáte. Zvolte název, který váš tým pozná, například SEO reporty.
- V nastavení aplikace otevřete Incoming Webhooks a zapněte Activate Incoming Webhooks.
- Klikněte na Add New Webhook to Workspace, vyberte kanál a potvrďte. U soukromého kanálu musíte být nejprve jeho členem.
- V části Webhook URLs for Your Workspace zkopírujte nové URL. Začíná na
https://hooks.slack.com/services/.
Kroky 3 a 4 zopakujte pro každý další kanál; jedna aplikace může obsahovat několik webhooků. Funguje i URL vytvořené pomocí starších vlastních integrací (custom integrations) Slacku, ačkoli Slack doporučuje je převést na aplikaci.
Slack považuje URL za tajný údaj: kdokoli, kdo ho má, může do kanálu psát. Vložte ho do AutoPSEO a nesdílejte ho v ticketech, wiki ani na snímcích obrazovky.
Přidání do AutoPSEO
- Na stránce Slack, Teams & Webhooks najděte Slack - Connected workspaces a klikněte na Add to Slack. Otevře se formulář New channel s předvybraným Slackem jako cílem.
- Name: popisek pro seznamy v AutoPSEO, historii doručení a testovací zprávu, například
#seo-alerts. - Webhook URL: vložte URL ze Slacku. Pro položku Slack AutoPSEO přijímá pouze adresy
httpsna slack.com a pokud URL nevyhovuje, ihned to oznámí. - Klikněte na Add channel a poté na Send test u nového řádku. Během několika sekund by se ve Slacku měla objevit krátká zpráva s názvem položky a AutoPSEO uvede, jak dlouho Slack odpovídal.
URL se ukládá šifrovaně (AES-GCM). Seznam pak zobrazuje pouze jeho hostitele a poslední znaky, proto volte názvy, ze kterých je zřejmé, do kterého kanálu Slacku každá položka míří.
Dále mu dejte, co má odesílat: naplánovaný report nebo upozornění. Tabulka Slack - Subscriptions pod seznamem pak u každého kanálu Slacku ukazuje všechna pravidla, která do něj píšou, jejich plán a zda jsou aktivní, nebo pozastavená.
Více kanálů a workspace
Webhook URL patří jednomu kanálu v jednom workspace a Slack nedovoluje, aby zpráva přepsala kanál, pro který byl webhook vytvořen. Díky tomu je vše předvídatelné:
- Jeden kanál Slacku, jedna položka. Chcete-li rozdělit klienty mezi
#client-aa#client-b, vytvořte pro každý webhook a přidejte oba. - Více workspace funguje stejně, protože každý webhook patří do workspace, ve kterém jste ho vytvořili.
- Jedna položka může obsluhovat mnoho pravidel. Týdenní report i upozornění na pokles návštěvnosti můžete posílat do stejné položky, nebo upozornění vést ve vlastním, rušnějším kanálu.
Proč zpráva nedorazila
Send test ukáže důvod okamžitě. U naplánovaných zpráv otevřete Delivery history, kde se u každého neúspěšného pokusu uchovává odpověď Slacku.
| Co zobrazí AutoPSEO | Co to znamená | Co dělat |
|---|---|---|
| Slack odmítl URL (no_service) | Webhook byl ve Slacku odstraněn nebo vypnut, případně je URL chybně zapsané | Vytvořte nový webhook, přidejte ho a poté starou položku smažte |
| Kanál Slacku už neexistuje nebo je archivovaný | Slack odpověděl channel_not_found nebo channel_is_archived | Vytvořte webhook pro kanál, který se stále používá |
| Slack nás omezuje (rate limiting) | Slack odpověděl HTTP 429 | Chvíli počkejte a pak použijte Send now nebo Test rule |
| Vypršel časový limit 10 sekund | Slack neodpověděl včas | Zkuste to znovu později |
| Vaše zkušební období skončilo | Žádný aktivní tarif ani zkušební období | Zvolte tarif; naplánovaná doručení se s ním obnoví |
Neúspěšný naplánovaný report se ve stejném období neodesílá znovu, proto po odstranění příčiny použijte Send now. Upozornění, které se nepodařilo odeslat, se vyhodnotí znovu při další kontrole (kdy se upozornění spouštějí).
Odebrání kanálu Slacku
Tlačítko Delete na řádku položky odstraní uložené URL a po potvrzení, které uvede jejich počet, také všechna pravidla, jež do ní píšou. AutoPSEO ve Slacku nic nemění: webhook funguje dál, dokud ho někdo neodstraní v aplikaci Slack, takže pokud mohli URL vidět i jiní lidé, odstraňte ho tam také.