Bővítmény dokumentáció

EchoAI WordPress-hez

Adj chat asszisztenst a WordPress oldaladhoz percek alatt. Programozás nem kell hozzá.

Telepítés

Telepítsd a bővítményt a WordPress oldaladra.

A bővítménytárból

1
Keresd meg az EchoAI-t

A WordPress adminban menj a Bővítmények > Új hozzáadása menüpontba, és keress rá az „EchoAI”-ra.

2
Telepítés és aktiválás

Kattints a Telepítés, majd az Aktiválás gombra. A bővítmény menüje megjelenik az oldalsávban.

Manuális feltöltés

Töltsd le a zip fájlt, menj a Bővítmények > Új hozzáadása > Bővítmény feltöltése menüpontba, válaszd ki a fájlt, és aktiváld.

Követelmények

Követelmény Minimum
WordPress 5.9+
PHP 7.4+
Tárhely Nyilvánosan elérhető localhost nem
Fiók Ingyenes: app.echoaichat.com
A localhost nem támogatott
Az EchoAI-nak el kell érnie az oldaladat az interneten keresztül, hogy beolvassa a tartalmat. Helyi (csak a saját gépeden futó) WordPress ezért nem működik.

Beállítás és csatlakozás

Az aktiválás után csatlakoztasd a WordPress oldaladat az EchoAI-hoz. Menj az EchoAI > Beállítás menüpontba.

A lehetőség: Csatlakozás az EchoAI-jal (ajánlott)

1
Kattints a Csatlakozás gombra

Kattints a „Csatlakozás az EchoAI-jal” gombra — átirányítunk az EchoAI platformra.

2
Hozz létre vagy válassz asszisztenst

Jelentkezz be, hozz létre egy új asszisztenst vagy válassz egy meglévőt, és hagyd jóvá a WordPress-kapcsolatot.

3
Megerősítés

Visszairányítunk a WordPressbe. Kattints az „Asszisztens megerősítése” gombra — és kész.

B lehetőség: Meglévő asszisztens-azonosító használata

Már van asszisztensed? Másold ki az azonosítóját az EchoAI vezérlőpultról, illeszd be a „Meglévő asszisztens használata” mezőbe, és kattints a „Validálás és mentés” gombra.

Csatlakozva!
A csatlakozás után a lebegő chat gomb automatikusan bekapcsol, és a tartalmad szinkronizálása megkezdődik a tudásbázisba.

Lebegő gomb

Egy chat gomb, amely az oldalad minden lapján megjelenik. A beállítás után alapértelmezetten aktív.

Beállítás Alapértelmezett Leírás
Pozíció bottom_right Sarokba helyezés — válassz a 4 pozíció közül, vagy kapcsold ki teljesen
Ikon EchoAI ikon Egyéni kép a WordPress médiatárból
Tooltip „Get quick answers…” Egérrel rámutatva megjelenő szöveg, 5–120 karakter
Méret 350 x 500 px A chat felugró ablak méretei

A testreszabáshoz menj az EchoAI > Konfiguráció menüpontba. A kikapcsoláshoz válaszd a „Nincs lebegő gomb” opciót a pozícióválasztóban. Mindezt kattintással állítod be – kódot nem kell írnod.

Programozott lebegő gomb (fejlesztőknek)
Ha kódból, a WordPress bővítmény nélkül szeretnél lebegő gombot beágyazni, a floatingButton opciókat és a JavaScript-példát a SDK integrációs útmutató — Lebegő gomb szakaszában találod.

Gutenberg blokk

Ágyazd be a chatet közvetlenül bármelyik oldalba vagy bejegyzésbe a blokkszerkesztővel.

1
Blokk hozzáadása

A blokkszerkesztőben keress rá az „EchoAI Chat” blokkra (a Widgetek alatt).

2
Beállítás

A blokk beállításainál állítsd be a magasságot és a háttérszínt, és szükség esetén írd felül az asszisztens-azonosítót.

Attribútum Típus Alapértelmezett Leírás
height number 450 A konténer magassága pixelben (200–1000)
backgroundColor string #fafafa A chat konténer háttérszíne
assistantId Optional string Az alapértelmezett asszisztens-azonosító felülírása
Több asszisztens
Az assistantId attribútummal különböző asszisztenseket futtathatsz a különböző oldalakon — például értékesítési asszisztenst a termékoldalakon, támogatási asszisztenst a súgóban.

Shortcode

Használd az [echo_ai] shortcode-ot bármelyik bejegyzésben, oldalon vagy widget területen.

Shortcode
[echo_ai]
Paraméter Alapértelmezett Leírás
height 400 A konténer magassága pixelben
backgroundcolor #fafafa Háttérszín (hex, rgb vagy elnevezett szín)
assistant_id Az alapértelmezett asszisztens-azonosító felülírása

Példák

Shortcode
[echo_ai height="600" backgroundcolor="#ffffff"]

[echo_ai assistant_id="12345ABCDE" height="500"]

Beállítások

Minden beállítást az EchoAI > Konfiguráció menüpontban találsz a WordPress adminban.

Asszisztens beállításai

Beállítás Leírás
Asszisztens-azonosító A csatlakoztatott asszisztensed azonosítója. Módosítsd, ha másik asszisztensre váltanál — mentés előtt ellenőrizzük az azonosítót.
Asszisztens beállításai Megnyitja az asszisztensedet az EchoAI platformon, ahol beállíthatod a személyiségét, az üdvözlő üzenetét és az irányelveit.

Lebegő gomb beállításai

A lebegő gomb pozícióját, ikonját, tooltipjét és méretét ugyanitt, a Konfiguráció oldalon állítod. A teljes beállítás-táblázatot fentebb, a Lebegő gomb szakaszban találod.

Tartalom integráció

Válaszd ki, mely bejegyzéstípusok kerüljenek be az asszisztens tudásába. A listában csak a nyilvánosan elérhető bejegyzéstípusok jelennek meg.

BejegyzéstípusAlapértelmezett
Bejegyzések (posts)Bekapcsolva
Oldalak (pages)Bekapcsolva
WooCommerce-termékekVálasztható
Egyéni bejegyzéstípusokVálasztható, ha nyilvános
WooCommerce-kompatibilis
A WooCommerce-termékek és a legtöbb egyéni bejegyzéstípus is választható, így a webshopod kínálatát is megtanulhatja az asszisztens.

Tartalom szinkronizálása

A tartalmad automatikusan szinkronizálódik a tudásbázisba webhookokon keresztül, valahányszor közzéteszel, módosítasz vagy törölsz egy bejegyzést.

Hogyan működik

TulajdonságÁllapotMit jelent
Automatikus szinkronBekapcsolvaMinden bejegyzés mentésekor másodperceken belül átküldjük a tartalmat az EchoAI-nak, neked nem kell semmit indítanod.
Csak a fontosat küldjükSzűrtCsak az engedélyezett bejegyzéstípusok szinkronizálódnak.
PiszkozatbiztosBekapcsolvaAz automatikus piszkozatokat és a korábbi verziókat kihagyjuk; csak a közzétett tartalom megy át.

Mi szinkronizálódik és mi nem

TartalomSzinkronRészletek
A bejegyzés tartalmaIgenCím, szövegtörzs, szerző, dátum, permalink
Kiemelt képIgenAutomatikusan felismerve a bélyegképekből, a blokkokból vagy a tartalomból
TaxonómiákIgenKategóriák, címkék és egyéni taxonómiák egyszerű címkékként
Piszkozat vagy privát tartalomNemCsak a közzétett tartalom megy át
Jelszóval védett bejegyzésekNemKimaradnak a szinkronból
Felhasználói belépési adatok vagy admin adatokNemSoha nem küldjük át

Hibaelhárítás

Gyakori problémák és a megoldásuk.

„EchoAI is not functional on localhost”

Az EchoAI-nak el kell érnie az oldaladat az interneten keresztül. Helyi (csak a saját gépeden futó) WordPresszel ez nem megy – tedd ki egy nyilvánosan elérhető tárhelyre.

„Could not validate your Assistant ID”

  • Ellenőrizd az internetkapcsolatodat
  • Ellenőrizd, hogy az asszisztens-azonosító létezik-e az app.echoaichat.com oldalon
  • Ez csak figyelmeztetés — a mentett azonosítód megmarad

A lebegő gomb nem jelenik meg

  • Nézd meg az EchoAI > Konfiguráció menüt — a pozíció nem lehet „Nincs lebegő gomb”
  • Ellenőrizd, hogy van-e csatlakoztatott asszisztens
  • Nézd meg a böngésző konzolját, nincs-e SDK-hiba

A tartalom nem szinkronizálódik

  • Ellenőrizd, hogy a bejegyzéstípus be van-e pipálva az EchoAI > Konfiguráció > Tartalom integráció alatt
  • Ha egy egyéni bejegyzéstípus nem jelenik meg a listában, az általában azt jelenti, hogy az adott típus nincs nyilvánosan elérhetővé téve
  • Csak a közzétett tartalom szinkronizálódik — a piszkozatokat kihagyjuk
  • Sok bejegyzés egyszerre? Ilyenkor érdemes az EchoAI platformon kézzel elindítani a szinkronizálást

Hibakereső mód (haladó)

Ha a fentiek nem segítettek, és fejlesztői segítséget szeretnél, bekapcsolhatod a részletes naplózást a WordPress beállítófájljában:

PHP
// Enable debug mode in wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

// Then visit:
// admin.php?page=echoai_setup&debug=1

Ez naplózza az API-kéréseket és -válaszokat a wp-content/debug.log fájlba, és eltárolja az utolsó 10 hibát a bővítmény beállításai között.

Segítségre van szükséged?
Látogass el az EchoAI vezérlőpultra, vagy fordulj a támogatáshoz, ha segítség kell az integrációhoz.