Bővítmény dokumentáció

EchoAI WordPress-hez

Adj AI chat asszisztenst a WordPress oldaladhoz percek alatt. Kódolás nem szükséges.

Bővítmény telepítése Beállítások

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ő (nem localhost)
Fiók Ingyenes: app.echoaichat.com
Localhost nem támogatott
Az EchoAI-nak el kell érnie az oldalad REST API-ját az interneten keresztül. Helyi fejlesztői környezet nem működik.

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

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

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

1
Kattints a Csatlakozás-ra

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

2
Asszisztens létrehozása vagy kiválasztása

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 — 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 dashboardró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 aktiválódik, és a tartalmad szinkronizálása megkezdődik az AI 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 Sarok elhelyezés — válassz 4 pozícióból, vagy tiltsd le teljesen
Ikon EchoAI ikon Egyéni kép a WordPress médiatárból
Tooltip "Get quick answers..." Egérmutató szöveg, 5–120 karakter
Méret 350 x 500px Chat felugró ablak méretei

A testreszabáshoz menj az EchoAI > Konfiguráció menüpontba. A letiltáshoz válaszd a „Nincs lebegő gomb" opciót a pozíció választóban.

JavaScript 
new EchoSDK({
  assistantIdentifier: 'your-assistant-id',
  floatingButton: {
    enabled: true,
    position: 'bottom_right',
    icon: 'https://your-site.com/icon.svg',
    tooltip: 'Get quick answers',
    width: 350,
    height: 500
  }
});

Gutenberg blokk

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

1
Blokk hozzáadása

A blokk szerkesztőben keress rá az „EchoAI Chat"-ra (a Widgetek alatt).

2
Beállítás

Használd a blokk inspektort a magasság, háttérszín beállításához, és opcionálisan az asszisztens azonosító felülírásához.

Attribútum Típus Alapértelmezett Leírás
height number 450 Konténer magasság 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
Használd az assistantId attribútumot különböző asszisztensek futtatásához különböző oldalakon — értékesítési bot a termékoldalakon, támogatási bot a súgóban.

Shortcode

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

Shortcode 
[echo_ai]
Paraméter Alapértelmezett Leírás
height 400 Konténer magasság pixelben
backgroundcolor #fafafa Háttérszín (hex, rgb vagy elnevezett)
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ás az EchoAI > Konfiguráció menüpontban található a WordPress adminban.

Asszisztens beállítások

Beállítás Leírás
Asszisztens azonosító A csatlakoztatott asszisztensed. Módosítsd az asszisztens váltásához — az azonosító mentés előtt validálásra kerül.
AI asszisztens beállítások Megnyitja az asszisztensedet az EchoAI platformon a személyiség, üdvözlés és utasítások konfigurálásához.

Lebegő gomb beállítások

Beállítás Leírás
Gomb pozíció Vizuális rács 4 sarok opcióval, vagy „Nincs lebegő gomb" a letiltáshoz.
Gomb ikon Válassz egyéni ikont a WordPress médiatárból. 48x48 előnézetet mutat.
Tooltip szöveg Egérmutató szöveg (5–120 karakter). Alapértelmezett: "Get quick answers from { site name }".

Tartalom integráció

Válaszd ki, mely bejegyzéstípusok szinkronizálódjanak az AI tudásbázisba. Csak a REST API-val rendelkező nyilvános típusok jelennek meg. Alapértelmezett: Bejegyzések és Oldalak.

WooCommerce kompatibilis
A WooCommerce termékek és minden egyéni bejegyzéstípus show_in_rest beállítással opcióként megjelenik.

Tartalom szinkronizáció

A tartalmad automatikusan szinkronizálódik az AI tudásbázisba webhookokon keresztül, valahányszor közzéteszel, frissítesz vagy törölsz egy bejegyzést.

Hogyan működik

  • Automatikus — Minden bejegyzés mentésekor egy webhook indul másodperceken belül
  • Intelligens szűrés — Csak az engedélyezett, REST API-val rendelkező bejegyzéstípusok szinkronizálódnak
  • Piszkozat-biztos — Az automatikus piszkozatok és verziók figyelmen kívül maradnak, csak a közzétett tartalom kerül küldésre
JSON 
{
  "postId": "123",
  "action": "save",
  "postType": "posts",
  "websiteUrl": "https://your-site.com",
  "integration": "WordPress",
  "assistantId": "your-assistant-id"
}

Mi szinkronizálódik

  • Bejegyzés tartalom — Cím, szövegtörzs, szerző, dátum, permalink
  • Kiemelt kép — Automatikusan felismert bélyegképekből, blokkokból vagy tartalomból
  • Taxonómiák — Kategóriák, címkék és egyéni taxonómiák egyszerű címkékként

Mi NEM szinkronizálódik

  • Piszkozat vagy privát tartalom
  • Jelszóval védett bejegyzések
  • Felhasználói hitelesítő adatok vagy admin adatok

Hibaelhárítás

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

"EchoAI is not functional on localhost"

Az AI-nak el kell érnie az oldalad REST API-ját az interneten keresztül. Telepítsd egy nyilvánosan elérhető szerverre.

"Could not validate your Assistant ID"

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

A lebegő gomb nem jelenik meg

  • Ellenőrizd 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ő konzolt SDK hibák után

A tartalom nem szinkronizálódik

  • Ellenőrizd, hogy a bejegyzéstípus engedélyezve van-e az EchoAI > Konfiguráció > Tartalom integráció alatt
  • A bejegyzéstípusnak show_in_rest engedélyezettnek kell lennie
  • Csak a közzétett tartalom indít webhookot — a piszkozatok figyelmen kívül maradnak
  • Tömeges importáláshoz szükség lehet manuális szinkronizálásra az EchoAI platformról

Debug mód

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 az utolsó 10 hibát a bővítmény beállításaiban tárolja.

Segítségre van szükséged?
Látogass el az EchoAI dashboardra, vagy fordulj a támogatáshoz az integráció segítségéért.