Plugin WordPress · Dokumentasi

OGNIVID AI Assistant

Asisten AI yang mewawancarai pengunjung website dan mengirim Project Brief terstruktur lewat email dan PDF

Versi 2.0 · November 2026 · Untuk pemilik situs, developer, dan integration engineer

Buka live mockup → ⬇ Unduh ZIP

Ringkasan eksekutif

OGNIVID AI Assistant adalah plugin WordPress yang mengubah pengunjung website menjadi calon klien dengan kebutuhan yang jelas. Asisten AI mewawancarai pengunjung layaknya konsultan berpengalaman, merangkum kebutuhannya, meminta konfirmasi, lalu mengirim Project Brief terstruktur ke tim OGNIVID sebagai email HTML dengan lampiran PDF.

Secara bawaan plugin memakai Claude, bisa dipindah ke penyedia AI lain, dan otomatis beralih ke formulir singkat saat AI tidak tersedia, sehingga tidak ada permintaan yang hilang. Setiap brief juga tersimpan secara privat di wp-admin.

2mode: chat AI & formulir
16kolom brief terstruktur
9penyedia AI + mode formulir
2bahasa (EN / ID)

Cara kerja

1

Pengunjung membuka chat

Tombol “Konsultasi dengan AI” muncul di setiap halaman, sesuai bahasa halaman.

2

AI mewawancarai pengunjung

Satu atau dua pertanyaan terarah setiap kali: masalah, tujuan, sistem saat ini, batasan, urgensi, target waktu, anggaran, dan data kontak.

3

Pengunjung mengonfirmasi ringkasan

Asisten menampilkan ringkasan singkat dan baru melanjutkan setelah pengunjung mengonfirmasi atau mengoreksinya.

4

Brief dikirim

Model memanggil tool submit_project_brief dengan skema JSON ketat; server memvalidasi nama dan email sebelum menerimanya.

5

Brief disimpan dan dikirim

Disimpan di AI Briefs, dibuat PDF, lalu dikirim ke OGNIVID (beserta transkrip) dan ke pelanggan (beserta link WhatsApp).

6

Formulir cadangan

Jika AI mati, saldo habis, error, atau melewati batas harian, brief yang sama dikumpulkan lewat formulir singkat.

Widget chat di ognivid.com
Widget chat di situs bahasa Indonesia. Di situs bahasa Inggris, widget yang sama berbahasa Inggris.

Arsitektur solusi

Pengunjung WordPress · ognivid.com Layanan eksternal Widget chatwidget.js · EN / IDchat atau formulir Inbox pelanggansalinan + PDF REST API/ognivid-ai/v1/chat/ognivid-ai/v1/form Pengamanorigin · batas pesanhoneypot · mode uji Sesi di servertransient · 2 jamriwayat tidak dari browser Adapter providerClaude Messages APIatau OpenAI-compatible submit_project_briefskema JSON ketatdivalidasi di server Pipeline briefAI Briefs (post type privat)PDF (bawaan, folder privat)Email HTML via wp_mail Anthropic APIclaude-opus-5-5 (bawaan)fallback refusal aktif Gemini · Groq · OpenRouteralternatif opsional SMTPWP Mail SMTP → inbox pemilik
Browser hanya mengirim pesan pengunjung. Riwayat percakapan, batas pesan, API key, dan validasi brief semuanya tetap di server.

Project Brief

Setiap brief, baik dari AI maupun formulir, memakai skema yang sama dan ditulis dalam bahasa pelanggan.

KolomIsi
customerNama, email, perusahaan, telepon/WhatsApp, jabatan
title · summaryJudul proyek singkat dan ringkasan eksekutif 2–3 kalimat
problemMasalah dalam kata-kata pelanggan sendiri
goals · requirementsSeperti apa keberhasilan dan apa yang harus dilakukan solusi
current_systemsPlatform dan tools yang sudah dipakai
constraintsTenggat, anggaran, kepatuhan, keamanan
urgencylow · medium · high · critical (high/critical ditandai di subjek email)
timeline · budgetTarget waktu dan kisaran anggaran
suggested_servicesManaged File Transfer, Integration & AI Agents, Data & Dashboards, Lainnya
initial_recommendationIde awal singkat yang tidak mengikat
open_questionsHal yang masih perlu diklarifikasi tim

Fitur

Wawancara konsultatif

Balasan singkat, pertanyaan lanjutan yang terarah, sekitar 6–10 pertanyaan, lalu ringkasan untuk dikonfirmasi.

Email + PDF

Email HTML yang rapi dan PDF A4 untuk tim, plus salinan untuk pelanggan.

Inbox di wp-admin

AI Briefs menampilkan setiap brief beserta pelanggan, urgensi, sumber, dan status, badge pesan baru di menu, filter status, transkrip lengkap, unduhan PDF yang terlindungi, catatan internal, serta balas sekali klik lewat email atau WhatsApp.

Dua bahasa

Mengikuti bahasa halaman (Inggris atau Indonesia) dan berpindah mengikuti pengunjung.

Tidak terkunci provider

Claude secara bawaan; OpenAI (model ChatGPT), Google Gemini, Mistral, DeepSeek, xAI Grok, Groq, OpenRouter, atau endpoint OpenAI-compatible lain sebagai alternatif.

Tidak kehilangan calon klien

Formulir cadangan otomatis saat AI tidak tersedia atau batas tercapai.

Keamanan & privasi

Key tetap di server

API key disimpan di opsi WordPress, tidak pernah dikirim ke browser, dan tidak ditampilkan kembali di halaman pengaturan.

Riwayat di server

Percakapan disimpan di transient server; pengunjung tidak bisa menyisipkan balasan asisten palsu. Blok thinking Claude dikirim ulang tanpa diubah.

Batas penyalahgunaan

Cek same-origin, batas pesan per percakapan, pesan per IP per jam, batas AI harian per situs, honeypot, dan waktu isi minimum di formulir.

Output terstruktur ketat

Tool brief memakai skema ketat dan divalidasi serta disanitasi ulang di server sebelum disimpan atau dikirim.

PDF privat

PDF disimpan di folder uploads yang diblokir dan hanya bisa diunduh lewat link admin yang dilindungi nonce.

Transparan ke pengunjung

Widget menyatakan bahwa chat diproses oleh AI dan meminta pengunjung tidak membagikan password atau data rahasia.

Instalasi

Kebutuhan: WordPress 6.x, PHP 7.4+ (diuji di PHP 8.2), koneksi HTTPS keluar dari server, dan pengiriman email yang berfungsi.

Cara penggunaan

Pengunjung

Pemilik situs

Mengganti penyedia AI

Referensi pengaturan

PengaturanBawaanFungsi
Tampilkan asistenonSaklar utama widget
Mode ujionHanya administrator yang login yang bisa melihat dan memakai asisten
Nama bisnisjudul situsNama bisnis yang dipakai asisten, di email, dan di PDF
Tentang bisnis AndaDeskripsi singkat: apa yang Anda kerjakan, untuk siapa, contoh pekerjaan. Asisten memakainya untuk menjawab dan menyarankan layanan.
Layanan3 contohSatu per baris (maks. 12). Setiap brief ditandai dengan layanan yang relevan.
Instruksi tambahan · SapaanAturan opsional untuk asisten, dan pesan pertama chat dalam bahasa Inggris / Indonesia
Penyedia AIAnthropicAnthropic, OpenAI, Gemini, Mistral, DeepSeek, xAI, Groq, OpenRouter, OpenAI-compatible kustom, atau Off (hanya formulir)
Modelclaude-opus-5-5ID model apa pun dari penyedia terpilih; ganti saat berpindah penyedia (misalnya model GPT untuk OpenAI). Claude Sonnet 5.5 / Haiku 5.5 lebih hemat daripada Opus.
Effort (Claude)mediumKedalaman berpikir: low, medium, atau high
Kirim brief keemail adminInbox pemilik; salinan opsional ke pelanggan
Warna aksen#7cff3bWarna tombol chat, email, dan header PDF
Nomor WhatsAppkosongLink tindak lanjut untuk pelanggan
Posisi tombolkiri bawahMenghindari tumpang tindih dengan tombol WhatsApp di kanan
Batas25 · 1500 · 40 · 60Pesan per percakapan · karakter per pesan · pesan per IP per jam · percakapan AI per hari

Penyedia AI

PenyediaCara pemanggilanCatatan
Anthropic ClaudeMessages API (/v1/messages, versi 2026-10-21) dengan tool ketat, prompt caching, dan fallback refusal di serverDisarankan. Bayar sesuai pemakaian; atur batas pengeluaran bulanan di Console.
OpenAI (ChatGPT)Chat Completions API (api.openai.com/v1/chat/completions) dengan function callingPakai ID model GPT dari akun OpenAI Anda. Key: platform.openai.com → API keys. Langganan ChatGPT Plus tidak termasuk akses API.
Google GeminiEndpoint OpenAI-compatibleAda versi gratis; cek ketentuan penggunaan datanya sebelum mengirim data pelanggan. Key: aistudio.google.com.
Mistral AIEndpoint OpenAI-compatible (api.mistral.ai)Penyedia asal Eropa. Key: console.mistral.ai.
DeepSeekEndpoint OpenAI-compatible (api.deepseek.com)Biaya rendah. Key: platform.deepseek.com.
xAI (Grok)Endpoint OpenAI-compatible (api.x.ai)Model Grok. Key: console.x.ai.
Groq · OpenRouterEndpoint OpenAI-compatibleModel open source, kuota gratis yang sering berubah. OpenRouter memberi akses ke ratusan model (termasuk GPT, Claude, Llama) dengan satu key.
KustomURL /chat/completions OpenAI-compatible apa punUntuk model self-hosted (misalnya Ollama di balik gateway).
OffTanpa AIHanya formulir, gratis selamanya.

REST API

EndpointRequest (JSON)Response
POST /wp-json/ognivid-ai/v1/chat{ sid, message, lang }{ sid, reply, done, mode }, dengan mode: "form" meminta widget menampilkan formulir
POST /wp-json/ognivid-ai/v1/form{ name, email, company, phone, title, problem, systems, service, urgency, timeline, budget, lang, ts, website }{ ok, reply }

Kedua endpoint hanya menerima request dari situs yang sama. Dalam mode uji, keduanya juga membutuhkan administrator yang login (widget mengirim REST nonce).

Komponen

FileTanggung jawab
ognivid-ai-assistant.phpBootstrap plugin dan hook
includes/class-ognivid-ai-settings.phpHalaman pengaturan, nilai bawaan, dan sanitasi
includes/class-ognivid-ai-provider.phpSystem prompt, skema brief, adapter Claude dan OpenAI-compatible
includes/class-ognivid-ai-chat.phpEndpoint REST, sesi, batas, pemuatan widget
includes/class-ognivid-ai-brief.phpPost type AI Briefs, PDF, email HTML, tampilan admin
assets/widget.js · widget.cssUI chat dan formulir (tanpa dependensi)
includes/class-ognivid-ai-pdf.phpPenulis PDF bawaan yang ringkas (tanpa library pihak ketiga)
uninstall.phpMenghapus opsi plugin saat plugin dihapus (brief tetap disimpan)

Pemecahan masalah

GejalaYang perlu dicek
Tombol tidak munculMode uji aktif (login sebagai admin), asisten dimatikan, atau cache halaman masih menyajikan versi lama.
Chat langsung menampilkan formulirAPI key belum ada, penyedia diatur Off, saldo habis, atau batas harian tercapai. Error dicatat di PHP error log dengan awalan “OGNIVID AI Assistant:”.
Brief tersimpan tetapi email tidak masukKirim tes dari WP Mail SMTP → Tools. Jika berhasil, cek folder spam, forwarder di mailbox penerima, dan cara mailbox tersambung ke aplikasi email (IMAP).
PDF tidak adaFolder uploads harus bisa ditulis; email tetap terkirim tanpa lampiran.

Rencana pengembangan