Soalan Lazim
Adakah pengguna perlu memasang apa-apa?
Tidak. Pengguna hanya menampal satu tag skrip ke dalam HTML mereka — tiada pakej npm, tiada langkah binaan, tiada kebergantungan. Ciri tambahan dimuatkan secara automatik daripada origin yang sama.
Adakah ia akan bercanggah dengan CSS saya?
Tidak. Widget dipaparkan di dalam Shadow DOM, mengasingkan gayanya sepenuhnya daripada halaman anda.
Adakah ia menyokong aplikasi satu halaman (React, Vue, Next.js)?
Ya. Skrip dimuatkan sekali dan kekal merentas perubahan laluan. Untuk React/Next.js, letakkan skrip dalam susun atur akar anda.
// 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>
);
}Apa yang berlaku apabila sesuatu perbualan diselesaikan?
Mesej baharu selepas penyelesaian membuka perbualan susulan yang berpaut pada perbualan sebelumnya secara automatik (dipaparkan sebagai "Continued from #N" dalam peti masuk anda). Konteks seperti bahasa dan transkrip terdahulu dibawa bersama, dan pelawat melihat satu sembang yang berterusan. Jika seorang ahli pasukan sedang mengendalikan perbualan yang diselesaikan itu, susulan dihalakan kembali kepada pasukan anda dan bukannya AI; jika tidak, AI mengambilnya.
Bagaimana widget dimuatkan?
Widget dimuatkan secara tak segerak (async), jadi ia tidak pernah menyekat pemaparan halaman. Himpunan teras ialah ~180KB (~50KB gzip); ciri pilihan (kempen, lawatan produk) dimuatkan sebagai ketulan malas yang berasingan selepas widget dilekapkan, jadi pemaparan awal halaman tidak pernah disekat.
Bagaimana eskalasi berfungsi?
Pengguna boleh mengklik butang "Bercakap dengan manusia", menaip frasa yang meminta manusia, atau AI menyerahkan sendiri apabila ia tidak dapat menjawab daripada pangkalan pengetahuan anda. Setelah dieskalasi, AI berhenti membalas dan semua mesej susulan dimajukan kepada pasukan sokongan anda. Lihat bahagian Eskalasi & Serahan untuk butiran lanjut.
Bolehkah pengguna terus bersembang dengan AI selepas eskalasi?
Ya. Widget memaparkan butang "Teruskan dengan AI" yang membolehkan pengguna menolak eskalasi dan menyambung semula perbualan dengan AI.
Pangkalan pengetahuan & rangkakan laman web#
Mengapa rangkakan laman web saya disekat?
"Disekat" bermaksud laman — atau lapisan perlindungannya (Cloudflare, WAF, pemalam anti-bot) — menolak perangkak kami: halaman permulaan atau robots.txt membalas setiap percubaan dengan ralat akses atau cabaran "menyemak pelayar anda", atau robots.txt secara jelas melarang perangkak kami. Halaman yang telah diimport sebelum ini kekal utuh, dan segerak semula akan gagal dengan cara yang sama sehingga laman membenarkan kami masuk. Minta pemilik laman membenarkan User-Agent RespondoAI-Crawler (rentetan penuh: Mozilla/5.0 (compatible; RespondoAI-Crawler/1.0; +https://respondo.ai/bot)) dalam tetapan perlindungan mereka — di Cloudflare ia berada di Security → WAF → Custom rules — dan, jika puncanya robots.txt, menambah peraturan benarkan untuk User-agent: RespondoAI-Crawler. Respondo tidak menerbitkan alamat IP perangkak yang tetap — benarkan mengikut User-Agent; jika ralat yang dipaparkan pada sumber menamakan IP, benarkan IP itu juga. Jika laman tidak boleh diubah, tambahkan kandungan yang sama sebagai fail atau teks yang ditampal.
Rangkakan selesai tetapi hanya menemui beberapa halaman
Kami menemui halaman daripada peta laman (baris Sitemap: dalam robots.txt atau lokasi biasa seperti /sitemap.xml) dan dengan mengikuti pautan dari URL permulaan — sehingga 10 lapisan pautan dan sehingga 5,000 halaman setiap sumber. Hanya halaman pada laman yang sama dan di bawah laluan URL permulaan diimport: rangkakan yang bermula di https://example.com/help melangkau /blog, jadi mulakan dari akar atau tambahkan laluan yang disertakan. Halaman yang tidak dirujuk oleh mana-mana pautan atau peta laman, halaman yang dilarang robots.txt, dan halaman di sebalik log masuk tidak akan ditemui. Halaman yang hampir serupa (versi cetak, varian dengan parameter penjejakan) digabungkan menjadi satu. Halaman yang kandungannya dilukis sepenuhnya oleh JavaScript dikesan dan dirender dengan mekanisme sandaran berasaskan pelayar, jadi bilangan halaman yang rendah biasanya bermaksud isu skop atau peta laman, bukan rendering.
Bagaimana saya menghadkan rangkakan kepada satu bahagian laman?
Buka Advanced dalam dialog tambah laman web dan isikan Only crawl paths starting with (hanya rangkak laluan yang bermula dengan) dan/atau Skip paths starting with (langkau laluan yang bermula dengan) — satu laluan setiap baris, sehingga 50 setiap medan. Padanan dibuat mengikut segmen laluan penuh: /docs sepadan dengan /docs dan /docs/getting-started, tetapi tidak dengan /docs-archive; garis condong di hujung diabaikan, dan anda boleh menampal URL penuh — hanya laluannya digunakan. Peraturan langkau mengatasi peraturan sertakan. Peraturan yang sama digunakan untuk peta laman dan untuk setiap segerak semula seterusnya bagi sumber itu.
Berapa kerap Respondo merangkak semula laman web saya?
Setiap sumber laman web mempunyai jadual Auto-refresh dalam panel halamannya: Off (mati), Daily (setiap 24 jam) atau Weekly (setiap 7 hari). Rangkakan berjadual bersifat tokokan: halaman yang lastmod dalam peta lamannya lebih lama daripada rangkakan sebelumnya dilangkau, halaman yang tidak berubah tidak diindeks semula, halaman yang berubah diindeks semula dan halaman yang hilang dibuang. Untuk menyegarkan serta-merta, gunakan Re-sync dalam menu sumber atau Re-sync all pada halaman Knowledge.
"Kami tidak dapat membaca laman kali ini" — apa yang berlaku?
Ini ialah kegagalan umum: laman tidak membalas tepat pada masanya, domain tidak dapat diselesaikan, pelayan mengembalikan ralat, halaman permulaan tiada teks yang boleh dibaca, atau alamat tidak ditemui. Butirannya dipaparkan pada sumber. Semak bahawa URL dibuka dalam tetingkap peribadi pelayar, tiada kesilapan ejaan dalam domain dan halaman permulaan ialah halaman kandungan sebenar, bukan skrin log masuk. Rangkaian sosial dan platform pemesejan (Facebook, Instagram, LinkedIn, X, YouTube dan seumpamanya) langsung tidak boleh diimport — ia ditolak sebelum rangkakan bermula. Halaman sedia ada anda dikekalkan; sumber berjadual mencuba semula pada larian seterusnya, jika tidak, segerak semula apabila laman boleh dicapai semula.
Apa maksud "indeks carian kami penuh" dan "kami tidak dapat mengindeks sumber ini"?
Kedua-duanya muncul selepas kandungan berjaya dibaca. Indeks penuh bermaksud indeks carian tempat sumber ini disalin tiada ruang di pihak Respondo — had Respondo, bukan masalah dengan kandungan anda. Halaman disimpan, semua yang telah diindeks terus menjawab, pasukan kami dimaklumkan secara automatik dan sumber akan diindeks sebaik sahaja ada ruang; segerak semula lebih awal akan gagal dengan cara yang sama. Tidak dapat mengindeks sumber ini bermaksud pembinaan indeks carian gagal kali ini — ralat sementara di pihak kami; data sedia ada utuh dan tugas dicuba semula secara automatik. Jika mana-mana mesej berterusan, gunakan "Tanya Copilot" pada ralat tersebut.
Adakah halaman panjang hanya dijawab daripada bahagian awalnya?
Tidak. Setiap halaman yang dirangkak dibahagikan kepada cebisan bertindih kira-kira 1,600 aksara, setiap satu diindeks berasingan dengan tajuk halaman dilampirkan, jadi jawapan boleh datang daripada mana-mana bahagian artikel yang panjang. Petikan masih menunjukkan satu pautan setiap halaman. Halaman yang diimport sebelum perubahan ini dibahagikan semula pada segerak semula seterusnya.
Bagaimana saya mendapatkan bantuan untuk ralat rangkakan?
Setiap ralat rangkakan atau pengindeksan pada halaman Knowledge disertakan butang Tanya Copilot. Ia membuka Copilot dengan ralat dilampirkan, dan Copilot menjawab daripada dokumentasi bantuan Respondo sendiri dengan langkah konkrit untuk kes anda. Bantuan ini percuma — ia tidak dikira dalam permintaan AI anda. Jika langkah tersebut tidak menyelesaikannya, katakan sahaja — "itu tidak membantu" sudah memadai. Copilot kemudian menawarkan kad yang menyerahkan masalah kepada pasukan Respondo: kad itu menyenaraikan dengan tepat apa yang akan dihantar, tiada apa-apa dihantar sehingga anda mengesahkannya, dan balasan mereka tiba dalam bebenang Copilot yang sama. Jika penyerahan tidak tersedia, Copilot akan menyatakannya secara terus terang dan bukannya berdiam diri.
Mesej yang tidak sampai kepada pelanggan#
Balasan menunjukkan "Not delivered" — apa maksudnya dan apa yang perlu dibuat dahulu?
Setiap mesej keluar dalam peti masuk membawa penunjuk penghantaran: Queued (balasan yang ditulis berdekatan waktunya digabungkan dan keluar sebagai satu e-mel dalam beberapa minit), Sending…, Sent, Delivered, atau kegagalan berwarna merah. Kegagalan datang dalam tiga bentuk: Not delivered — saluran menolak mesej itu; Bounced dengan sub-jenis lantunan di sebelahnya — pelayan mel penerima menolak e-mel itu; dan Marked as spam — penerima melaporkannya. Tuding atau klik label itu: tooltip membawa kata-kata penyedia itu sendiri, termasuk diagnostik SMTP mentah bagi sesuatu lantunan. Di sebelahnya terdapat sehingga dua tindakan — Retry / Send again, yang benar-benar menghantar semula, dan Ask Copilot, yang membuka Copilot dengan ralat itu dilampirkan. Jika tiada butang cuba semula langsung, alamat itu disekat dan menghantar semula akan gagal dengan cara yang sama. Sent atau Delivered yang membawa N files not delivered di sebelahnya bermaksud teksnya sampai tetapi lampiran tidak — saluran itu tidak dapat membawa fail berkenaan.
Mengapa e-mel saya tidak sampai kepada pelanggan?
Empat perkara berbeza, dan labelnya membezakan antara semuanya. Lantunan kekal bermaksud alamat itu tidak wujud atau menolak mel — tiada butang cuba semula, dan alamat itu masuk ke senarai sekatan. Lantunan sementara ialah peti mel yang penuh atau masalah sekejap pada pelayan penerima; Send again ditawarkan dan biasanya berjaya kemudian. Lantunan yang diagnostiknya menyebut SPF, DKIM, DMARC atau 5.7.515 adalah lain: sistem mel penerima menolak mesej itu kerana domain penghantaran anda gagal semakan pengesahannya. Balasan baharu akan melantun dengan cara yang sama sehingga domain itu dibetulkan, jadi jawablah melalui saluran lain sementara itu dan baiki rekod DNS pada saluran e-mel di Settings → Channels. Akhir sekali, Marked as spam bermaksud penerima menekan "report spam": alamat itu disekat dan kami berhenti menghantar kepadanya. Laporan kempen boleh menunjukkan tambahan The email provider rejected this message — penolakan kekal sebelum e-mel itu sempat keluar, biasanya domain penghantaran yang belum disahkan atau alamat yang salah bentuknya — dan The email provider rejected our credentials, yang merupakan masalah persediaan ruang kerja, bukan sesuatu tentang satu kenalan itu.
Apakah senarai sekatan itu, dan bagaimana sesuatu alamat dikeluarkan daripadanya?
Ia ialah senarai alamat e-mel yang Respondo enggan hantar kepadanya, peribadi kepada ruang kerja anda. Sesuatu alamat masuk ke dalamnya apabila mesej melantun kekal (penolakan muktamad), apabila seseorang melaporkan salah satu e-mel anda sebagai spam, atau apabila ia disekat secara manual. Lantunan sementara tidak pernah menyekat alamat. Selagi sekatan itu aktif, penghantaran kempen kepadanya dilangkau dengan This address is blocked after an earlier bounce or complaint, dan balasan dalam peti masuk ditolak sebelum ia keluar. Hanya penerima sebenar mesej itu yang disekat — pemberitahuan lantunan tidak boleh menyekat sebarang alamat lain. Tiada skrin untuk senarai ini dalam papan pemuka: pemilik atau pentadbir boleh membacanya dengan GET https://api.respondo.ai/api/v1/integrations/email/suppressions dan mengangkat satu entri dengan DELETE https://api.respondo.ai/api/v1/integrations/email/suppressions/<email>, atau meminta sokongan Respondo melakukannya. Lepaskan lantunan kekal hanya apabila anda tahu peti mel itu benar-benar telah dibaiki — menghantar semula kepada alamat mati merosakkan reputasi domain anda.
WhatsApp tidak menerima balasan saya — tetingkap 24 jam
WhatsApp membenarkan perniagaan menghantar mesej bentuk bebas hanya dalam tempoh 24 jam selepas mesej terakhir pelanggan; Meta menolak apa-apa selepas itu dengan ralat 131047. Respondo menjejaki tetingkap itu bagi setiap orang, dan apabila ia tahu tetingkap telah tamat, ia menghentikan balasan sebelum dihantar. Apabila Respondo langsung tiada rekod tetingkap — kenalan yang diimport, atau nombor yang tidak pernah menulis kepada anda — ia tidak menyekat: mesej itu pergi kepada Meta dan Meta yang memutuskan. Ada tepat dua jalan ke hadapan. Tunggu pelanggan menulis semula — mesej mereka membuka semula tetingkap untuk 24 jam lagi dan balasan anda kemudiannya menembusi — atau hantar templat yang diluluskan Meta. Templat tidak boleh dihantar dari ruang karang perbualan. Uruskannya di Outbound → WhatsApp templates: Sync menarik apa yang sudah didaftarkan pada nombor anda, New template menghantar satu kepada Meta, yang semakannya mengambil masa sehari atau lebih. Kemudian hantar templat yang diluluskan melalui kempen keluar yang menyasarkan kenalan itu. Templat sampai kepada orang di dalam dan di luar tetingkap sama sahaja, tetapi hanya selagi statusnya approved.
"Saluran itu telah terputus" / "Saluran itu tidak disambungkan"
Disconnected bermaksud integrasi itu wujud tetapi tidak lagi aktif — token aksesnya dibatalkan atau tamat tempoh, atau seseorang memutuskannya. Not connected bermaksud titik hubung kenalan itu langsung tiada integrasi di belakangnya. Kedua-duanya dibetulkan di Settings → Channels, tempat saluran yang terputus dikumpulkan di bawah tajuknya sendiri dengan butang Reconnect pada setiap kad; sambung semula, kemudian cuba semula mesej itu. Dua kes berjiran kelihatan serupa tetapi tidak sama: saluran e-mel yang domain penghantarannya belum disahkan tidak boleh ditukar kepada Live dan tidak menghantar apa-apa sehingga DKIM dan SPF disahkan, manakala saluran terima-sahaja memang direka untuk menolak mesej keluar, jadi Retry di situ tidak akan berjaya.
"Tiada saluran untuk menghubungi orang ini" / "Tiada alamat e-mel pada kenalan ini"
Kedua-duanya muncul pada laporan penghantaran kempen, bukan dalam peti masuk. Yang pertama bermaksud tiada satu pun titik hubung kenalan itu sepadan dengan saluran yang digunakan kempen; jika satu-satunya titik hubung mereka berada pada saluran terima-sahaja, itu dilaporkan berasingan sebagai langkauan yang disengajakan. Yang kedua bermaksud kempen menghantar e-mel tetapi kenalan itu tiada alamat dalam rekod. Telegram ada variannya sendiri: jika orang itu tidak pernah menulis kepada bot anda, tiada sembang untuk ditulis, kerana Bot API melarang bot memulakan mesej — merekalah yang perlu menghantar mesej pertama. Betulkan dengan menambah alamat yang hilang pada kenalan, meluaskan saluran yang disasarkan kempen, atau membiarkannya berundur kepada e-mel.
Kenalan itu berhenti melanggan — apa yang boleh saya hantar?
They had already unsubscribed bermaksud kenalan itu membawa penarikan diri menyeluruh — ditetapkan melalui pautan berhenti melanggan dalam salah satu e-mel anda, dibawa masuk dengan import, atau ditogol oleh rakan sepasukan. Kempen dan siri melangkau kenalan sebegini pada setiap saluran, bukan e-mel sahaja, dan penghantaran itu dicatat sebagai langkauan, bukan kegagalan. Balasan satu-dengan-satu daripada rakan sepasukan di dalam perbualan sengaja tidak disekat olehnya: penarikan diri adalah tentang siaran pukal, dan menjawab orang yang menulis kepada anda ialah keputusan manusia. Keadaannya dipaparkan pada kenalan sebagai Outbound: Subscribed / Unsubscribed, senarai kenalan boleh ditapis mengikutnya, dan butang Re-subscribe pada kenalan itu membalikkannya — gunakannya hanya apabila orang itu memintanya.
Berapa kali anda mencuba semula, dan selamatkah menekan Retry?
Balasan dari peti masuk diserahkan kepada baris gilir yang membuat sehingga lima percubaan, menunggu lebih kurang 3, 10, 30 dan 30 minit antara satu sama lain. Hanya kegagalan sementara dicuba semula — tamat masa, sambungan ditolak, had kadar, ralat pelayan penyedia itu sendiri. Penolakan kekal (alamat tidak dikenali, domain penghantaran belum disahkan, kelayakan ditolak) ditanda gagal serta-merta, kerana ulangan akan mengembalikan jawapan yang sama. Penghantaran kempen berjalan pada baris gilirnya sendiri dengan sehingga enam percubaan dan tempoh menunggu yang lebih singkat — 5 saat, 30 saat, 2 minit, 10 minit; apabila itu habis, penghantaran ditutup dengan Delivery kept failing and was stopped after several attempts dan bukannya tersadai dalam "queued" selama-lamanya. Menekan Retry dengan tangan adalah selamat. Ia hanya bertindak pada mesej yang benar-benar berada dalam keadaan gagal, dan bagi e-mel ia mula-mula bertanya kepada penyedia apa yang berlaku kepada yang asal: jika e-mel itu memang keluar, barisnya bertukar kepada delivered dan bukannya menghantar salinan kedua, dan penghantaran semula yang sebenar keluar di bawah kunci idempotensi yang baharu. Di tempat salinan kedua akan menjadi silap — lantunan kekal, aduan spam, penghantaran yang masih dalam perjalanan — butang itu tiada atau percubaan semula ditolak berserta sebabnya.
Puncanya masih tidak jelas — bagaimana saya mendapatkan bantuan?
Setiap mesej yang gagal membawa butang Ask Copilot di sebelahnya. Ia membuka Copilot dengan ralat, saluran dan perbualan dilampirkan, dan Copilot menjawab daripada dokumentasi bantuan Respondo sendiri dengan langkah-langkah untuk kegagalan itu secara tepat. Bantuan ini percuma — ia tidak dikira terhadap permintaan AI anda. Jika langkah tersebut tidak menyelesaikannya, katakan sahaja — "itu tidak membantu" sudah memadai. Copilot kemudian menawarkan kad yang menyerahkan masalah kepada pasukan Respondo: kad itu menyenaraikan dengan tepat apa yang akan dihantar, tiada apa-apa dihantar sehingga anda mengesahkannya, dan balasan mereka tiba dalam bebenang Copilot yang sama. Jika penyerahan tidak tersedia, Copilot akan menyatakannya secara terus terang dan bukannya berdiam diri.