FAQ
Kailangan bang mag-install ng kahit ano ang mga user?
Hindi. Isang script tag lang ang ipe-paste ng mga user sa HTML nila — walang npm package, walang build step, walang dependency. Kusang naglo-load ang mga karagdagang tampok mula sa parehong origin.
Magbabanggaan ba ito sa CSS ko?
Hindi. Nagre-render ang widget sa loob ng Shadow DOM, kaya lubusang nakahiwalay ang mga estilo nito sa pahina ninyo.
Sinusuportahan ba nito ang single-page apps (React, Vue, Next.js)?
Oo. Minsan lang naglo-load ang script at nananatili ito habang nagpapalit ng route. Para sa React/Next.js, ilagay ang script sa root layout ninyo.
// 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>
);
}Ano ang nangyayari kapag nalutas ang usapan?
Ang bagong mensahe pagkatapos ng paglutas ay kusang nagbubukas ng follow-up na usapang nakaugnay sa nauna (ipinapakita bilang "Continued from #N" sa inbox ninyo). Nadadala ang kontekstong tulad ng wika at ang naunang transcript, at isang tuloy-tuloy na chat ang nakikita ng bisita. Kung kasamahan ang humahawak sa nalutas na usapan, ibinabalik ang follow-up sa koponan ninyo sa halip na sa AI; kung hindi, ang AI ang humahawak.
Paano naglo-load ang widget?
Asynchronous ang pag-load ng widget (async), kaya hindi nito kailanman hinaharangan ang pag-render ng pahina. Ang core bundle ay ~180KB (~50KB kapag naka-gzip); ang mga opsyonal na tampok (mga campaign, product tour) ay naglo-load bilang hiwalay na mga lazy chunk pagkatapos ma-mount ang widget, kaya hindi kailanman naaantala ang unang pag-render ng pahina.
Paano gumagana ang pag-escalate?
Puwedeng pindutin ng mga user ang butones na "Talk to human", mag-type ng pariralang humihingi ng taong kausap, o kusang nagpapasa ang AI kapag hindi ito makasagot mula sa base ng kaalaman ninyo. Kapag na-escalate na, hihinto sa pagsagot ang AI at naipapasa sa koponan ninyo ng suporta ang lahat ng sumunod na mensahe. Tingnan ang seksyong Pag-escalate at Pagpapasa para sa mga detalye.
Puwede bang magpatuloy ang mga user sa pakikipag-usap sa AI pagkatapos ng pag-escalate?
Oo. Nagpapakita ang widget ng butones na "Continue with AI" na nagpapahintulot sa user na alisin ang pag-escalate at ipagpatuloy ang usapan sa AI.
Knowledge base at pag-crawl ng website#
Bakit naka-block ang pag-crawl ng website ko?
Ang "naka-block" ay nangangahulugang tinanggihan ng site — o ng proteksyon nito (Cloudflare, isang WAF, isang anti-bot plugin) — ang aming crawler: ang panimulang pahina o ang robots.txt ay sumagot sa bawat pagtatangka ng access error o ng "sinusuri ang iyong browser" na challenge, o tahasang ipinagbabawal ng robots.txt ang aming crawler. Nananatiling buo ang mga pahinang na-import na noon, at ang re-sync ay mabibigo sa parehong paraan hangga't hindi kami pinapapasok ng site. Hilingin sa may-ari ng site na payagan ang User-Agent na RespondoAI-Crawler (buong string: Mozilla/5.0 (compatible; RespondoAI-Crawler/1.0; +https://respondo.ai/bot)) sa kanilang mga setting ng proteksyon — sa Cloudflare ito ay Security → WAF → Custom rules — at, kung robots.txt ang sanhi, magdagdag ng allow rule para sa User-agent: RespondoAI-Crawler. Hindi naglalathala ang Respondo ng nakapirming IP address ng crawler — mag-allow-list ayon sa User-Agent; kung may binabanggit na IP ang error na ipinapakita sa source, payagan din iyon. Kung hindi mababago ang site, idagdag na lang ang parehong nilalaman bilang mga file o naka-paste na teksto.
Natapos ang crawl pero iilang pahina lang ang nahanap
Natutuklasan namin ang mga pahina mula sa sitemap ng site (ang linyang Sitemap: sa robots.txt o mga karaniwang lokasyon tulad ng /sitemap.xml) at sa pagsunod sa mga link mula sa panimulang URL — hanggang 10 antas ng link ang lalim at hanggang 5,000 pahina bawat source. Ang mga pahina lang sa parehong site at nasa ilalim ng path ng panimulang URL ang ini-import: ang crawl na sinimulan sa https://example.com/help ay nilalaktawan ang /blog, kaya magsimula sa root o magdagdag ng mga include path. Hindi mahahanap ang mga pahinang walang link o sitemap na tumuturo, ang mga pahinang ipinagbabawal ng robots.txt, at ang mga pahinang nasa likod ng login. Ang halos magkaparehong pahina (print version, mga variant na may tracking parameter) ay pinagsasama sa isa. Ang mga pahinang ang nilalaman ay buong iginuguhit ng JavaScript ay natutukoy at nire-render gamit ang browser-based na fallback, kaya ang kaunting bilang ng pahina ay karaniwang tanda ng problema sa saklaw o sitemap, hindi sa rendering.
Paano ko lilimitahan ang crawl sa isang seksyon ng site?
Buksan ang Advanced sa dialog ng pagdaragdag ng website at punan ang Only crawl paths starting with (i-crawl lang ang mga path na nagsisimula sa) at/o Skip paths starting with (laktawan ang mga path na nagsisimula sa) — isang path bawat linya, hanggang 50 bawat field. Ang pagtutugma ay ayon sa buong segment ng path: ang /docs ay tumutugma sa /docs at /docs/getting-started, pero hindi sa /docs-archive; binabalewala ang trailing slash, at maaari kang mag-paste ng buong URL — ang path lang nito ang ginagamit. Nangingibabaw ang mga skip rule sa mga include rule. Ang parehong mga patakaran ay nalalapat sa sitemap at sa bawat susunod na re-sync ng source na iyon.
Gaano kadalas muling nag-crawl ang Respondo sa website ko?
Bawat website source ay may Auto-refresh na iskedyul sa panel ng mga pahina nito: Off (naka-off), Daily (bawat 24 oras) o Weekly (bawat 7 araw). Ang naka-iskedyul na crawl ay incremental: nilalaktawan ang mga pahinang ang lastmod sa sitemap ay mas luma kaysa sa nakaraang crawl, hindi muling ini-index ang mga pahinang hindi nagbago, muling ini-index ang mga nagbago, at inaalis ang mga nawala. Para mag-refresh agad, gamitin ang Re-sync sa menu ng source o ang Re-sync all sa pahinang Knowledge.
"Hindi namin nabasa ang site sa pagkakataong ito" — ano ang nangyari?
Ito ang pangkalahatang pagkabigo: hindi tumugon sa oras ang site, hindi na-resolve ang domain, nagbalik ng error ang server, walang nababasang teksto ang panimulang pahina, o hindi nahanap ang address. Ipinapakita sa source ang detalye. Tiyaking bumubukas ang URL sa isang private browser window, walang typo sa domain, at ang panimulang pahina ay tunay na pahina ng nilalaman at hindi login screen. Ang mga social network at messaging platform (Facebook, Instagram, LinkedIn, X, YouTube at katulad nito) ay hindi talaga maaaring i-import — tinatanggihan ang mga ito bago pa magsimula ang crawl. Pinapanatili ang iyong mga kasalukuyang pahina; ang naka-iskedyul na source ay muling susubok sa susunod na run, kung hindi, mag-re-sync kapag naa-access na ulit ang site.
Ano ang ibig sabihin ng "puno na ang aming search index" at "hindi namin na-index ang source na ito"?
Parehong lumalabas ang mga ito pagkatapos matagumpay na mabasa ang nilalaman. Ang Puno ang index ay nangangahulugang wala nang espasyo sa panig ng Respondo ang search index na pinagkokopyahan ng source na ito — limitasyon ito ng Respondo, hindi problema sa iyong nilalaman. Nakaimbak ang mga pahina, patuloy na sumasagot ang lahat ng na-index na, awtomatikong naaabisuhan ang aming team, at ii-index ang source kapag may espasyo na; ang mas maagang re-sync ay mabibigo sa parehong paraan. Ang Hindi na-index ang source na ito ay nangangahulugang nabigo ang pagbuo ng search index sa pagkakataong ito — pansamantalang error sa aming panig; buo ang kasalukuyang data at awtomatikong sinusubukan ulit ang gawain. Kung magpapatuloy ang alinmang mensahe, gamitin ang "Tanong sa Copilot" sa error.
Sinasagot ba ang mahahabang pahina mula lang sa simula nito?
Hindi. Bawat na-crawl na pahina ay hinahati sa magkakapatong na piraso na humigit-kumulang 1,600 character, bawat isa ay hiwalay na ini-index kasama ang pamagat ng pahina, kaya maaaring manggaling ang sagot sa anumang bahagi ng mahabang artikulo. Isang link pa rin bawat pahina ang ipinapakita ng mga citation. Ang mga pahinang na-import bago ang pagbabagong ito ay muling hinahati sa mga susunod nilang re-sync.
Paano ako makakakuha ng tulong sa isang crawl error?
Bawat crawl o indexing error sa pahinang Knowledge ay may kasamang button na Tanong sa Copilot. Binubuksan nito ang Copilot na nakakabit ang error, at sumasagot ang Copilot mula sa sariling dokumentasyon ng tulong ng Respondo na may kongkretong hakbang para sa iyong kaso. Libre ang tulong na ito — hindi ito binibilang sa iyong mga AI request. Kung hindi nalutas ng mga hakbang, sabihin lang ito — sapat na ang "hindi nakatulong". Mag-aalok pagkatapos ang Copilot ng card na nagpapasa ng problema sa Respondo team: nakalista sa card kung ano mismo ang ipapadala, walang aalis hangga't hindi mo kinukumpirma, at darating ang kanilang sagot sa parehong Copilot thread. Kung hindi available ang pagpapasa, tuwirang sasabihin iyon ng Copilot sa halip na manahimik.
Mga mensaheng hindi nakakarating sa customer#
May sagot na nakasaad na "Not delivered" — ano ang ibig sabihin nito, at ano ang unang gagawin ko?
Bawat papalabas na mensahe sa inbox ay may indicator ng paghahatid: Queued (nasa pila — ang mga sagot na magkakasunod na naisulat ay pinagsasama at lumalabas bilang isang email sa loob ng ilang minuto), Sending… (ipinapadala), Sent (naipadala), Delivered (nakarating), o isang pulang pagkabigo. Tatlong hugis ang pagkabigo: Not delivered — tinanggihan ng channel ang mensahe; Bounced na may sub-type ng bounce sa tabi nito — tinanggihan ng mail server ng tatanggap ang email; at Marked as spam — ini-report ito ng tatanggap. I-hover o i-click ang label: dala ng tooltip ang mismong pananalita ng provider, kasama ang hilaw na SMTP diagnostic para sa isang bounce. Sa tabi nito ay may hanggang dalawang aksyon — Retry / Send again, na talagang muling nagpapadala, at Ask Copilot, na nagbubukas ng Copilot na nakakabit ang error. Kung wala man lang retry button, naka-block ang address at mabibigo rin sa parehong paraan ang muling pagpapadala. Ang isang Sent o Delivered na may N files not delivered sa tabi ay nangangahulugang nakarating ang teksto pero hindi ang isang attachment — hindi kayang dalhin ng channel na iyon ang file.
Bakit hindi nakarating sa customer ang email ko?
Apat na magkakaibang bagay, at pinagkakaiba sila ng label. Ang permanente na bounce ay nangangahulugang wala ang address o ayaw nitong tumanggap ng mail — walang retry button, at napupunta ang address sa suppression list. Ang pansamantala na bounce ay punong mailbox o lumilipas na problema sa tumatanggap na server; may Send again na inaalok at karaniwang gumagana ito mamaya. Iba naman ang bounce na ang diagnostic ay bumabanggit ng SPF, DKIM, DMARC o 5.7.515: tinanggihan ng mail system ng tatanggap ang mensahe dahil bumagsak sa authentication check ang iyong sending domain. Babalik sa eksaktong parehong paraan ang bagong sagot hangga't hindi naaayos ang domain, kaya sumagot muna sa ibang channel at ayusin ang mga DNS record ng email channel sa Settings → Channels. Panghuli, ang Marked as spam ay nangangahulugang pinindot ng tatanggap ang "report spam": sinusupil ang address at hihinto kami sa pagpapadala rito. Maaari pang ipakita ng ulat ng kampanya ang The email provider rejected this message — permanenteng pagtanggi bago pa man umalis ang email, kadalasang dahil sa hindi na-verify na sending domain o maling anyo ng address — at ang The email provider rejected our credentials, na problema sa setup ng workspace at hindi tungkol sa iisang contact na iyon.
Ano ang suppression list, at paano nakakaalis dito ang isang address?
Ito ay listahan, pribado sa iyong workspace, ng mga email address na tinatanggihan ng Respondo na padalhan. Napupunta rito ang isang address kapag permanenteng bumalik ang isang mensahe (permanenteng pagtanggi), kapag may nag-report ng isa sa iyong mga email bilang spam, o kapag manu-manong na-block. Hindi kailanman nagsu-suppress ng address ang mga soft bounce. Habang aktibo ang block, nilalaktawan ang mga paghahatid ng kampanya rito nang may This address is blocked after an earlier bounce or complaint, at tinatanggihan ang sagot sa inbox bago pa ito lumabas. Ang tunay na tatanggap lang ng mensahe ang sinusupil — hindi kayang mag-block ng basta-bastang address ang isang bounce notification. Walang screen para sa listahan sa dashboard: mababasa ito ng owner o admin gamit ang GET https://api.respondo.ai/api/v1/integrations/email/suppressions at maaalis ang isang entry gamit ang DELETE https://api.respondo.ai/api/v1/integrations/email/suppressions/<email>, o maaaring hilingin sa suporta ng Respondo na gawin ito. Alisin lang ang isang permanenteng bounce kapag alam mong talagang naayos na ang mailbox — nakakasira sa reputasyon ng iyong domain ang muling pagpapadala sa patay na address.
Ayaw tanggapin ng WhatsApp ang sagot ko — ang 24-oras na window
Pinapayagan lang ng WhatsApp ang isang negosyo na magpadala ng malayang mensahe sa loob ng 24 oras mula sa huling mensahe ng customer; tinatanggihan ng Meta ang anumang mas huli pa gamit ang error na 131047. Sinusubaybayan ng Respondo ang window na iyon kada tao, at kapag alam nitong lumipas na ang window, hinihinto nito ang sagot bago pa maipadala. Kapag walang anumang tala ng window ang Respondo — isang na-import na contact, o isang numerong hindi pa sumusulat sa iyo — hindi ito nagba-block: napupunta ang mensahe sa Meta at ang Meta ang magpapasya. Dalawa lang ang paraan pasulong. Hintaying sumulat muli ang customer — muling binubuksan ng kanilang mensahe ang window nang 24 oras pa at doon dadaan ang sagot mo — o magpadala ng template na aprubado ng Meta. Hindi maipapadala ang mga template mula sa composer ng usapan. Pamahalaan ang mga ito sa Outbound → WhatsApp templates: hinihila ng Sync ang mga nakarehistro na sa iyong numero, isinusumite ng New template ang bago sa Meta, at ang pagsusuri nila ay tumatagal ng isang araw o higit pa. Pagkatapos ay ipadala ang aprubadong template sa pamamagitan ng outbound campaign na nakatutok sa contact na iyon. Nakakarating ang template sa mga taong nasa loob at labas ng window nang pareho, pero habang approved lang ang status nito.
"That channel is disconnected" / "That channel is not connected"
Ang Disconnected (nadiskonekta) ay nangangahulugang umiiral ang integration pero hindi na ito aktibo — nabawi o nag-expire ang access token nito, o may nagdiskonekta. Ang Not connected (hindi nakakonekta) naman ay nangangahulugang walang integration man lang sa likod ng endpoint ng contact. Pareho itong naaayos sa Settings → Channels, kung saan pinagsasama-sama ang mga nadiskonektang channel sa ilalim ng sariling heading na may Reconnect na button sa bawat card; kumonekta muli, saka ulitin ang mensahe. May dalawang katabing kaso na magkamukha pero hindi pareho: ang email channel na hindi na-verify ang sending domain ay hindi maililipat sa Live at walang ipapadala hangga't hindi nakukumpirma ang DKIM at SPF, at ang receive-only na channel ay tumatanggi sa papalabas na mensahe bilang disenyo, kaya hindi kailanman magtatagumpay ang Retry doon.
"No channel to reach this person on" / "No email address on this contact"
Pareho itong lumalabas sa delivery report ng kampanya at hindi sa inbox. Ang una ay nangangahulugang walang endpoint ng contact na tumugma sa mga channel na pinagpapadalhan ng kampanya; kung ang tanging endpoint nila ay nasa receive-only na channel, hiwalay itong iniuulat bilang sinadyang paglaktaw. Ang pangalawa ay nangangahulugang nagpapadala ng email ang kampanya pero walang nakatalang address ang contact. May sariling bersyon nito ang Telegram: kung hindi pa sumusulat ang tao sa bot mo, walang chat na masusulatan, dahil ipinagbabawal ng Bot API na maunang mag-message ang isang bot — sila ang dapat magpadala ng unang mensahe. Ayusin ito sa pamamagitan ng pagdaragdag ng nawawalang address sa contact, ng pagpapalawak ng mga channel na tinutugunan ng kampanya, o ng pagpapahintulot ditong bumalik sa email.
Nag-unsubscribe ang contact — ano ang puwede kong ipadala?
Ang They had already unsubscribed ay nangangahulugang may pandaigdigang opt-out ang contact — itinakda sa pamamagitan ng unsubscribe link sa isa sa iyong mga email, dala ng isang import, o tinoggle ng kasamahan. Nilalaktawan ng mga kampanya at series ang gayong contact sa bawat channel, hindi lang email, at naitatala ang paghahatid bilang laktaw at hindi bilang pagkabigo. Ang isa-sa-isang sagot ng kasamahan sa loob ng usapan ay sadyang hindi hinaharangan nito: tungkol sa broadcast ang opt-out, at desisyon ng tao ang pagsagot sa isang taong sumulat sa iyo. Ipinapakita ang estado sa contact bilang Outbound: Subscribed / Unsubscribed, mafi-filter ang listahan ng contact ayon dito, at binabaligtad ito ng Re-subscribe na button sa contact — gamitin lang iyon kapag sila mismo ang humiling.
Ilang beses kayong nagre-retry, at ligtas bang pindutin ang Retry?
Ang sagot mula sa inbox ay ipinapasa sa isang queue na umaabot sa limang pagtatangka, na may humigit-kumulang 3, 10, 30 at 30 minutong pagitan. Ang mga pansamantalang pagkabigo lang ang inuulit — timeout, tinanggihang koneksyon, rate limit, at mga server error mismo ng provider. Ang permanenteng pagtanggi (hindi kilalang address, hindi na-verify na sending domain, tinanggihang credential) ay agad na minamarkahang bigo, dahil pareho ring sagot ang babalik sa pag-uulit. Ang mga paghahatid ng kampanya ay tumatakbo sa sariling queue nang may hanggang anim na pagtatangka at mas maiikling paghihintay — 5 segundo, 30 segundo, 2 minuto, 10 minuto; kapag naubos ang mga ito, isinasara ang paghahatid nang may Delivery kept failing and was stopped after several attempts sa halip na manatiling nakaipit sa "queued" nang habang panahon. Ligtas ang manu-manong pagpindot sa Retry. Sa mensaheng talagang nasa failed na estado lang ito kumikilos, at para sa email ay tinatanong muna nito ang provider kung ano ang nangyari sa orihinal: kung talagang lumabas ang email na iyon, nagiging delivered ang row sa halip na magpadala ng pangalawang kopya, at ang tunay na resend ay umaalis nang may bagong idempotency key. Kung saan mali ang pangalawang kopya — hard bounce, reklamong spam, o padalang nasa biyahe pa — wala ang button o tinatanggihan ang retry nang may kasamang dahilan.
Hindi pa rin malinaw ang sanhi — paano ako makakakuha ng tulong?
Bawat nabigong mensahe ay may Ask Copilot na button sa tabi. Binubuksan nito ang Copilot na nakakabit ang error, ang channel at ang usapan, at sumasagot ang Copilot mula sa sariling help documentation ng Respondo nang may mga hakbang para sa mismong pagkabigong iyon. Libre ang tulong na ito — hindi ito binibilang sa iyong mga AI request. Kung hindi nalutas ng mga hakbang, sabihin lang ito — sapat na ang "hindi nakatulong". Mag-aalok pagkatapos ang Copilot ng card na nagpapasa ng problema sa Respondo team: nakalista sa card kung ano mismo ang ipapadala, walang aalis hangga't hindi mo kinukumpirma, at darating ang kanilang sagot sa parehong Copilot thread. Kung hindi available ang pagpapasa, tuwirang sasabihin iyon ng Copilot sa halip na manahimik.