Nyaraka

FAQ

Je, watumiaji wanahitaji kusakinisha kitu chochote?

Hapana. Watumiaji hubandika tu tagi moja ya script ndani ya HTML yao — hakuna pakiti za npm, hakuna hatua za kujenga, hakuna utegemezi. Vipengele vya ziada hupakiwa kiotomatiki kutoka asili ile ile.

Je, itagongana na CSS yangu?

Hapana. Wijeti huonyeshwa ndani ya Shadow DOM, ikitenga kabisa mitindo yake na ukurasa wako.

Je, inaunga mkono programu za ukurasa mmoja (React, Vue, Next.js)?

Ndiyo. Skripti hupakiwa mara moja na hudumu wakati njia zinabadilika. Kwa React/Next.js, weka skripti katika layout yako ya mzizi.

Next.js App Routertsx
// app/layout.tsx (App Router)
import Script from 'next/script';
import { ReactNode } from 'react';

export default function RootLayout({ children }: { children: ReactNode }) {
  return (
    <html lang="en">
      <body>
        {children}
        <Script id="respondo-init" strategy="afterInteractive">
          {`
            window.Respondo = window.Respondo || {};
            Respondo.init = Respondo.init || function(c) { window.RespondoAIConfig = c; };
            Respondo.q = Respondo.q || [];
            Respondo.identify = Respondo.identify || function(d) { Respondo.q.push(['identify', d]); };
            Respondo.init({
              agentId: 'YOUR_AGENT_ID',
              channelId: 'YOUR_CHANNEL_ID'
            });
          `}
        </Script>
        <Script src="https://api.respondo.ai/widget/widget.js" strategy="afterInteractive" />
      </body>
    </html>
  );
}

Nini hutokea mazungumzo yanapotatuliwa?

Ujumbe mpya baada ya kutatuliwa hufungua kiotomatiki mazungumzo ya ufuatiliaji yaliyounganishwa na yale ya awali (huonyeshwa kama "Continued from #N" katika kikasha chako). Muktadha kama lugha na nakala ya awali huhamia, na mgeni huona gumzo moja linaloendelea. Ikiwa mwenzako wa timu ndiye aliyekuwa akishughulikia mazungumzo yaliyotatuliwa, ufuatiliaji huelekezwa tena kwa timu yako badala ya AI; la sivyo AI huyachukua.

Wijeti hupakiwaje?

Wijeti hupakiwa kwa njia isiyosawazishwa (async), kwa hivyo haizuii kamwe uonyeshaji wa ukurasa. Kifurushi cha msingi ni ~180KB (~50KB gzip); vipengele vya hiari (kampeni, ziara za bidhaa) hupakiwa kama vipande tofauti vya uvivu baada ya wijeti kupachikwa, hivyo uonyeshaji wa awali wa ukurasa hauzuiliwi kamwe.

Upandishaji hufanya kazi vipi?

Watumiaji wanaweza kubofya kitufe cha "Talk to human", kuandika kifungu wakiomba binadamu, au AI hukabidhi yenyewe inaposhindwa kujibu kutoka kanzi yako ya maarifa. Baada ya kupandishwa, AI huacha kujibu na ujumbe wote unaofuata hupelekwa kwa timu yako ya msaada. Angalia sehemu ya Upandishaji na makabidhiano kwa maelezo zaidi.

Je, watumiaji wanaweza kuendelea kuzungumza na AI baada ya upandishaji?

Ndiyo. Wijeti huonyesha kitufe cha "Continue with AI" kinachomruhusu mtumiaji kuondoa upandishaji na kurejea kwenye mazungumzo na AI.

Hifadhi ya maarifa na utambazaji wa tovuti#

Kwa nini utambazaji wa tovuti yangu umezuiwa?

"Umezuiwa" inamaanisha tovuti — au safu yake ya ulinzi (Cloudflare, WAF, programu-jalizi ya kuzuia roboti) — ilikataa kitambazaji chetu: ukurasa wa kuanzia au robots.txt ulijibu kila jaribio kwa hitilafu ya ufikiaji au changamoto ya "tunakagua kivinjari chako", au robots.txt unakataza kitambazaji chetu waziwazi. Kurasa zilizoingizwa awali zinabaki salama, na usawazishaji upya utashindwa kwa njia ile ile hadi tovuti ituruhusu. Muombe mmiliki wa tovuti aruhusu User-Agent RespondoAI-Crawler (mfuatano kamili: Mozilla/5.0 (compatible; RespondoAI-Crawler/1.0; +https://respondo.ai/bot)) katika mipangilio yake ya ulinzi — kwenye Cloudflare ni Security → WAF → Custom rules — na, ikiwa chanzo ni robots.txt, aongeze sheria ya kuruhusu kwa User-agent: RespondoAI-Crawler. Respondo haichapishi anwani ya IP isiyobadilika ya kitambazaji — ruhusu kwa User-Agent; ikiwa hitilafu inayoonyeshwa kwenye chanzo inataja IP, ruhusu hiyo pia. Ikiwa tovuti haiwezi kubadilishwa, ongeza maudhui yale yale kama faili au maandishi yaliyobandikwa.

Utambazaji umekamilika lakini umepata kurasa chache tu

Tunagundua kurasa kutoka kwa ramani ya tovuti (mstari wa Sitemap: katika robots.txt au maeneo ya kawaida kama /sitemap.xml) na kwa kufuata viungo kutoka kwa URL ya kuanzia — hadi viwango 10 vya viungo kwa kina na hadi kurasa 5,000 kwa kila chanzo. Kurasa za tovuti ile ile tu na zilizo chini ya njia ya URL ya kuanzia ndizo zinazoingizwa: utambazaji ulioanzia https://example.com/help unaruka /blog, kwa hivyo anzia kwenye mzizi au ongeza njia za kujumuisha. Kurasa ambazo hakuna kiungo wala ramani ya tovuti inayozielekeza, kurasa ambazo robots.txt inakataza, na kurasa zilizo nyuma ya kuingia hazipatikani. Kurasa zinazokaribia kufanana (matoleo ya kuchapisha, lahaja zenye vigezo vya ufuatiliaji) huunganishwa kuwa moja. Kurasa ambazo maudhui yake yanachorwa kabisa na JavaScript hutambuliwa na kuonyeshwa kwa utaratibu mbadala unaotegemea kivinjari, kwa hivyo idadi ndogo ya kurasa kwa kawaida inamaanisha tatizo la wigo au ramani ya tovuti, si la uonyeshaji.

Ninawezaje kuweka utambazaji kwenye sehemu moja tu ya tovuti?

Fungua Advanced katika kidirisha cha kuongeza tovuti na ujaze Only crawl paths starting with (tambaza tu njia zinazoanza na) na/au Skip paths starting with (ruka njia zinazoanza na) — njia moja kwa kila mstari, hadi 50 kwa kila sehemu. Ulinganishaji hufanywa kwa sehemu kamili za njia: /docs inalingana na /docs na /docs/getting-started, lakini si na /docs-archive; mkwaju wa mwisho hupuuzwa, na unaweza kubandika URL kamili — njia yake tu ndiyo hutumika. Sheria za kuruka hushinda sheria za kujumuisha. Sheria zile zile hutumika kwa ramani ya tovuti na kwa kila usawazishaji upya unaofuata wa chanzo hicho.

Respondo hutambaza upya tovuti yangu mara ngapi?

Kila chanzo cha tovuti kina ratiba ya Auto-refresh katika paneli ya kurasa zake: Off (imezimwa), Daily (kila saa 24) au Weekly (kila siku 7). Utambazaji uliopangwa ni wa nyongeza: kurasa ambazo lastmod yake katika ramani ya tovuti ni ya zamani kuliko utambazaji uliopita huruka, kurasa zisizobadilika haziorodheshwi upya, zilizobadilika huorodheshwa upya na zilizotoweka huondolewa. Ili kuonyesha upya mara moja, tumia Re-sync katika menyu ya chanzo au Re-sync all kwenye ukurasa wa Knowledge.

"Hatukuweza kusoma tovuti wakati huu" — nini kilitokea?

Hii ni hitilafu ya jumla: tovuti haikujibu kwa wakati, kikoa hakikutatuliwa, seva ilirudisha hitilafu, ukurasa wa kuanzia haukuwa na maandishi yanayosomeka, au anwani haikupatikana. Maelezo yanaonyeshwa kwenye chanzo. Hakikisha URL inafunguka katika dirisha la faragha la kivinjari, hakuna kosa la tahajia katika kikoa, na ukurasa wa kuanzia ni ukurasa halisi wa maudhui badala ya skrini ya kuingia. Mitandao ya kijamii na majukwaa ya ujumbe (Facebook, Instagram, LinkedIn, X, YouTube na mengine kama hayo) hayawezi kuingizwa kabisa — yanakataliwa kabla utambazaji haujaanza. Kurasa zako zilizopo huhifadhiwa; chanzo kilichopangwa hujaribu tena katika utekelezaji unaofuata, vinginevyo sawazisha upya tovuti itakapofikika tena.

"Faharasa yetu ya utafutaji imejaa" na "hatukuweza kuorodhesha chanzo hiki" zinamaanisha nini?

Zote mbili huonekana baada ya maudhui kusomwa kwa mafanikio. Faharasa imejaa inamaanisha faharasa ya utafutaji ambayo chanzo hiki hunakiliwa ndani yake haina nafasi upande wa Respondo — kikomo cha Respondo, si tatizo la maudhui yako. Kurasa zimehifadhiwa, kila kitu kilichoorodheshwa tayari kinaendelea kujibu, timu yetu inaarifiwa kiotomatiki na chanzo kitaorodheshwa mara nafasi itakapopatikana; kusawazisha upya mapema kutashindwa kwa njia ile ile. Hatukuweza kuorodhesha chanzo hiki inamaanisha ujenzi wa faharasa ya utafutaji umeshindwa wakati huu — hitilafu ya muda upande wetu; data iliyopo iko salama na kazi hujaribiwa tena kiotomatiki. Ikiwa ujumbe wowote unaendelea, tumia "Kuuliza Copilot" kwenye hitilafu.

Je, kurasa ndefu hujibiwa kutoka mwanzo wake tu?

Hapana. Kila ukurasa uliotambazwa hugawanywa katika vipande vinavyopishana vya takriban herufi 1,600, kila kimoja kikiorodheshwa kando pamoja na kichwa cha ukurasa, hivyo jibu linaweza kutoka sehemu yoyote ya makala ndefu. Manukuu bado huonyesha kiungo kimoja kwa kila ukurasa. Kurasa zilizoingizwa kabla ya mabadiliko haya hugawanywa upya katika usawazishaji upya unaofuata.

Ninapataje msaada kuhusu hitilafu ya utambazaji?

Kila hitilafu ya utambazaji au uorodheshaji kwenye ukurasa wa Knowledge huja na kitufe cha Kuuliza Copilot. Kinafungua Copilot na hitilafu ikiwa imeambatishwa, na Copilot hujibu kutoka kwa nyaraka za msaada za Respondo yenyewe kwa hatua thabiti kwa kesi yako. Msaada huu ni bure — hauhesabiwi katika maombi yako ya AI. Ikiwa hatua hazitatui tatizo, sema hivyo — "haikusaidia" inatosha. Kisha Copilot hutoa kadi inayokabidhi tatizo kwa timu ya Respondo: kadi huorodhesha hasa kitakachotumwa, hakuna kinachotoka hadi uthibitishe, na jibu lao hufika katika uzi ule ule wa Copilot. Ikiwa kukabidhi hakupatikani, Copilot husema hivyo waziwazi badala ya kunyamaza.

Ujumbe usiomfikia mteja#

Jibu linaonyesha "Not delivered" — inamaanisha nini, na nianze na nini?

Kila ujumbe unaotoka kwenye kikasha una kiashiria cha uwasilishaji: Queued (majibu yaliyoandikwa karibu karibu huunganishwa na kutoka kama barua pepe moja ndani ya dakika chache), Sending…, Sent, Delivered, au hitilafu nyekundu. Hitilafu huja kwa namna tatu: Not delivered — kituo kilikataa ujumbe; Bounced pamoja na aina ndogo ya kurudishwa kando yake — seva ya barua pepe ya mpokeaji ilikataa ujumbe; na Marked as spam — mpokeaji aliuripoti. Weka kishale juu ya lebo au ibofye: kidokezo hubeba maneno ya mtoa huduma mwenyewe, ikiwemo uchunguzi ghafi wa SMTP kwa ujumbe uliorudishwa. Kando yake kuna hadi vitendo viwili — Retry / Send again, ambacho kweli hutuma upya, na Ask Copilot (kuuliza Copilot), ambacho hufungua Copilot na hitilafu imeambatishwa. Ikiwa hakuna kitufe cha kujaribu tena kabisa, anwani imezuiwa na kutuma tena kungeshindwa vivyo hivyo. Sent au Delivered yenye maandishi N files not delivered kando yake inamaanisha maandishi yalifika lakini kiambatisho hakikufika — kituo hicho hakikuweza kubeba faili.

Kwa nini barua pepe yangu haikumfikia mteja?

Kuna sababu nne tofauti, na lebo ndiyo inayozitofautisha. Kurudishwa kwa kudumu kunamaanisha anwani haipo au inakataa barua — hakuna kitufe cha kujaribu tena, na anwani huingia kwenye orodha ya kuzuia. Kurudishwa kwa muda ni kisanduku kilichojaa au tatizo la kupita la seva inayopokea; Send again hutolewa na mara nyingi hufanya kazi baadaye. Kurudishwa ambako uchunguzi wake unataja SPF, DKIM, DMARC au 5.7.515 ni tofauti: mfumo wa barua pepe wa mpokeaji ulikataa ujumbe kwa sababu kikoa chako cha kutuma kilishindwa ukaguzi wa uthibitishaji. Kila jibu jipya litarudishwa kwa njia ile ile hadi kikoa kirekebishwe, kwa hivyo jibu kupitia kituo kingine kwa muda huo na urekebishe rekodi za DNS za kituo cha barua pepe katika Settings → Channels. Mwisho, Marked as spam inamaanisha mpokeaji alibonyeza "ripoti taka": anwani huzuiwa na tunaacha kutuma kwake. Ripoti ya kampeni inaweza kuonyesha zaidi The email provider rejected this message — kukataliwa kwa kudumu kabla hata barua pepe haijaondoka, kwa kawaida kikoa cha kutuma kisichothibitishwa au anwani yenye muundo mbovu — na The email provider rejected our credentials, ambalo ni tatizo la usanidi wa nafasi yako ya kazi, si la mwasiliani huyo mmoja.

Orodha ya kuzuia ni nini, na anwani huondolewaje kwenye orodha hiyo?

Ni orodha ya faragha ya nafasi yako ya kazi yenye anwani za barua pepe ambazo Respondo inakataa kutuma kwazo. Anwani huingia humo ujumbe unaporudishwa kwa kudumu (kukataliwa kusikoweza kubadilika), mtu anaporipoti mojawapo ya barua pepe zako kama taka, au inapozuiwa kwa mkono. Kurudishwa kwa muda hakuzuii anwani kamwe. Wakati zuio linaendelea, uwasilishaji wa kampeni kwake huachwa na ujumbe This address is blocked after an earlier bounce or complaint, na jibu la kikashani hukataliwa kabla halijatoka. Ni mpokeaji halisi wa ujumbe tu ndiye huzuiwa — arifa ya kurudishwa haiwezi kuzuia anwani yoyote ile. Hakuna skrini ya orodha hii kwenye dashibodi: mmiliki au msimamizi anaweza kuisoma kwa GET https://api.respondo.ai/api/v1/integrations/email/suppressions na kuondoa kipengele kimoja kwa DELETE https://api.respondo.ai/api/v1/integrations/email/suppressions/<email>, au kuomba msaada wa Respondo aifanye. Ondoa zuio la kurudishwa kwa kudumu pale tu unapojua kisanduku kimerekebishwa kweli — kutuma tena kwa anwani iliyokufa kunaharibu sifa ya kikoa chako.

WhatsApp haikubali jibu langu — dirisha la saa 24

WhatsApp huruhusu biashara kutuma ujumbe wa kawaida ndani ya saa 24 tu tangu ujumbe wa mwisho wa mteja; chochote kinachofuata baada ya hapo Meta hukikataa kwa hitilafu 131047. Respondo hufuatilia dirisha hilo kwa kila mtu, na inapojua dirisha limekwisha huzuia jibu kabla halijatumwa. Respondo isipokuwa na kumbukumbu yoyote ya dirisha — mwasiliani aliyeingizwa, au namba ambayo haijawahi kukuandikia — haizuii: ujumbe huenda kwa Meta na Meta ndiye huamua. Kuna njia mbili tu za kusonga mbele. Subiri mteja aandike tena — ujumbe wake hufungua dirisha kwa saa nyingine 24 na jibu lako hupita — au tuma kiolezo kilichoidhinishwa na Meta. Violezo haviwezi kutumwa kutoka eneo la kuandika la mazungumzo. Vidhibiti katika Outbound → WhatsApp templates: Sync huleta vile vilivyosajiliwa tayari kwenye namba yako, New template huwasilisha kimoja kwa Meta, ambaye ukaguzi wake huchukua siku moja au zaidi. Kisha tuma kiolezo kilichoidhinishwa kupitia kampeni ya nje inayolenga mwasiliani huyo. Kiolezo huwafikia watu walio ndani na nje ya dirisha sawasawa, lakini tu wakati hali yake ni approved.

"That channel is disconnected" / "That channel is not connected" — kituo kimetenganishwa au hakijaunganishwa

Disconnected inamaanisha muunganisho upo lakini haufanyi kazi tena — tokeni yake ya ufikiaji ilibatilishwa au muda wake uliisha, au mtu aliitenganisha. Not connected inamaanisha anwani ya mwasiliani haina muunganisho wowote nyuma yake. Vyote viwili hurekebishwa katika Settings → Channels, ambapo vituo vilivyotenganishwa hukusanywa chini ya kichwa chake, na kila kadi ina kitufe cha Reconnect; unganisha upya, kisha jaribu ujumbe tena. Kesi mbili jirani zinaonekana sawa lakini si sawa: kituo cha barua pepe ambacho kikoa chake cha kutuma hakijathibitishwa hakiwezi kuwekwa Live na hakitumi chochote hadi DKIM na SPF zithibitishwe, na kituo cha kupokea pekee hukataa ujumbe unaotoka kwa muundo wake, kwa hivyo Retry hapo haitafanikiwa kamwe.

"No channel to reach this person on" / "No email address on this contact" — hakuna kituo wala anwani

Zote mbili huonekana kwenye ripoti ya uwasilishaji ya kampeni, si kikashani. Ya kwanza inamaanisha hakuna anwani yoyote ya mwasiliani inayolingana na vituo ambavyo kampeni hutumia; ikiwa anwani yake pekee iko kwenye kituo cha kupokea pekee, hilo huripotiwa kando kama kuachwa kwa makusudi. Ya pili inamaanisha kampeni hutuma barua pepe lakini mwasiliani hana anwani iliyohifadhiwa. Telegram ina hali yake ya kipekee: mtu asipowahi kuandikia boti yako hakuna gumzo la kumwandikia, kwa sababu Bot API hukataza boti kuanzisha mazungumzo — ni lazima yeye atume ujumbe wa kwanza. Rekebisha haya kwa kuongeza anwani inayokosekana kwa mwasiliani, kwa kupanua vituo ambavyo kampeni inalenga, au kwa kuiruhusu irudi kwenye barua pepe.

Mwasiliani amejiondoa — naweza kutuma nini?

They had already unsubscribed inamaanisha mwasiliani ana kujiondoa kwa jumla — kulikowekwa kupitia kiungo cha kujiondoa katika mojawapo ya barua pepe zako, kulikoingizwa kwa uingizaji wa data, au kulikowashwa na mwenzako. Kampeni na mfululizo huwaruka wawasiliani hao kwenye kila kituo, si barua pepe pekee, na uwasilishaji huandikwa kama kuachwa badala ya hitilafu. Jibu la mtu mmoja kwa mmoja kutoka kwa mwenzako ndani ya mazungumzo kwa makusudi halizuiliwi na hilo: kujiondoa kunahusu matangazo ya jumla, na kumjibu mtu aliyekuandikia ni uamuzi wa kibinadamu. Hali hii huonyeshwa kwenye mwasiliani kama Outbound: Subscribed / Unsubscribed, orodha ya wawasiliani inaweza kuchujwa kwa hiyo, na kitufe cha Re-subscribe kwenye mwasiliani hurudisha hali nyuma — tumia hicho pale tu mtu mwenyewe alipokuomba.

Mnajaribu tena mara ngapi, na je, kubonyeza Retry ni salama?

Jibu kutoka kikashani hukabidhiwa kwa foleni inayofanya hadi majaribio matano, ikisubiri takriban dakika 3, 10, 30 na 30 kati yake. Ni hitilafu za muda tu ndizo hujaribiwa tena — muda kuisha, miunganisho iliyokataliwa, vikomo vya kasi, hitilafu za seva ya mtoa huduma mwenyewe. Kukataliwa kwa kudumu (anwani isiyojulikana, kikoa cha kutuma kisichothibitishwa, vitambulisho vilivyokataliwa) huwekwa alama ya kushindwa mara moja, kwa sababu kurudia kungeleta jibu lile lile. Uwasilishaji wa kampeni huendeshwa kwenye foleni yake yenyewe yenye hadi majaribio sita na subira fupi zaidi — sekunde 5, sekunde 30, dakika 2, dakika 10; hayo yakiisha, uwasilishaji hufungwa kwa Delivery kept failing and was stopped after several attempts badala ya kubaki kwenye "queued" milele. Kubonyeza Retry kwa mkono ni salama. Hufanya kazi tu kwa ujumbe ambao kweli uko katika hali ya kushindwa, na kwa barua pepe kwanza huuliza mtoa huduma nini kilitokea kwa ujumbe wa asili: ikiwa barua pepe hiyo ilitoka kweli, safu hubadilika kuwa imewasilishwa badala ya kutuma nakala ya pili, na utumaji upya halisi huondoka na ufunguo mpya wa idempotency. Pale ambapo nakala ya pili ingekuwa kosa — kurudishwa kwa kudumu, malalamiko ya taka, ujumbe ambao bado uko njiani — kitufe hakipo au jaribio hukataliwa na sababu yake.

Chanzo bado hakieleweki — ninapataje msaada?

Kila ujumbe ulioshindwa una kitufe cha Ask Copilot kando yake. Kinafungua Copilot na hitilafu, kituo na mazungumzo vimeambatishwa, na Copilot hujibu kutoka kwa nyaraka za msaada za Respondo yenyewe kwa hatua za hitilafu hiyo hasa. Msaada huu ni bure — hauhesabiwi katika maombi yako ya AI. Ikiwa hatua hazitatui tatizo, sema hivyo — "haikusaidia" inatosha. Kisha Copilot hutoa kadi inayokabidhi tatizo kwa timu ya Respondo: kadi huorodhesha hasa kitakachotumwa, hakuna kinachotoka hadi uthibitishe, na jibu lao hufika katika uzi ule ule wa Copilot. Ikiwa kukabidhi hakupatikani, Copilot husema hivyo waziwazi badala ya kunyamaza.