MasukMulai uji coba gratis
easyCoexistence API resmi

Arsitektur SaaS agen AI: menjangkau pelanggan dari pelanggan Anda di WhatsApp, Instagram, dan TikTok

Sebuah SaaS agen AI yang menjangkau pelanggan dari pelanggan Anda berjalan dalam lima lapisan: koneksi, tempat setiap pelanggan menautkan WhatsApp, Instagram, TikTok, dan saluran lain melalui Partner API easyCoexistence; ingesti, yang memverifikasi dan mengantrekan webhook; penyimpanan percakapan yang Anda miliki; pekerja agen yang menjalankan model Anda; dan pengiriman keluar, yang membalas, memublikasikan, dan memantau event status melalui API resmi setiap jaringan.

smb_message_echoes

Webhook yang menjelaskan pesan yang dikirim bisnis dari aplikasi WhatsApp Business pada nomor Coexistence.

7 days

Berapa lama Meta mencoba ulang webhook WhatsApp yang tidak diterima endpoint Anda, yang dapat mengirim pesan yang sama dua kali.

1 attempt

Pengiriman setiap event Instagram, Facebook, atau TikTok yang diteruskan, tanpa mencoba kembali dan tanpa salinan yang disimpan.

24 hours

Jendela layanan pelanggan WhatsApp setelah pesan seseorang; di luar jendela itu, bisnis hanya dapat mengirim template yang disetujui.

20 mps

Throughput tetap dari nomor yang digunakan bersama aplikasi WhatsApp Business dan Cloud API.

Apa saja lapisan dari SaaS agen AI?

Lima, masing-masing dengan satu tugas, sehingga model yang lambat tidak pernah kehilangan pesan dan akun yang terputus tidak menjatuhkan produk. easyCoexistence berada di lapisan pertama dan terakhir: ia menghubungkan akun dan menjaganya tetap berfungsi, sementara logika percakapan dan model tetap berada di backend Anda.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Bagaimana cara memodelkan tenant, saluran, dan percakapan?

Dalam tiga tabel. Tenant adalah pelanggan Anda, dan id-nya dikirim sebagai external_ref pada setiap sesi koneksi, sehingga setiap koneksi dan event status kembali dengan tag tersebut. Baris saluran menyimpan connection_id untuk nomor WhatsApp atau channel_id untuk akun sosial, beserta jaringan dan statusnya. Percakapan diidentifikasi berdasarkan saluran dan ID orang tersebut di jaringan itu: nomor WhatsApp di from, ID berlingkup Instagram pada DM, atau utas komentar di TikTok.

Ke mana event masuk harus pertama kali dikirim?

Ke antrean yang tahan lama, sebelum model mana pun berjalan. Endpoint ingesti memeriksa secret di path URL untuk pengiriman WhatsApp dan X-EC-Signature untuk event sosial yang diteruskan, menulis event ke antrean, lalu membalas 2xx. Kedua sumber ini berperilaku berbeda: Meta mencoba ulang webhook WhatsApp hingga 7 hari, sehingga pesan yang sama dapat tiba dua kali, sedangkan event Instagram, Facebook, atau TikTok yang diteruskan dikirim sekali dan tidak pernah disimpan, sehingga event yang ditolak endpoint Anda hilang. Lakukan deduplikasi berdasarkan ID pesan atau komentar asli dari jaringan tersebut.

Bagaimana menjaga balasan tetap berurutan dan tepat waktu?

Satu pekerja per percakapan, dan pemeriksaan sebelum setiap pengiriman. Kunci percakapan selama agen bekerja, sehingga dua pesan dari satu orang dibalas secara bergiliran dan tidak pernah dua kali. Sebelum balasan WhatsApp keluar, bandingkan pesan terakhir orang tersebut dengan jendela 24 jam, dan beralih ke template yang disetujui setelah jendela itu tertutup. Antrekan pengiriman setiap nomor paling banyak 20 pesan per detik, laju tetap dari nomor Coexistence, dan ingat bahwa balasan TikTok adalah komentar publik.

Bagaimana seseorang mengambil alih dari agen?

Melalui saluran itu sendiri. Dengan Coexistence, staf pelanggan Anda tetap menggunakan aplikasi WhatsApp Business pada nomor yang sama, dan setiap pesan yang mereka kirim tiba di webhook Anda sebagai smb_message_echoes. Perlakukan echo sebagai serah terima: jeda agen pada percakapan itu, berikan balasan staf ke model sebagai konteks, dan lanjutkan setelah masa tenang atau saat staf mengembalikannya di produk Anda. Instagram juga mengembalikan DM milik akun sebagai echo, sehingga aturan yang sama mencegah agen membalas dirinya sendiri.

Haruskah agen juga memublikasikan, bukan hanya membalas?

Bisa, melalui kunci yang sama. Agen menyusun draf postingan, dan backend Anda mengantrekannya dengan POST /channels/:id/posts di Instagram, Facebook, TikTok, dan LinkedIn, dari 1 menit hingga 90 hari ke depan, dengan post.published dan post.failed yang melaporkan kembali ke penyimpanan percakapan. Postingan LinkedIn hanya dikirim setelah seseorang menyetujui setiap postingan di produk Anda, karena Ketentuan API LinkedIn membatasi posting otomatis.

Bagaimana produk bereaksi saat koneksi terputus?

Melalui status pada baris saluran. Event status memindahkannya ke disconnected, removed, atau suspended, agen berhenti mengirim di saluran itu, dan antarmuka Anda meminta tenant menyambung ulang melalui sesi koneksi baru. Event connection.token_missing membuat nomor tetap menerima pesan tetapi tidak dapat mengirim, sehingga agen menyusun draf balasan untuk staf. connection.connected atau channel.connected mengembalikan baris itu ke active, dan pekerja mengambil kredensial baru sebelum balasan berikutnya.

Data apa yang Anda simpan, dan data apa yang disimpan easyCoexistence?

Produk Anda menyimpan percakapan. Pesan dari nomor WhatsApp berjalan langsung dari Meta ke webhook Anda, dan event sosial yang diteruskan melewati easyCoexistence tanpa salinan. easyCoexistence menyimpan yang diperlukan untuk melayani koneksi: catatan akun, token-nya, riwayat kesehatannya, dan postingan yang dipublikasikannya. Jika akun Anda juga mengaktifkan otomatisasi easyCoexistence sendiri, teks pesannya disimpan selama 7 hari dan log eksekusinya selama 30 hari.

Kesalahan umum

  • Menjadikan nomor telepon orang sebagai satu-satunya kunci percakapan. Orang yang sama dapat menulis ke dua tenant Anda, jadi kunci setiap utas dengan saluran dan ID orang tersebut sekaligus.
  • Membiarkan dua pekerja membalas satu percakapan. Pekerja paralel dapat mengirim balasan secara tidak berurutan atau dua kali, jadi kunci setiap utas selama agen bekerja padanya.
  • Membiarkan agen aktif setelah staf membalas dari aplikasi WhatsApp Business. Echo menunjukkan seseorang telah mengambil alih utas, jadi jeda agen di sana hingga aturan serah terima Anda mengembalikannya.
  • Memublikasikan draf LinkedIn agen menurut jadwal. Seseorang menyetujui setiap postingan LinkedIn, jadi arahkan draf tersebut ke langkah tinjauan sebelum masuk ke antrean.
Melakukan ini dengan EasyCoexistence

easyCoexistence adalah lapisan koneksi untuk produk agen Anda: nomor WhatsApp pelanggan Anda serta akun Instagram, Facebook, TikTok, YouTube, dan LinkedIn mereka, dan saluran lainnya, terhubung melalui tautan hosted, dengan kredensial terbaru, webhook, antrean publikasi, dan event status yang ditandatangani, setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah pelanggan dari pelanggan saya perlu memasang sesuatu?

Tidak. Mereka menulis ke bisnis seperti biasa, di WhatsApp, di DM Instagram atau Messenger, atau di kolom komentar, dan agen Anda membalas di saluran yang sama.

Dapatkah staf pelanggan saya tetap membalas secara manual?

Bisa. Dengan Coexistence, aplikasi WhatsApp Business tetap berfungsi di nomor yang sama, dan setiap pesan yang dikirim staf sampai ke webhook Anda sebagai echo, sehingga agen dapat menyingkir.

Apakah easyCoexistence menjalankan model?

Tidak. Model, prompt, dan memorinya berjalan di backend Anda. easyCoexistence menghubungkan akun, mengirimkan event-nya, dan menjaga aksesnya tetap berfungsi.

Berapa biaya easyCoexistence per pelanggan dari SaaS agen?

Setiap nomor atau akun yang terhubung dikenai US$ 9 hingga US$ 0.75 per bulan, turun seiring bertambahnya total Anda, sehingga pelanggan yang memakai WhatsApp dan Instagram dihitung dua kali. 3 hari pertama gratis.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada