Návody a tipy9. listopadu 20265 min čtení
Plugin LiveBot pro WordPress: instalace, e-shop a nápověda
Plugin vloží chat na web s WordPressem bez úprav šablony. U WooCommerce zjistí stav objednávky, pošle odkaz na sledování zásilky a dohledá zboží. Instalace, nastavení a filtry pro vývojáře.
Napsal LiveBot
Plugin LiveBot vloží okno chatu na web s WordPressem bez úprav šablony. U e-shopu s WooCommerce navíc umí zjistit zákazníkovi stav objednávky, poslat mu odkaz na sledování zásilky a dohledat zboží. Každou funkci zapnete zvlášť a bot dostane jen to, co povolíte.
Instalace
- Stáhněte plugin (ZIP). V administraci WordPressu otevřete Pluginy → Přidat nový → Nahrát plugin, vyberte stažený soubor, nainstalujte a aktivujte. Plugin čeká na schválení v adresáři WordPress.org; potom ho najdete i přímo ve WordPressu pod názvem „LiveBot“.
- Ve svém účtu LiveBot otevřete Widget / instalace a zkopírujte klíč
webu (začíná
wb_live_). - Ve WordPressu otevřete Nastavení → LiveBot, vložte klíč, zaškrtněte Zobrazit okno chatu na webu a uložte.
Doménu webu musíte mít povolenou ve svém účtu LiveBot (Widget / instalace → Povolené domény), jinak se okno chatu nezobrazí.
Přecházíte z ručního kódu? Ruční <script … widget.js> ze šablony nebo
z pluginu na vkládání kódů můžete odstranit. Když tam zůstane, chat se
zobrazí jen jednou — druhé vložení se přeskočí.
Nastavení
| Volba | Co dělá |
|---|---|
| Klíč webu | Propojí plugin s vaším účtem LiveBot. |
| Okno chatu | Dokud ho nezapnete, plugin na web nic nenačítá. |
| Jazyk | Jazyk ovládání okna. Automaticky = podle jazyka stránky. Bot odpovídá v jazyce, ve kterém návštěvník píše. |
| Košík a pokladna | Jen s WooCommerce: okno chatu se v košíku a pokladně nezobrazí. |
Administrace pluginu je česky, když má WordPress (nebo váš uživatel) nastavenou češtinu, jinak anglicky.
Funkce e-shopu (WooCommerce)
Každou funkci zapnete a vypnete zvlášť; výchozí stav je vypnuto. Vypnutá funkce botovi nedá žádná data, a to okamžitě.
| Funkce | Co bot dostane | Kdy |
|---|---|---|
| Stav objednávky | číslo, stav (název stavu z WooCommerce), datum, částka, měna, způsob dopravy | jen když zákazník zadá číslo objednávky i e-mail, na který objednával |
| Sledování zásilky | dopravce, číslo zásilky, odkaz na sledování | jako stav objednávky |
| Hledání zboží | název, cena, měna, dostupnost, kategorie, odkaz | veřejné údaje, bez ověření |
Adresu, telefon ani položky objednávky bot nikdy nedostane. Nenalezená objednávka a nesouhlasící e-mail vypadají stejně — přes bota nejde zjišťovat, která čísla objednávek existují.
Propojení s LiveBotem
- V Nastavení → LiveBot zapněte funkce, které má bot používat.
- Pod nimi najdete adresu e-shopu a kód pro propojení.
- V účtu LiveBot otevřete Napojení na systémy, zvolte šablonu „WordPress – plugin LiveBot“, vložte adresu a kód a potvrďte.
Kód je jako heslo — nikomu ho nedávejte. Tlačítkem Vytvořit nový kód pro propojení ho vyměníte; starý tím přestane platit a nový je potřeba vložit do LiveBotu.
Napojení na systémy je v tarifech Plus, Pro a Enterprise.
Co plugin čte
Jen standardní data WooCommerce:
- objednávku podle čísla, které vidí zákazník — i s vlastním číslováním
z pluginů, které číslo ukládají do
_order_numbernebo ho zapojují do hledání objednávek v administraci WooCommerce; - název stavu tak, jak ho zobrazuje WooCommerce;
- zásilky z oficiálního rozšíření Shipment Tracking a z Advanced Shipment Tracking;
- zboží přes
wc_get_products()(jen publikované a viditelné ve vyhledávání).
Cokoli dalšího — jiný plugin dopravce, vlastní číslování, doplňující údaje — se připojí filtry (níže).
Filtry pro vývojáře
Kód patří do šablony (functions.php podřazené šablony) nebo do vlastního
pluginu, ne do souborů pluginu LiveBot — ty se při aktualizaci přepíšou.
livebot_order_tracking — zásilky z pluginu dopravce
/**
* Příklad: plugin dopravce ukládá číslo zásilky do metadat objednávky.
* Název metadat a adresu sledování zjistěte v dokumentaci svého pluginu.
*/
add_filter( 'livebot_order_tracking', function ( $zasilky, $order ) {
$cislo = $order->get_meta( '_moje_cislo_zasilky' );
if ( $cislo ) {
$zasilky[] = array(
'carrier' => 'PPL',
'number' => $cislo,
'url' => 'https://www.ppl.cz/vyhledat-zasilku?shipmentId=' . rawurlencode( $cislo ),
);
}
return $zasilky;
}, 10, 2 );
Plugin z výsledku vezme nejvýš tři zásilky a jen pole carrier, number
a url.
livebot_find_order — vlastní číslování objednávek
add_filter( 'livebot_find_order', function ( $order, $cislo ) {
if ( $order ) {
return $order; // standardní hledání už objednávku našlo
}
$nalezene = wc_get_orders( array(
'limit' => 2,
'meta_key' => '_moje_cislo_objednavky',
'meta_value' => $cislo,
) );
return 1 === count( $nalezene ) ? $nalezene[0] : null;
}, 10, 2 );
Shoda e-mailu se ověří vždy až potom — filtr ji obejít nemůže.
livebot_order_data — údaje objednávky pro bota
add_filter( 'livebot_order_data', function ( $udaje, $order ) {
$udaje['delivery_date'] = $order->get_meta( '_termin_doruceni' );
return $udaje;
}, 10, 2 );
Pole number a email filtr přepsat nesmí (podle nich LiveBot ověřuje
shodu). Přidané pole bot uvidí, až si ho v portálu u akce „Stav objednávky“
doplníte do mapování odpovědi (např. klíč doruceni, cesta delivery_date).
livebot_product_search_args — dotaz na zboží
add_filter( 'livebot_product_search_args', function ( $args, $request ) {
$args['stock_status'] = 'instock'; // nabízet jen zboží skladem
return $args;
}, 10, 2 );
Plugin vždy vynutí jen publikované zboží a strop počtu výsledků.
livebot_product_data — údaje o zboží
add_filter( 'livebot_product_data', function ( $polozka, $product ) {
if ( has_term( 'velkoobchod', 'product_cat', $product->get_id() ) ) {
return false; // tohle zboží bot nenabízí
}
$polozka['delivery'] = $product->get_meta( '_dodaci_lhuta' );
return $polozka;
}, 10, 2 );
livebot_show_widget — kde se okno chatu zobrazí
add_filter( 'livebot_show_widget', function ( $zobrazit ) {
return is_page( 'akce-black-friday' ) ? false : $zobrazit;
} );
Řešení potíží
| Potíž | Co zkontrolovat |
|---|---|
| Okno chatu se nezobrazí | Klíč vyplněný, „Zobrazit okno chatu“ zaškrtnuté, doména povolená v LiveBotu, vyčištěná mezipaměť pluginu na cache/optimalizaci. |
| Bot neříká stav objednávky | Funkce zapnutá v pluginu, v LiveBotu propojená šablona se správným kódem, tarif Plus a vyšší. Zákazník musí zadat e-mail, na který objednával. |
| Napojení hlásí „Systém odmítl přístupové údaje“ | Kód pro propojení v LiveBotu neodpovídá kódu v pluginu (byl vytvořen nový). |
| Zkušební volání hlásí „Funkce je v systému vypnutá“ | Funkce je v pluginu vypnutá. Bot zákazníkovi nabídne jinou cestu (kontakt, operátora). |
| Chyba při volání | Web musí mít HTTPS a funkční /wp-json/; bezpečnostní pluginy nebo firewall (Cloudflare) ho někdy blokují. |
| Sledování zásilky je prázdné | Plugin dopravce ukládá zásilky po svém — připojte ho filtrem livebot_order_tracking. |
Odinstalace
Při smazání pluginu se odstraní jeho nastavení i kód pro propojení. Data v účtu LiveBot zůstávají; účet se ruší zvlášť na livebot.cz.
Chcete takového asistenta na svém webu?
LiveBot odpovídá z vašich podkladů a když je potřeba, předá konverzaci člověku. Nasazení je jeden řádek kódu.

