Lewati ke konten
Delivery API
Sebelum Anda merencanakan berdasarkan sebuah fitur, periksa status kapabilitas.

PanduanInteraksi

Chatbot situs web

Tambahkan chatbot Atlas ke situs web Anda, dengan alur berskrip, jawaban AI dari konten Anda sendiri, dan penangkapan lead.

Halaman ini diterjemahkan dari bahasa Inggris. Jika ada perbedaan, versi bahasa Inggris yang berlaku. Baca dalam bahasa Inggris

  • Alur berskrip yang dibangun di Studio: sapaan, tombol, pertanyaan, dan penangkapan lead.
  • Jawaban AI dari konten terbit situs Anda sendiri, dibayar dengan kredit AI paket Anda. Ketika kredit habis, bot memberikan pesan fallback-nya.
  • Tampilan dan pemicu: warna, gambar peluncur, dan kapan chatbot terbuka, diatur per situs di Studio.
  • Perlindungan Turnstile ketika percakapan tampak otomatis.
  • Lead: detail yang dibagikan pengunjung pada langkah lead masuk ke Forms & leads → Leads, seperti pertanyaan masuk dari formulir.

Belum ada pengalihan langsung ke agen manusia.

Chatbot ikut ke Production di dalam rilis. Ketika Production aktif dan rilis bertanda tangan sedang live, chatbot yang dirilis menjawab pengunjung sungguhan, memakai pengetahuan dari halaman-halaman di rilis tersebut (hingga 5.000 bagian). Perubahan Development sampai ke pengunjung hanya bersama rilis tersetujui berikutnya.

Selama Production nonaktif, alamat chatbot menjawab 404 CP_NOT_FOUND; jika Production aktif tetapi belum ada rilis live, 403 CP_PRODUCTION_LOCKED.

  1. Render widget sekali di layout root Anda. Widget tidak memerlukan token: browser berbicara langsung dengan Atlas, dan Atlas hanya menerima origin situs web terdaftar Anda.

    app/atlas-chat.tsx
    'use client';
    import { AtlasChat } from '@atlas/chat-widget';
    import '@atlas/chat-widget/styles.css';
    import { usePathname } from 'next/navigation';
    export function SiteChat() {
    const path = usePathname();
    return (
    <AtlasChat
    apiOrigin="https://delivery.atlas.example"
    environmentId="env_XXXXXXXX"
    botKey="support"
    path={path}
    />
    );
    }
  2. Izinkan Atlas di Content-Security-Policy Anda: tambahkan origin API Atlas ke connect-src dan img-src.

  3. Gunakan id lingkungan Production di deployment live Anda, dan id Development di tempat lain.

Paket widget didistribusikan langsung kepada pelanggan yang terhubung; paket ini belum ada di registri npm publik. Tanpa React, gunakan klien biasa createChatClient({ apiOrigin, environmentId, botKey }), yang menyediakan bot(), start(path), dan send(…).

  • Percakapan terikat pada rahasia acak yang disimpan di session storage pengunjung. Tidak ada cookie.
  • Detail lead disimpan hanya ketika pengunjung mengirimkannya pada langkah lead.
  • Batas laju berlaku per alamat IP dan per percakapan; lihat Batas.