Začínáme

Katalog produktů

Otto odpovídá o produktech jen z toho, co má v katalogu. Ten naplníte XML feedem, feedem z WooCommerce, přes API, nebo si Otto přečte váš web.

Čtyři způsoby

Způsob	Kdy se hodí	Obnova
XML feed	Máte feed pro Heureku, Zboží nebo Google.	Sám, když je starší než 5 hodin
Feed z WooCommerce	Máte WordPress s WooCommerce a doplněk Otto.	Jako XML feed
API katalogu	Katalog máte v ERP nebo vlastním systému.	Když pošlete změnu
Čtení webu	Feed nemáte, třeba web se službami.	Jednou za 7 dní

XML feed

V panelu otevřete Nastavení, část Katalog, a vložte adresu feedu. Tlačítkem Ověřit feed ho vyzkoušíte ještě před uložením: panel řekne, kolik produktů našel a v jaké měně. Otto si feed pak načte znovu vždy, když je starší než 5 hodin. Změnu hned přenesete tlačítkem Aktualizovat katalog.

Část Katalog v nastavení panelu Otta s adresou feedu — Adresa feedu v Nastavení, část Katalog.

Otto rozumí dvěma formátům. Ostatní prvky ignoruje, feed tedy netřeba upravovat.

Údaj	Heureka, Zboží (`<SHOP><SHOPITEM>`)	Google Merchant (`<rss><item>`)
Id	`ITEM_ID`, jinak `PRODUCTNO`, `EAN` nebo `URL`	`g:id`
Název	`PRODUCTNAME` nebo `PRODUCT`	`title`
Popis	`DESCRIPTION`	`description`
Odkaz a obrázek	`URL`, `IMGURL`	`link`, `g:image_link`
Cena	`PRICE_VAT`, jinak `PRICE`	`g:price`, platná akce `g:sale_price` s `g:sale_price_effective_date`
Dostupnost	`DELIVERY_DATE`: 0 je skladem, číslo jsou dny, datum je termín	`g:availability`: `in_stock`, `out_of_stock`, `preorder`, `backorder`
Kategorie a značka	`CATEGORYTEXT`, `MANUFACTURER`	`g:product_type`, `g:brand`
Parametry	`PARAM` s `PARAM_NAME` a `VAL`	ne

Měnu Otto vezme z ceny, když je u ní kód (třeba 12.90 EUR ve feedu Google). Jinak platí nastavení Měna cen v panelu, a když není ani to, měna podle domény feedu (.cz je CZK, jinak EUR).

Vyprodané produkty ve feedu nechte se správnou dostupností. Otto je zákazníkům nenabídne jako dostupné, ale umí říct, že je momentálně nemáte.

Feed z WooCommerce

Doplněk Otto pro WordPress zveřejní feed produktů na /wp-json/otto-chat/v1/feed. Jeho adresu zkopírujete v nastavení doplňku a vložíte ji do Katalogu jako běžný feed. Více v části WordPress a WooCommerce.

Katalog přes API

Když katalog spravujete ve vlastním systému, pošlete ho Ottovi přes API. Tyto tři adresy fungují na každém plánu, nahrazují XML feed. Produkt má povinné jen 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	Co dělá	Limit
`POST /api/v1/products/snapshot`	Celý katalog. Co v něm není, se smaže.	5000 produktů, 12× za hodinu
`POST /api/v1/products`	Jen poslané produkty, nic se nemaže. Na změnu ceny nebo skladu.	500 produktů najednou
`DELETE /api/v1/products/<id>`	Smaže jeden produkt podle vašeho id.

Když v snapshot pošlete mnohem méně produktů, než Otto má, nesmaže nic a v odpovědi vrátí warning s errcode: "prune_skipped". Je to pojistka proti rozbitému exportu. Pokud je menší katalog správný, pošlete ho ještě jednou.

Čtení webu

Pokud feed nemáte, zapněte v Katalogu přepínač Nemám XML feed, Otto si přečte můj web a zadejte adresu webu. Web jde přečíst, až když na něm běží chat, tak ověříme, že je váš. Otto si ho pak přečte znovu jednou za 7 dní. I s feedem si jednou týdně přečte stránky webu, aby uměl odpovídat na otázky o dopravě, platbě a firmě.