LiveBot.cz

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

  1. 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“.
  2. Ve svém účtu LiveBot otevřete Widget / instalace a zkopírujte klíč webu (začíná wb_live_).
  3. 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

  1. V Nastavení → LiveBot zapněte funkce, které má bot používat.
  2. Pod nimi najdete adresu e-shopu a kód pro propojení.
  3. 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_number nebo 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.

Sdílet článek:LinkedInFacebookE-mailem

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.

Vyzkoušet zdarma

Další čtení

Všechny články