Ukufaka i-widget

Ukufaka okuyisisekelo

Engeza le thegi yeskripthi kuwebhusayithi yakho, ngaphambi nje kwethegi yokuvala 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>

I-snippet eziqalisa yona

Ungaphinde usebenzise ithegi yeskripthi eyodwa uma ungadingi ukufaka imiyalo emgqeni ngaphambi kokuthi i-widget ilayishe:

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

Hlonza izivakashi futhi uthumele izimfanelo zangokwezifiso

Uma umsebenzisi esengene kusayithi yakho, biza u-sonny('identify') nge-imeyili yakhe nanoma iyiphi imininingwane eyengeziwe ofuna ithimba lakho losizo liyibone. Dlulisa izinkambu ezengeziwe ngaphansi kuka-attributes — okhiye abasha bakhiwa njengezinkambu zangokwezifiso ngokuzenzakalela futhi baboniswa ngakwesokudla sengxoxo. Izingcingo ezilandelayo zibhala ngaphezu kwenani 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>

Izinhlobo zamanani ezisekelwayo: string, number, boolean, usuku lwe-ISO-8601, URL. Dlulisa u-null ukuze usule imfanelo. Okhiye kufanele baqale ngohlamvu, basebenzise izinhlamvu, izinombolo, noma ama-underscore kuphela, futhi babe nezinhlamvu ezingeqile ku-64. Okhiye u-email, name, id, phone, createdAt no-updatedAt bagodliwe. Amanani ombhalo akhawulelwe ezinhlamvwini ezingu-1,000. Umkhawulo: izimfanelo ezingu-50 ngocingo ngalunye.

Vula i-widget ngenkinobho yakho

Ufuna ukuqala ingxoxo ngenkinobho yakho esikhundleni sebhamuza elintantayo? Dlulisa u-hideLauncher: true ku-sonny('init') ukuze ufihle isiqalisi esakhelwe ngaphakathi, bese ubiza u-sonny('open') kunoma iyiphi into ekhasini 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 miyalo ilawula i-widget kunoma iyiphi indawo ekhasini lakho:

• sonny('open') — vula iphaneli yengxoxo.
• sonny('close') — yivale.
• sonny('toggle') — yivule noma uyivale, ilungele inkinobho eyodwa yokushintsha.
• sonny('show') no-sonny('hide') — bonisa noma ufihle yonke i-widget, kuthathe indawo yemithetho yokubonisa yakho.
• sonny('getUnreadCount', callback) — funda isibalo samanje sokungafundiwe noma nini.

Ukhetha ukufaka ngethegi yeskripthi eyodwa? Engeza u-data-hide-launcher kuthegi yeskripthi ukuze ufihle isiqalisi, bese uxhuma inkinobho yakho emiyalweni efanayo.

Bonisa izimpendulo ezingafundiwe enkinobhweni yakho

Ukufihla isiqalisi kuphinde kufihle ibheji laso lokungafundiwe, ngakho i-Sonny itshela ikhasi lakho esikhundleni salokho. I-widget ithumela umcimbi u-sonny:unread ku-window no-detail.count — inombolo efanayo nebingaboniswa yisiqalisi esakhelwe ngaphakathi. Ilungele ibheji ekuzulazuleni kwakho kweselula.

<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>

Isibalo sihlanganisa izimpendulo zama-ejenti ezingafundiwe kuzo zonke izingxoxo zesivakashi. Siqhuma kanye ngemva nje kokuthi i-widget ilayishe — ngakho umlaleli ofakwe lapho ikhasi lilayisha uhlala ethola isimo samanje — bese siqhuma futhi noma nini lapho sishintsha, kuhlanganise nokubuyela ku-0 uma isivakashi sivula ingxoxo.

Izinketho zokwenza ngokwezifiso

Yenza i-widget ngokwezifiso kuthebhu yesiteshi sakho ethi "Ingxoxo ebukhoma" ku-Sonny.

Izinyathelo ezilandelayo

Njengoba i-widget yakho isifakiwe, setha nokudlulisela i-imeyili.

Imibhalo ehlobene

• Ukwenza i-widget ngokwezifiso

  Fanisa i-widget nophawu lwakho ngemibala, amalogo, imilayezo, nokuziphatha.

• Ukuhlonza izivakashi

  Hlonza abasebenzisi abangene ngemvume futhi uthumele izimfanelo zangokwezifiso usuka kuwebhusayithi yakho.

• Lapho i-widget ivela khona

  Bonisa noma ufihle i-widget ngekhasi, isivakashi, ipharamitha ye-URL, usuku, isheduli, idivayisi, noma isikhathi esisekhasini.

• Ama-SDK engxoxo eselula

  Engeza ingxoxo yezivakashi kuhlelo lwakho lokusebenza lwe-iOS, Android noma React Native. Buka ama-SDK omphakathi, izibonelo nabalandeleli bezinkinga.

• Ukulungisa i-imeyili

  Dlulisela i-imeyili yakho yosizo ku-Sonny futhi uphathe i-imeyili kanye nengxoxo ebukhoma.

• Iziteshi

  Dala futhi uphathe izindawo lapho amakhasimende ekufinyelela khona ngengxoxo ebukhoma nange-imeyili.