Začíname

Katalóg produktov

Otto odpovedá o produktoch len z toho, čo má v katalógu. Ten naplníte XML feedom, feedom z WooCommerce, cez API, alebo si Otto prečíta váš web.

Štyri spôsoby

Spôsob	Kedy sa hodí	Obnova
XML feed	Máte feed pre Heureku, Zboží alebo Google.	Sám, keď je starší ako 5 hodín
Feed z WooCommerce	Máte WordPress s WooCommerce a doplnok Otto.	Ako XML feed
API katalógu	Katalóg máte v ERP alebo vlastnom systéme.	Keď pošlete zmenu
Čítanie webu	Feed nemáte, napríklad web so službami.	Raz za 7 dní

XML feed

V paneli otvorte Nastavenia, časť Katalóg, a vložte adresu feedu. Tlačidlom Overiť feed ho vyskúšate ešte pred uložením: panel povie, koľko produktov našiel a v akej mene. Otto si feed potom načíta znova vždy, keď je starší ako 5 hodín. Zmenu hneď prenesiete tlačidlom Aktualizovať katalóg.

Časť Katalóg v nastaveniach panela Otta s adresou feedu — Adresa feedu v Nastaveniach, časť Katalóg.

Otto rozumie dvom formátom. Ostatné prvky ignoruje, feed teda netreba upravovať.

Údaj	Heureka, Zboží (`<SHOP><SHOPITEM>`)	Google Merchant (`<rss><item>`)
Id	`ITEM_ID`, inak `PRODUCTNO`, `EAN` alebo `URL`	`g:id`
Názov	`PRODUCTNAME` alebo `PRODUCT`	`title`
Popis	`DESCRIPTION`	`description`
Odkaz a obrázok	`URL`, `IMGURL`	`link`, `g:image_link`
Cena	`PRICE_VAT`, inak `PRICE`	`g:price`, platná akcia `g:sale_price` s `g:sale_price_effective_date`
Dostupnosť	`DELIVERY_DATE`: 0 je skladom, číslo sú dni, dátum je termín	`g:availability`: `in_stock`, `out_of_stock`, `preorder`, `backorder`
Kategória a značka	`CATEGORYTEXT`, `MANUFACTURER`	`g:product_type`, `g:brand`
Parametre	`PARAM` s `PARAM_NAME` a `VAL`	nie

Menu Otto vezme z ceny, keď je pri nej kód (napríklad 12.90 EUR vo feede Google). Inak platí nastavenie Mena cien v paneli, a keď nie je ani to, mena podľa domény feedu (.cz je CZK, inak EUR).

Vypredané produkty vo feede nechajte so správnou dostupnosťou. Otto ich zákazníkom neponúkne ako dostupné, ale vie povedať, že ich momentálne nemáte.

Feed z WooCommerce

Doplnok Otto pre WordPress zverejní feed produktov na /wp-json/otto-chat/v1/feed. Jeho adresu skopírujete v nastaveniach doplnku a vložíte ju do Katalógu ako bežný feed. Viac v časti WordPress a WooCommerce.

Katalóg cez API

Keď katalóg spravujete vo vlastnom systéme, pošlite ho Ottovi cez API. Tieto tri adresy fungujú na každom pláne, nahrádzajú XML feed. Produkt má povinné len id a title.

POST /api/v1/products

{
  "products": [
    {
      "id": "1042",
      "title": "Espresso zmes Domáca 250 g",
      "description": "Zrnková káva, 70 % arabika, tóny čokolády a orieškov.",
      "url": "https://vas-obchod.sk/espresso-domaca",
      "image": "https://vas-obchod.sk/obrazky/espresso-domaca.jpg",
      "price": 12.9,
      "currency": "EUR",
      "availability": "skladom",
      "category": "Káva > Zrnková káva",
      "manufacturer": "Pražiareň Príklad",
      "params": { "Hmotnosť": "250 g", "Pôvod": "Brazília, Kolumbia" }
    }
  ]
}

Adresa	Čo robí	Limit
`POST /api/v1/products/snapshot`	Celý katalóg. Čo v ňom nie je, sa zmaže.	5000 produktov, 12× za hodinu
`POST /api/v1/products`	Len poslané produkty, nič sa nemaže. Na zmenu ceny alebo skladu.	500 produktov naraz
`DELETE /api/v1/products/<id>`	Zmaže jeden produkt podľa vášho id.

Keď v snapshot pošlete oveľa menej produktov, než Otto má, nezmaže nič a v odpovedi vráti warning s errcode: "prune_skipped". Je to poistka proti rozbitému exportu. Ak je menší katalóg správny, pošlite ho ešte raz.

Čítanie webu

Ak feed nemáte, zapnite v Katalógu prepínač Nemám XML feed, Otto si prečíta môj web a zadajte adresu webu. Web sa dá prečítať, až keď na ňom beží chat, tak overíme, že je váš. Otto si ho potom prečíta znova raz za 7 dní. Aj s feedom si raz za týždeň prečíta stránky webu, aby vedel odpovedať na otázky o doprave, platbe a firme.