Kenali bila REST API AI SNS CHAT berbaloi, cara guna kunci API, strim SSE dan webhook bertandatangan HMAC, serta senarai semak sebelum anda siarkan.
Anda sudah ada ejen AI yang menjawab pelanggan di WhatsApp, tetapi pasukan anda mahu lebih. Mungkin pesanan perlu masuk terus ke sistem inventori, atau jawapan ejen perlu dipaparkan dalam aplikasi mudah alih sendiri. Artikel ini menerangkan bila REST API AI SNS CHAT sesuai digunakan, apa komponen utamanya, bagaimana menghormati had kadar, dan apa yang perlu disemak sebelum anda siarkan kepada pelanggan sebenar.
Bila API ialah alat yang betul (dan bila bukan)
Kesilapan paling kerap ialah mencapai API terlalu awal. Banyak keperluan PKS sebenarnya sudah dilindungi oleh sambungan sedia ada. Kod tersuai bermakna anda perlu menyelenggarakannya, memantaunya dan membetulkannya apabila ada perubahan.
API sesuai apabila:
- Anda mahu memaparkan ejen dalam antara muka sendiri, misalnya aplikasi pelanggan atau portal ahli.
- Anda perlu menghubungkan jawapan ejen dengan sistem dalaman yang tiada sambungan siap, seperti sistem tempahan atau ERP buatan sendiri.
- Anda mahu menerima kejadian melalui webhook, kemudian mencetuskan tindakan di sistem lain.
- Pasukan teknikal anda boleh menjaga kod itu dalam jangka panjang.
API tidak diperlukan apabila anda hanya mahu meletakkan ejen di WhatsApp, Messenger, Instagram atau widget chat laman web. Semua itu ada di bawah Channels dan disediakan tanpa menulis kod. Begitu juga dengan beberapa tindakan biasa seperti mengumpul prospek, Slack atau Calendly, yang sudah tersedia sebagai Actions.
Blok binaan
REST API AI SNS CHAT menggunakan JSON. Ada tiga komponen yang perlu anda fahami.
Kunci API
Kunci dijana di Workspace settings → API keys. Kunci hanya dipaparkan sekali semasa dijana, jadi simpan terus di tempat selamat. Anda boleh membatalkannya pada bila-bila masa. Ciri ini memerlukan pelan Hobby atau lebih tinggi.
Strim balasan melalui SSE
Jika anda menambah stream=1, balasan dihantar secara strim menggunakan Server-Sent Events. Pelanggan melihat jawapan muncul sedikit demi sedikit dan tidak perlu menunggu seluruh teks siap. Ini penting untuk antara muka sendiri, terutamanya bagi jawapan yang panjang.
Webhook bertandatangan HMAC
AI SNS CHAT boleh menghantar webhook kepada sistem anda, dan setiap satu ditandatangani dengan HMAC. Terdapat juga log penghantaran supaya anda boleh menyemak apa yang telah dihantar. Dengan tandatangan, pelayan anda boleh mengesahkan bahawa permintaan itu benar-benar datang dari AI SNS CHAT.
Butiran lengkap titik akhir dan medan permintaan terdapat dalam halaman rujukan API pada produk. Jadikan halaman itu sumber utama anda semasa membina, kerana ia sentiasa lebih terkini daripada artikel blog.
- 01Sistem anda
- 02Pelayan perantara anda
- 03REST API AI SNS CHAT
- 04Webhook kembali ke pelayan anda
Hormati had kadar yang diterbitkan
Had kadar yang diterbitkan dalam rujukan API ialah:
| Kegunaan | Had |
|---|---|
| Pengesahan (auth) | 20 setiap 5 minit bagi setiap IP |
| Chat awam | 30 seminit bagi setiap IP |
| Poll | 120 seminit |
Ada dua implikasi praktikal.
Pertama, had dikira mengikut IP untuk auth dan chat awam. Jika semua trafik pelanggan anda melalui satu pelayan perantara, pelayan itu akan kelihatan sebagai satu IP. Rancang jumlah permintaan dengan teliti, dan jangan andaikan setiap pengguna akhir mempunyai had sendiri.
Kedua, jangan menggunakan poll secara agresif. Jika anda menunggu hasil, gunakan strim SSE atau webhook, bukan gelung yang bertanya setiap saat.
Sebagai contoh hipotetikal, bayangkan kedai dalam talian yang membuka jualan kilat dan mendapat lonjakan pelanggan serentak. Jika setiap pelanggan mencetuskan permintaan melalui pelayan yang sama, had 30 seminit untuk chat awam boleh dicapai dengan cepat. Reka bentuk yang baik menyediakan baris gilir dan mesej "sila tunggu sebentar" yang mesra, dan bukan paparan ralat.
Corak reka bentuk yang berkesan
Letakkan pelayan perantara di tengah
Pelayan anda memegang kunci API, menghubungi AI SNS CHAT, dan menyampaikan hasilnya kepada aplikasi atau laman web. Pelayar dan aplikasi mudah alih tidak pernah melihat kunci. Pelayan perantara juga tempat terbaik untuk menambah baris gilir, pengelogan dan kawalan had.
Strim untuk pengalaman pantas, webhook untuk kerja di belakang tabir
Gunakan SSE apabila ada manusia menunggu di skrin. Gunakan webhook untuk kerja yang tidak perlu dilihat serta-merta, seperti mengemas kini rekod pelanggan atau menghantar notifikasi kepada pasukan jualan.
Rekabentuk untuk mesej berulang
Rangkaian tidak sempurna. Reka pengendali webhook anda supaya memproses kejadian yang sama dua kali tanpa akibat buruk. Contohnya, semak sama ada rekod pesanan itu sudah wujud sebelum mencipta yang baharu.
Pisahkan persekitaran
Gunakan ejen dan kunci berasingan untuk ujian dan pengeluaran. Dengan itu, kesilapan semasa membina tidak menjejaskan pelanggan sebenar.
Contoh tempatan
Sebuah kedai pakaian Muslimah di Shah Alam mahu setiap pertanyaan pesanan di WhatsApp disemak terhadap sistem stok. Pembangun mereka menulis perkhidmatan kecil yang menerima webhook, menyemak stok, lalu merekodkan hasilnya. Pelanggan terus berbual melalui WhatsApp seperti biasa, manakala logik tersuai berjalan di belakang. Laluan WhatsApp itu sendiri tetap dikonfigurasi melalui Channels dan bukan melalui kod.
Senarai semak keselamatan sebelum siaran
- Simpan kunci di pelayan sahaja. Gunakan pemboleh ubah persekitaran atau pengurus rahsia. Jangan masukkan kunci dalam kod pelayar, aplikasi mudah alih atau repositori awam.
- Sahkan tandatangan HMAC setiap webhook. Kira tandatangan daripada badan permintaan mentah, kemudian banding dengan nilai yang diterima. Tolak apa-apa yang tidak sepadan.
- Gunakan HTTPS sahaja untuk URL webhook anda.
- Rancang pemutaran kunci. Oleh sebab kunci boleh dibatalkan, tetapkan jadual untuk menggantinya dan tahu siapa yang perlu dimaklumkan.
- Elakkan melog data sensitif. Nombor telefon, alamat dan butiran tempahan tidak perlu ada dalam log aplikasi anda.
- Semak log penghantaran webhook secara berkala untuk mengesan kegagalan lebih awal.
- Hadkan akses dalam pasukan. Hanya orang yang memerlukan akses ke Workspace settings patut mempunyai peranan yang membenarkannya. Log Activity di Workspace settings merekodkan perubahan, siapa yang membuatnya dan bila.
Amalan keselamatan platform direka dengan merujuk kepada GDPR dan APPI. Walau bagaimanapun, tanggungjawab terhadap data pelanggan dalam sistem anda sendiri tetap di tangan anda.
Ujian dan pelancaran
Jangan terus siarkan. Ikuti langkah berperingkat ini.
- Uji dalam Playground. Pastikan ejen menjawab dengan betul sebelum disambungkan kepada kod anda. Jika jawapan sudah salah di sini, API tidak akan membetulkannya.
- Bina dengan satu kes penggunaan. Contohnya, hanya semakan status pesanan. Tambah kes lain selepas yang pertama stabil.
- Uji senario gagal. Matikan pelayan anda seketika dan lihat apa yang berlaku. Hantar webhook dengan tandatangan salah dan pastikan ia ditolak.
- Lancar kepada kumpulan kecil. Mulakan dengan pasukan dalaman atau beberapa pelanggan setia.
- Pantau selepas siaran. Semak log chat dan log penghantaran webhook setiap hari pada minggu pertama.
Melakukannya dalam AI SNS CHAT
Berikut langkah praktikal untuk bermula.
- Semak pelan anda. Kunci API memerlukan Hobby atau lebih tinggi. Harga dan had semasa boleh dilihat di halaman harga.
- Sediakan ejen dahulu. Tambah sumber pengetahuan di Data sources, seperti fail, laman web atau Q&A. Uji dalam Playground sehingga jawapannya memuaskan.
- Jana kunci API. Pergi ke Workspace settings → API keys, jana kunci, dan salin terus kerana ia tidak dipaparkan semula. Simpan di pengurus rahsia pelayan anda.
- Bina pelayan perantara. Ikut halaman rujukan API untuk format permintaan. Tambah
stream=1jika anda mahu balasan strim melalui SSE. - Daftar webhook dan sahkan HMAC. Selepas itu, gunakan log penghantaran untuk menyemak bahawa kejadian sampai ke pelayan anda.
- Pertimbangkan domain tersuai. Di Agent → Settings → Custom domains, anda boleh menggunakan subdomain sendiri untuk skrip benam, iframe dan pautan ejen. CNAME disahkan melalui carian DNS. Ciri ini memerlukan Hobby atau lebih tinggi.
- Gabungkan dengan saluran sedia ada. WhatsApp, Messenger, Instagram dan widget laman web dipasang melalui Channels. API melengkapi saluran itu dan tidak menggantikannya.
Jika anda tidak pasti di mana sesuatu tetapan berada, tanya Synthia, pengurus armada AI dalam papan pemuka. Dia boleh membawa anda ke skrin yang betul dan menyerlahkan kawalannya. Senarai penuh ciri dan saluran terdapat di halaman ciri, manakala butiran sambungan boleh dirujuk di halaman sambungan. Untuk amalan keselamatan platform, lihat halaman keselamatan.
Untuk automasi tanpa kod, ada juga Zapier dalam senarai Channels, dan Actions seperti Custom actions. Semak dahulu sama ada keperluan anda sudah terjawab di situ.
Kesimpulan
REST API ialah alat yang berkuasa, tetapi bukan jalan pertama. Gunakan laluan terbina dalam untuk WhatsApp, Instagram dan chat laman web, dan simpan API untuk keperluan yang benar-benar tersuai. Apabila anda menggunakannya, pegang kunci di pelayan, hormati had kadar, sahkan setiap webhook, dan lancarkan secara berperingkat. Dengan disiplin itu, integrasi anda akan kekal stabil walaupun trafik meningkat.
Soalan lazim
Pelan mana yang diperlukan untuk menggunakan REST API?
Kunci API memerlukan pelan Hobby atau lebih tinggi. Kunci dijana di Workspace settings → API keys, dipaparkan sekali sahaja dan boleh dibatalkan. Harga lalai boleh berubah, jadi semak halaman harga untuk maklumat terkini.
Bolehkah saya strim balasan ke antara muka saya sendiri?
Boleh. Tambah stream=1 pada permintaan dan balasan dihantar melalui Server-Sent Events. Pelanggan anda melihat teks muncul secara berperingkat dalam aplikasi atau laman web anda.
Bagaimana saya tahu webhook benar-benar datang dari AI SNS CHAT?
Webhook ditandatangani dengan HMAC. Pelayan anda mengira tandatangan daripada badan permintaan mentah dan membandingkannya dengan nilai yang diterima, lalu menolak yang tidak sepadan. Log penghantaran webhook juga membantu anda menyemak apa yang telah dihantar.
Apakah had kadar yang diterbitkan?
Pengesahan dihadkan kepada 20 setiap 5 minit bagi setiap IP, chat awam 30 seminit bagi setiap IP, dan poll 120 seminit. Rancang trafik anda dengan mengambil kira bahawa pelayan perantara yang sama akan dikira sebagai satu IP.
Adakah saya perlukan API untuk meletakkan ejen di WhatsApp atau Messenger?
Tidak. Kedua-dua saluran itu tersedia di Sidebar → Channels dan disediakan tanpa kod. API hanya diperlukan apabila anda mahu antara muka sendiri atau logik tersuai di sistem anda.


