Ukufaka iwijethi

Ukufaka okusisiseko

Yongeza le thegi yeskripthi kwiwebhusayithi yakho, kanye phambi kwethegi evalayo ethi </body>:

<script>
  (function(w,d,s,o,f,js,fjs){
    w['Sonny']=o;w[o]=w[o]||function(){
    (w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s);fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','sonny','https://www.usesonny.com/widget.js');
  sonny('init', { siteId: 'YOUR_SITE_ID' });
</script>

Ikhowudi eziqalisayo ngokuzenzekelayo

Ungasebenzisa nethegi enye yeskripthi ukuba akufuneki ufake imiyalelo emgceni phambi kokuba iwijethi ilayishe:

<script
  src="https://www.usesonny.com/widget.js"
  data-site-id="YOUR_SITE_ID"
  async
></script>

Chonga iindwendwe uze uthumele iimpawu ezilungiselelweyo

Xa umsebenzisi engena kwisayithi yakho, biza i-sonny('identify') nge-imeyile yakhe nayo nayiphi na idatha eyongezelelweyo ofuna iqela lakho lenkxaso liyibone. Dlulisela amabala ongezelelweyo phantsi kwe-attributes — izitshixo ezintsha zenziwa njengamabala alungiselelweyo ngokuzenzekelayo kwaye ziboniswa kwicala lasekunene lencoko. Ukubiza okulandelayo kubhala ngaphezulu kwexabiso langaphambili.

<script>
  // Identify the visitor and pass any custom attributes you want
  // surfaced in the agent sidebar. Unknown keys are auto-created
  // as Custom Fields in your workspace settings.
  sonny('identify', {
    email: 'jane@acme.com',
    name: 'Jane Doe',
    attributes: {
      plan: 'pro',
      mrr: 499,
      signedUpAt: '2025-08-01T00:00:00Z',
      website: 'https://acme.com'
    }
  });
</script>

Iintlobo zamaxabiso ezixhaswayo: string, number, boolean, umhla we-ISO-8601, URL. Dlulisela i-null ukuze ucoce impawu. Izitshixo kufuneka ziqale ngonobumba, zisebenzise oonobumba, amanani okanye imigca engezantsi kuphela, kwaye zibe ziimpawu ezingama-64 ubuninzi. Izitshixo email, name, id, phone, createdAt ne-updatedAt zigciniwe. Amaxabiso ombhalo anomda wabalinganiswa abali-1,000. Umda: iimpawu ezingama-50 ngokubiza ngakunye.

Vula iwijethi ngeqhosha lakho

Ufuna ukuvula ichat ngeqhosha lakho endaweni yebhamuza edadayo? Dlulisela i-hideLauncher: true ku-sonny('init') ukuze ufihle iqhosha lokuvula elakhelwe ngaphakathi, uze ubize i-sonny('open') kuso nasiphi na isiqalelo kwiphepha lakho.

<!-- 1. Boot Sonny with its built-in launcher hidden -->
<script>
  (function(w,d,s,o,f,js,fjs){
    w['Sonny']=o;w[o]=w[o]||function(){
    (w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s);fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','sonny','https://www.usesonny.com/widget.js');
  sonny('init', { siteId: 'YOUR_SITE_ID', hideLauncher: true });
</script>

<!-- 2. Open the chat from your own button, anywhere on the page -->
<button onclick="sonny('open')">Chat with us</button>

Le miyalelo ilawula iwijethi ukusuka naphi na kwiphepha lakho:

• sonny('open') — vula iphaneli yechat.
• sonny('close') — yivale.
• sonny('toggle') — yivule okanye uyivale, ilungele iqhosha elinye lokutshintsha.
• sonny('show') kunye ne-sonny('hide') — bonisa okanye ufihle iwijethi yonke, ugqitha imithetho yakho yokubonisa.
• sonny('getUnreadCount', callback) — funda inani langoku lezingafundwanga nanini na.

Ukhetha ukufaka ngethegi enye yeskripthi? Yongeza i-data-hide-launcher kwithegi yeskripthi ukuze ufihle iqhosha lokuvula, uze uqhagamshele iqhosha lakho kwimiyalelo efanayo.

Bonisa iimpendulo ezingafundwanga kwiqhosha lakho

Ukufihla iqhosha lokuvula kukwafihla ibheji yalo yezingafundwanga, ngoko iSonny ixelela iphepha lakho endaweni yoko. Iwijethi ithumela isiganeko esithi sonny:unread kwi-window ene-detail.count — inani elifanayo nelo belinokuboniswa liqhosha lokuvula elakhelwe ngaphakathi. Ilungele ibheji kukhangelo lwakho lweselula.

<button id="chat-button" onclick="sonny('open')">
  Chat with us
  <span id="chat-unread" hidden></span>
</button>

<script>
  function showUnread(count) {
    var badge = document.getElementById('chat-unread');
    badge.textContent = count > 9 ? '9+' : count;
    badge.hidden = count === 0;
  }

  // Fires once after the widget loads, then on every change.
  window.addEventListener('sonny:unread', function (event) {
    showUnread(event.detail.count);
  });

  // Optional: read the count on demand (e.g. after your own nav re-renders).
  sonny('getUnreadCount', showUnread);
</script>

Inani ligubungela iimpendulo zeearhente ezingafundwanga kuzo zonke iincoko zondwendwe. Isiganeko senzeka kanye kungekudala emva kokuba iwijethi ilayishe — ngoko umphulaphuli owongezwe xa iphepha lilayisha uhlala efumana imeko yangoku — uze uphinde xa litshintsha, kuquka xa libuyela ku-0 emva kokuba undwendwe luvule ichat.

Ukhetho lokulungiselela

Lungiselela iwijethi kwithebhu yesitishi sakho ethi “Ichat ephilayo” kwiSonny.

Amanyathelo alandelayo

Ngoku njengoko iwijethi yakho ifakiwe, lungiselela nokudluliselwa kwe-imeyile.

Amaxwebhu anxulumeneyo

• Ukulungiselela iwijethi

  Fanisa iwijethi nebrendi yakho ngemibala, iilogo, imiyalezo nendlela yokuziphatha.

• Ukuchongwa kweendwendwe

  Chonga abasebenzisi abangeneyo uze uthumele iimpawu ezilungiselelweyo ukusuka kwiwebhusayithi yakho.

• Apho iwijethi ivela khona

  Bonisa okanye ufihle iwijethi ngokwephepha, undwendwe, iparamitha ye-URL, umhla, ishedyuli, isixhobo okanye ixesha ekwiphepha.

• Ii-SDK zechat zeselula

  Yongeza ichat yeendwendwe kwi-app yakho ye-iOS, Android okanye React Native. Jonga ii-SDK zoluntu, ii-app zemizekelo nezilandeleli zemiba.

• Ukulungiselela i-imeyile

  Dlulisela i-imeyile yakho yenkxaso kwiSonny uze ulawule i-imeyile ecaleni kwechat ephilayo.

• Izitishi

  Yenza uze ulawule iindawo apho abathengi bakufikelela khona ngechat ephilayo nange-imeyile.