Embed kwa wachapishaji

Story Chat — mazungumzo juu ya makala

Ongeza kidirisha cha mazungumzo chini ya makala yako ya WordPress. Wasomaji waulize maswali kuhusu habari hiyo hiyo — majibu yanatumia maudhui ya ukurasa na muktadha wa Tanzania.

← Programu ya wachapishaji Weka viwango vya fedha kwenye WordPress — mwongozo wa embed Washirika na msaada

Story Chat ni skripti moja unayoweka kwenye tovuti yako. Haibadili mandhari yako — inaonekana tu kwenye kurasa zenye makala ya WordPress (article.post).

Ujumbe wa kwanza hutuma URL, slug, na maudhui ya makala kwa Nukta AI; mazungumzo yaliyofuata hutuma ujumbe na conversationId pekee.

KINACHOTOKEA

Kwa wasomaji wako

Kidirisha kinachomaa chini ya ukurasa — maswali yaliyopendekezwa, ujumbe wa mtiririko, na kiungo “Inaendeshwa na Nukta AI”.

💬

Maswali yaliyopendekezwa

Chip tatu za haraka (mf. nani anaathirika, muhtasari, ulinganisho) — zinaweza kubadilishwa kwenye config.

⚡

Majibu ya mtiririko

Majibu yanajazwa hatua kwa hatua kupitia /api/chat (SSE), kama mazungumzo ya kawaida ya Nukta AI.

🇹🇿

Kiswahili kwanza

Lugha chaguo-msingi ni Kiswahili; weka preferredLanguage: "en" kwa Kiingereza.

◎

Haijazuii ukurasa

Skripti haifanyi kazi kwenye kurasa zisizo na makala ya WP — hakuna widget ya ziada.

ANZA HAPA

Embed ya haraka

Weka lebo hizi kabla ya </body> kwenye kila ukurasa wa makala (au kupitia GTM). Badilisha sourceName kwa jina la tovuti yako.

Msimbo wa kuchomeka

<script>
  window.NuktaStoryChatConfig = {
    apiUrl: 'https://ai.nukta.co.tz/api/chat',
    nuktaUrl: 'https://ai.nukta.co.tz',
    preferredLanguage: 'sw',
    profileType: 'tanzania',
    sourceName: 'Your Site Name',
    suggestions: [
      'Nani anaathirika?',
      'Kwa kifupi vitu gani muhimu nijue?',
      'Linganisha na habari zinazofanana na hii.'
    ]
  };
</script>
<script src="https://ai.nukta.co.tz/assets/embed/story-chat.js" async></script>

CONFIG

Chaguo za NuktaStoryChatConfig

Zote ni za hiari. Unaweza pia kutumia data-* kwenye lebo ya <script> (mf. data-source-name="Gazetini").

apiUrl
URL ya API ya mazungumzo (chaguo-msingi: https://ai.nukta.co.tz/api/chat).
nuktaUrl
Kiungo cha “Inaendeshwa na Nukta AI”.
preferredLanguage
sw au en — lugha ya UI na majibu.
profileType
Aina ya wasifu wa chat engine (chaguo-msingi: tanzania).
sourceName
Jina la chanzo linaonekana kwenye metadata ya makala (mf. jina la gazeti lako).
suggestions
Orodha ya maswali yaliyopendekezwa (string[]).
articleSelector
CSS selector ya mzizi wa makala ikiwa si WordPress ya kawaida (mf. article.post).

GTM / WORDPRESS

Google Tag Manager au plugin

Unda tag ya Custom HTML inayofungua kwenye kurasa za makala tu (trigger: Page Path ina /habari/ au template ya post). Weka config juu ya lebo ya skripti.

Kwenye WordPress: footer.php, plugin ya “Insert Headers and Footers”, au muundo wa mtoto unaoruhusu skripti kwenye single post.

MAHITAJI

Lini widget inaonekana

Skripti inatafuta <article> yenye darasa post, post-*, au id post-123. Maudhui lazima yawe na angalau herufi 80 za maandishi (baada ya kuondoa nav, maoni, n.k.).

  • Makala inapaswa kuwa na .entry-title (au h1) na .entry-content (au [itemprop="articleBody"]).
  • HTTPS inapendekezwa; skripti inapakia marked.js kutoka CDN kwa muundo wa markdown.
  • Kwa masuala ya ufikiaji au viwango vya matumizi, wasiliana nasi kupitia ukurasa wa Washirika.

DEMO

Jaribu hapa chini

Makala ya mfano ina muundo wa WordPress — widget ya Story Chat inapaswa kuonekana chini ya ukurasa huu.

Makala ya mfano: jinsi Story Chat inavyofanya kazi kwenye tovuti yako

Hii ni chapisho la mfano lenye muundo wa WordPress. Kwenye tovuti yako halisi, Story Chat husoma kichwa na maudhui halisi ya makala wasomaji wanayoisoma.

Jaribu kidirisha chini: uliza nani anaathirika, omba muhtasari mfupi, au linganisha na habari zinazofanana. Majibu yanategemea ukurasa huu na muktadha wa Tanzania.

Wachapishaji wanaongeza lebo moja ya skripti — hakuna mabadiliko ya mandhari. Widget inapakia tu kwenye kurasa za makala zinazolingana na muundo wa kawaida wa WordPress.