A foglalási modul beágyazása a weboldaladba

A Beállítások → Integrációk oldalon beállíthatod, hogy a látogatók közvetlenül a saját weboldaladon foglalhassanak időpontot nálad egy beágyazott foglalási modullal, és ne kelljen ide átküldened őket.

1. Add meg az engedélyezett domaint

Az Engedélyezett domainek résznél add meg pontosan annak az oldalnak a címét, amelyen a foglalási modul megjelenik: csak a protokollt és a domaint (és a portot, ha van), elérési út és záró perjel nélkül:

https://apply.acme.com     ✓
https://acme.com:8443      ✓
acme.com                   ✗  hiányzik a protokoll
https://acme.com/book      ✗  elérési utat tartalmaz
https://acme.com/          ✗  záró perjel

A https://www.acme.com és a https://acme.com két különböző cím. Ha a látogatók mindkettőn elérik az oldaladat, add hozzá mindkettőt.

Ez a lista egyben be- és kikapcsoló is: amíg üres, a foglalási modulod sehova sem ágyazható be. Legfeljebb 50 domaint adhatsz hozzá, és ha törölsz egyet, az azonnal érvénybe lép.

2. Illeszd be a kódrészletet

Minden jóváhagyott hirdetésnek saját kódrészlete van. Másold ki, és illeszd be az oldaladba oda, ahol a foglalási modulnak meg kell jelennie:

<div class="scheduling-embed" data-service="SERVICE_ID"></div>
<script src="https://embed.example.com/embed.js" async></script>

A <div> jelöli a helyet. A script elem bárhová kerülhet az oldalon, és elég egyszer szerepelnie, akkor is, ha több foglalási modul van rajta. Ha azt látod, hogy még nincs beágyazható jóváhagyott hirdetésed, a hirdetésed még ellenőrzés alatt áll. A kódrészlete a jóváhagyás után jelenik meg.

3. Állítsd be a nyelvet

Ezen az oldalon a Foglalási modul nyelve beállítás határozza meg, mit látnak a látogatók. Ha az oldal nyelvének követése marad kiválasztva, a foglalási modul a lang attribútumot olvassa ki az oldalad <html> eleméből, ugyanazt, amelyet a keresőmotorok és a képernyőolvasók is használnak, így egy rendesen lokalizált oldalon nincs szükség további beállításra:

<!doctype html>
<html lang="es">      <!-- a foglalási modul spanyolul jelenik meg -->
  <head>…</head>
  <body>…</body>
</html>

A regionális címkék is működnek: a lang="pt-BR" értéket a modul nem utasítja el, hanem a legközelebbi általunk támogatott nyelvre szűkíti.

Ha egy foglalási modulnál felül szeretnéd bírálni az oldal nyelvét, add hozzá a data-locale attribútumot a beágyazó divhez. Ez az oldal nyelvénél és az itteni beállításnál is erősebb:

<div class="scheduling-embed" data-service="SERVICE_ID" data-locale="de"></div>

Ha az oldaladnak saját nyelvválasztója van, állítsd be, hogy a foglalási modul kövesse. Így a nyelv helyben vált, és megmarad minden, amit a látogató addig kitöltött:

window.SchedulerEmbed.setLocale("sr");

Röviden: az alábbiak közül az első beállított érvényes: data-locale, aztán az oldalad <html lang> értéke, aztán a Foglalási modul nyelve, aztán a látogató böngészője, végül az angol.

További beállítások

Ezeket a beágyazó divhez adhatod hozzá:

A data-mode="popup" egy gombot jelenít meg, amely felugró ablakban nyitja meg a foglalási modult, ahelyett hogy az oldalba ágyazná.

A data-label="Foglalj időpontot" beállítja a gomb feliratát felugró módban.

A data-min-height="480" megadja a magasságot pixelben, amíg a foglalási modul nem jelzi a valódi méretét. Ha betöltéskor ugrást látsz, növeld meg.

Két további függvényt is használhatsz, ha az oldalad menet közben illeszt be tartalmat, vagy konverziókat mér:

// Új foglalási modul div hozzáadása után vizsgáld át újra az oldalt
window.SchedulerEmbed.refresh();

// Akkor fut le, amikor egy látogató befejez egy foglalást
window.SchedulerEmbed.onBooking(function (e) {
  console.log(e.bookingId, e.serviceId);
});

Mesterségesintelligencia-asszisztensek

A WebMCP nevű, javasolt webes szabványon keresztül a foglalási modul eszközöket is kínál a mesterséges intelligenciával működő asszisztenseknek. Ezekkel egy asszisztens, amely a látogató böngészőjében segít, elolvashatja, mit kínálsz és milyen áron, szabad időpontokat kereshet, és kiválaszthat egy időpontot úgy, hogy a látogató is lássa. Foglalni is tud, de a foglaláshoz a látogató beleegyezése kell, ezért az asszisztens előbb megkérdezi. A bejelentkezés, a fiók létrehozása és a fizetés mindig a látogatónál marad.

Semmit sem kell beállítanod: a kódrészlet ezt már lehetővé teszi. Csak akkor van teendőd, ha a kódrészlet helyett saját <iframe> elemmel helyezted el a foglalási modult. Ilyenkor ezt kell hozzáadnod az elemhez: allow="payment; tools; publickey-credentials-get". Az utolsó érték teszi lehetővé, hogy a látogató a foglalási modulon belül azonosítókulccsal erősítse meg a bejelentkezését.

Az asszisztensek támogatása még új. A ChatGPT asztali alkalmazása a beépített böngészőjében már használja ezeket az eszközöket, a hirdetésed oldalán a mi weboldalunkon és a Foglalási link megosztása gombbal küldött linken is. Más weboldalakba ágyazott foglalási modulban még nem használja őket, a foglalási modul azonban már készen áll azokra az asszisztensekre, amelyek igen. A látogatók mindenesetre mindig foglalhatnak maguk is.

Ha a foglalási modul nem töltődik be

Az oldal címe nem szerepel az engedélyezett listán, vagy nem egyezik vele pontosan. A http használata a https helyett, vagy egy hiányzó www már elég ahhoz, hogy a modul ne jelenjen meg.

A kódrészlet olyan helyre került, ahol a script nem futhat, például a weboldalkészítőd egyszerű szöveges vagy korlátozott HTML-blokkjába.

Megváltozott a data-service értéke. Illeszd be a kódrészletet változatlanul, ahelyett hogy kézzel írnád be az azonosítót.

A hirdetés már nincs közzétéve, vagy már nincs jóváhagyva.