Jak připojit Notion

ChatbotIQ čte Notion přes rozhraní Notion API pomocí integrace, kterou si vytvoříte ve vlastním pracovním prostoru. To má dva důvody:

Sami určujete, co je čitelné. Integrace v Notionu vidí jen stránky a databáze, které s ní výslovně nasdílíte. Nic jiného v pracovním prostoru není dostupné a seznam toho, co jste vybrali, se vynucuje i na serveru.
Synchronizace zůstává levná. Notion u každé stránky hlásí čas poslední úpravy, takže opakovaná synchronizace načte jen stránky, které někdo skutečně změnil.

Než začnete

Budete potřebovat:

Pracovní prostor Notion, ve kterém můžete vytvářet integrace. U placených plánů to obvykle znamená vlastníka pracovního prostoru nebo člena s oprávněním k integracím; osobní pracovní prostory fungují také.
Roli administrátora nebo vlastníka ve workspace ChatbotIQ.

Krok 1: Vytvořte interní integraci

Otevřete integrace Notionu a klikněte na New integration.
Pojmenujte ji (například ChatbotIQ), zvolte pracovní prostor a ponechte typ Internal.
V části Capabilities ponechte pouze Read content. Vypněte Update content, Insert content a komentáře. U uživatelských oprávnění zvolte No user information.
Uložte a zkopírujte Internal Integration Secret. Začíná na ntn_.

Tajné klíče Notionu nevyprší. Není co obnovovat. Pokud by klíč kdy unikl, stiskněte na stránce integrace Refresh, čímž ho zneplatníte, a v ChatbotIQ se připojte znovu s novým.

Krok 2: Nasdílejte stránky s integrací

Integrace může číst jen to, co s ní nasdílíte. V Notionu otevřete každou stránku nebo databázi nejvyšší úrovně, kterou chcete indexovat, klikněte na nabídku …, zvolte Connections a přidejte svou integraci.

Nasdílení stránky nasdílí i všechny její podstránky v libovolné hloubce.
Sdílejte jen to, z čeho má bot odpovídat. Pokud je bot veřejný, nesdílejte HR, právní ani jiné interní stránky.

Krok 3: Připojte pracovní prostor

V ChatbotIQ otevřete Znalostní bázi a klikněte na Přidat zdroj.
Zvolte Notion.
Vložte tajný klíč integrace a klikněte na Připojit.

ChatbotIQ klíč okamžitě ověří. Pokud je špatný, uvidíte chybu hned, ne až prázdnou synchronizaci později.

Klíč je před uložením zašifrován a žádná obrazovka ani odpověď API ChatbotIQ ho už nikdy nezobrazí. Uvidíte jen poslední čtyři znaky.

Krok 4: Vyberte stránky a databáze a spusťte synchronizaci

Po připojení uvidíte stránky a databáze nasdílené s integrací.

Vyberte stránky nejvyšší úrovně, které chcete indexovat. Jejich podstránky se přidají automaticky.
Databáze vybírejte výslovně. Databáze se indexují po řádcích a nikdy se nezahrnou jen proto, že leží uvnitř vybrané stránky. Díky tomu se omylem nezaindexuje tabulka s 5 000 řádky.
U velkých pracovních prostorů použijte vyhledávání. Pokud jste něco právě nasdíleli a ještě to v seznamu není, chvíli počkejte a klikněte na Obnovit: vyhledávací index Notionu se za sdílením může o minutu opožďovat.

Pojmenujte zdroj a klikněte na Spustit synchronizaci. První synchronizace načte všechny vybrané stránky; průvodce můžete zavřít a synchronizace pokračuje na pozadí.

Co se indexuje

U každé stránky ChatbotIQ ukládá název, obsah a její umístění v pracovním prostoru:

Stránky a podstránky v libovolné hloubce, včetně stránek vnořených v rozbalovacích blocích, sloupcích a seznamech.
Řádky databází, které jste vybrali. Každý řádek je jedna stránka: jeho vlastnosti (stav, data, výběry, čísla, odkazy) a za nimi vlastní obsah řádku.
Obrázky. Obrázkové bloky se při synchronizaci stáhnou a zobrazují se v odpovědích, pokud má bot zapnuté obrázky v odpovědích.
Hierarchie stránek jako drobečková navigace (Pracovní prostor > Engineering > Runbooky > Nasazení), která zlepšuje párování otázek se stránkami.
Skutečné odkazy na Notion, takže odpovědi citují klikatelnou stránku.
Čas poslední úpravy z Notionu, ne čas synchronizace.

Nadpisy, seznamy, úkoly, rozbalovací bloky, upozornění, citace, bloky kódu, tabulky, sloupce a synchronizované bloky zůstávají zachovány. Neindexují se: přílohy typu soubor, PDF, video a audio (jen jejich název nebo popisek), komentáře, stránky, které nebyly nasdíleny, a řádky databází, které jste nevybrali. Stránka, která obsahuje jen odkazy na podstránky, se přeskočí; její podstránky se indexují samostatně.

Udržování obsahu aktuálního

Synchronizaci spusťte, kdykoli chcete načíst změny, nebo ji nechte na plánované aktualizaci, kterou váš plán zahrnuje. Opakované synchronizace jsou levné: ChatbotIQ porovná čas poslední úpravy každé stránky a znovu načte jen změněné stránky. Synchronizace nezměněného pracovního prostoru nespotřebuje žádné indexovací kredity.

Stránky, které byly smazány, přesunuty do koše, odsdíleny od integrace nebo přesunuty mimo všechny vybrané stránky, se z odpovědí bota odstraní při další synchronizaci.

Řešení problémů

„Notion odmítl tajný klíč integrace“ Klíč byl obnoven nebo byla integrace z pracovního prostoru odebrána. Zkopírujte aktuální klíč ze stránky integrace a připojte se znovu.

„Notion odepřel přístup“ Buď integraci chybí oprávnění Read content, nebo je pracovní prostor na bezplatném plánu Notionu a překročil limit bloků, který Notion vynucuje i v API. Opravte oprávnění v nastavení integrace, nebo pracovní prostor Notion povyšte.

„Tohle nevypadá jako tajný klíč integrace Notionu“ Vložte klíč ze stránky integrace (začíná na ntn_), ne URL stránky ani API klíč odjinud.

Stránka v seznamu chybí Nebyla nasdílena s integrací. Nasdílejte ji v Notionu, chvíli počkejte a klikněte na Obnovit.

Chybí řádky databáze Vyberte v seznamu samotnou databázi. Řádky se nikdy neindexují přes nadřazenou stránku.

Stránka se zobrazí, ale nemá obsah Stránky, které obsahují jen odkazy na jiné stránky, se záměrně přeskakují. Odkazované stránky se indexují samostatně.