WordPress

A WordPress integráció a WordPress REST API-t és az Echo bővítményt kombinálja — a platform legtisztább szinkron-történetét adja. Az első import minden publikált posztot behoz; utána a webhookok azonnal viszik a publikálási, frissítési és törlési eseményeket, kézi frissítés nélkül.

Ezen az oldalon

Miért válaszd

  • WordPressen fut a site-od, és rendszeresen publikálsz.
  • Valós idejű szinkron kell — az új posztok másodperceken belül megjelennek az asszisztensben.
  • Szeretnéd, ha a frissítések és törlések automatikusan tükröződnének.
  • Nem gond egy WordPress bővítményt telepíteni a verifikációhoz.

Hogyan működik

Két részből áll.

  1. Első import REST API-n keresztül. Az Echo meghívja a WordPress REST végpontjait (/wp-json/wp/v2/posts, /wp-json/wp/v2/pages, stb.), és behúz minden publikált posztot. A HTML törzset Markdownra konvertálja, hogy a címsorok, listák és kódblokkok megmaradjanak. Ha a Markdown konverzió hibázik, az Echo plain text fallbackre vált.
  2. Folyamatos szinkron az Echo bővítmény webhookjain át. Az Echo WordPress bővítmény verifikált forrásként regisztrálja magát a site-on, és értesít az Echót, amikor a tartalom változik. Új poszt → az Echo tartalmat hoz létre. Frissítés → az Echo frissíti az elemet. Törlés → az Echo eltávolítja az elemet.

Minden szinkronizált poszt magával viszi a WordPress ID-t, slug-ot, típust, státuszt, szerzőt és taxonómiákat metaadatként. Az eredeti WordPress permalink megmarad, így a látogató rákattinthat a hivatkozásra.

Eltérés a hasonló opcióktól

  • vs. Weboldal szinkronizált forrás — a Weboldal sitemap alapján crawlol, és kérésre újra fut. A WordPress REST API + webhook gyorsabb, megbízhatóbb, valós időben frissít. Ha WordPress van, ezt válaszd.
  • vs. URL kézi feltöltés — az URL egyszerre egy oldalt kezel, kézi frissítéssel. A WordPress minden posztot behoz, és intervenció nélkül szinkronban marad.
  • vs. a WordPress bővítmény útmutató — az az útmutató a bővítmény teljes funkciókészletét tárgyalja (chat widget beágyazás, stb.). Ez az oldal csak a tartalom-szinkronra fókuszál.

Beállítás lépésről lépésre

  1. Telepítsd és aktiváld az Echo WordPress bővítményt a site-on. A bővítmény kezeli a verifikációt és regisztrálja a webhook végpontokat.
  2. Az Echóban nyisd meg az Integrációk oldalt a dashboard Szinkronizált források szekciójából.
  3. Kattints a Forrás hozzáadása gombra, válaszd a WordPress típust.
  4. Add meg a WordPress site URL-jét (pl. https://example.com vagy https://example.com/blog). Az Echo elfogadja http(s)-szel vagy anélkül, perjellel vagy anélkül.
  5. Teljesítsd a verifikációt. Az Echo megerősíti, hogy a bővítmény aktív és a REST API elérhető.
  6. Válaszd ki, melyik asszisztens kapja a tartalmat.
  7. Küldd el. Az első import a háttérben indul.

Figyeld az integráció kártyájának állapotát. Az első import után a változások másodperceken belül szinkronizálódnak.

Gyakori hibák és megoldások

  • „Nincs telepítve a bővítmény" — az Echo WordPress bővítmény nincs telepítve vagy aktiválva. Ellenőrizd a WP Admin → Bővítmények oldalon.
  • „Nem elérhető a REST API" — biztonsági bővítmények (Wordfence, iThemes, stb.) gyakran alapból tiltják a REST API-t. Engedélyezd az Echót vagy nyisd meg a releváns végpontokat.
  • „Nem sikerült lekérni a WordPress tartalmat" — egy konkrét poszt nem-2xx választ adott az import közben. A 4xx válaszokat „törölt"-ként kezeli és csendben kihagyja; egyéb hibák az integráción logolódnak.
  • Nem szinkronizál valós időben — a webhookok regisztrálása nem sikerült, vagy a hostod tiltja a kimenő HTTP-t. Nézd meg a bővítmény webhook-log paneljét.
  • A tartalom nyers HTML-nek tűnik — a Markdown konverzió hibázott, és az Echo plain textre váltott. Az AI-nak ez általában elég jó; ellenőrizd a posztot szokatlan shortcode-okra vagy hibás HTML-re.
  • A WordPressben már törölt posztok még a könyvtárban vannak — ellenőrizd, hogy a webhook elsült-e (bővítmény logok). Egyszeri tisztításhoz az integráció újra-szinkronja kényszeríthet egy teljes újrafutást.
Egyedi post type-ok
Az Echo alapból támogatja a standard posts és pages típusokat. Az egyedi post type-okat akkor importálja, ha azok elérhetők a REST API-n és regisztrálva vannak az Echo bővítményben.