Cum integrezi modulul de programare pe site-ul tău

Setări → Integrări le permite vizitatorilor să facă programări la tine direct de pe site-ul tău, printr-un modul de programare integrat, fără să-i trimiți aici.

1. Permite domeniul tău

La Domenii permise, introdu adresa exactă a site-ului care va găzdui modulul de programare: doar protocolul și domeniul (cu portul, dacă are unul), fără cale și fără bară oblică la final:

https://apply.acme.com     ✓
https://acme.com:8443      ✓
acme.com                   ✗  lipsește protocolul
https://acme.com/book      ✗  conține o cale
https://acme.com/          ✗  bară oblică la final

https://www.acme.com și https://acme.com sunt adrese diferite. Dacă vizitatorii îți pot accesa site-ul în ambele feluri, adaugă-le pe amândouă.

Lista aceasta ține loc și de comutator de pornire și oprire: cât timp e goală, modulul tău de programare nu poate fi integrat nicăieri. Poți adăuga cel mult 50 de domenii, iar eliminarea unuia are efect imediat.

2. Lipește codul de integrare

Fiecare anunț aprobat are propriul cod de integrare. Copiază-l și lipește-l în pagina ta, acolo unde vrei să apară modulul de programare:

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

Elementul <div> marchează locul; eticheta script poate sta oriunde în pagină și trebuie să apară o singură dată, chiar dacă ai mai multe module de programare. Dacă vezi încă nu ai anunțuri aprobate pe care să le integrezi, anunțul este încă în verificare. Codul lui de integrare apare după ce este aprobat.

3. Alege limba

Limba modulului de programare, de pe această pagină, stabilește ce văd vizitatorii. Las-o pe la fel ca limba paginii și modulul de programare citește atributul lang al etichetei <html> din pagina ta, același atribut pe care îl folosesc motoarele de căutare și cititoarele de ecran, așa că un site tradus corect nu are nevoie de nicio altă configurare:

<!doctype html>
<html lang="es">      <!-- modulul apare în spaniolă -->
  <head>…</head>
  <body>…</body>
</html>

Etichetele regionale funcționează: lang="pt-BR" este redus la cea mai apropiată limbă pe care o acceptăm, nu respins.

Ca să treci peste limba paginii pentru un singur modul de programare, adaugă data-locale la div-ul de integrare. Are prioritate atât față de limba paginii, cât și față de setarea de pe această pagină:

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

Dacă pagina ta are propriul selector de limbă, spune-i modulului de programare să-l urmeze. Limba se schimbă pe loc, iar tot ce a completat deja vizitatorul se păstrează:

window.SchedulerEmbed.setLocale("sr");

Pe scurt, câștigă prima dintre acestea care este setată: data-locale, apoi <html lang> din pagina ta, apoi Limba modulului de programare, apoi browserul vizitatorului, apoi engleza.

Alte opțiuni

Adaugă-le la div-ul de integrare:

data-mode="popup" afișează un buton care deschide modulul de programare într-o fereastră suprapusă, în loc să-l plaseze direct în pagină.

data-label="Programează-te acum" stabilește textul butonului în modul popup.

data-min-height="480" stabilește înălțimea în pixeli până când modulul își raportează dimensiunea reală. Mărește valoarea dacă vezi un salt la încărcare.

Mai ai la dispoziție două funcții, dacă site-ul tău inserează conținut dinamic sau urmărește conversiile:

// Scanează din nou pagina după ce adaugi un div pentru modul
window.SchedulerEmbed.refresh();

// Se declanșează când un vizitator finalizează o programare
window.SchedulerEmbed.onBooking(function (e) {
  console.log(e.bookingId, e.serviceId);
});

Asistenți de inteligență artificială

Prin WebMCP, un standard web propus, modulul de programare oferă și instrumente pentru asistenții de inteligență artificială. Cu ele, un asistent care ajută un vizitator în browserul acestuia poate citi ce oferi și la ce preț, poate găsi intervale libere și poate selecta o oră acolo unde vizitatorul o vede. Poate face și programarea, dar programarea este marcată ca având nevoie de acordul vizitatorului, așa că asistentul îl întreabă mai întâi. Intrarea în cont, crearea unui cont și plata rămân mereu în mâinile vizitatorului.

Nu trebuie să configurezi nimic: codul de integrare permite deja acest lucru. Doar un modul de programare pe care l-ai plasat cu propria etichetă <iframe>, în locul codului de integrare, are nevoie ca în acea etichetă să adaugi allow="payment; tools; publickey-credentials-get". Ultima valoare îi permite vizitatorului să-și confirme intrarea în cont cu o cheie de acces în interiorul modulului de programare.

Compatibilitatea cu asistenții este încă nouă. Aplicația desktop ChatGPT folosește deja aceste instrumente în browserul ei integrat, pe pagina anunțului tău de pe site-ul nostru și pe linkul din Partajează linkul de programare. Nu folosește încă instrumentele dintr-un modul de programare integrat în alt site; modulul este pregătit pentru asistenții care o fac. Oricum ar fi, vizitatorii pot face oricând programarea singuri.

Dacă modulul de programare nu se încarcă

Adresa paginii nu este în lista domeniilor permise sau nu se potrivește exact. Folosirea http în loc de https, sau lipsa prefixului www, este de ajuns ca să-l blocheze.

Codul de integrare a ajuns undeva unde scriptul nu poate rula, de exemplu într-un bloc de text simplu sau de HTML restricționat din constructorul tău de site-uri.

Valoarea data-service a fost modificată. Lipește codul de integrare așa cum este, în loc să rescrii ID-ul.

Anunțul a fost retras de pe site sau nu mai este aprobat.