MasukMulai uji coba gratis
easyCoexistence API resmi

API media sosial multi-tenant: satu kunci API, banyak akun pelanggan

Partner API easyCoexistence dirancang multi-tenant sejak awal: satu kunci ec_live_ di akun Anda menghubungkan dan mengelola banyak nomor WhatsApp dan akun media sosial pelanggan. Setiap koneksi membawa id pelanggan Anda sebagai external_ref, menyimpan token milik pelanggan tersebut, mendapat tujuan webhook sendiri, dan muncul dalam event status yang ditandatangani, sehingga GET /channels?external_ref= menampilkan daftar akun satu pelanggan.

200 characters

Panjang maksimum external_ref yang diterima sesi koneksi: id pelanggan Anda sendiri, disimpan pada koneksi yang dibuatnya.

1 key

Kunci API yang dapat dimiliki satu akun easyCoexistence sekaligus; kunci terpisah berarti akun dan tagihan terpisah.

50 open

Sesi koneksi yang boleh terbuka bersamaan dalam satu akun, di samping batas 100 sesi baru per jam.

5 minutes

Usia maksimum timestamp event bertanda tangan sebelum ditolak, dengan HMAC dibandingkan dalam waktu konstan.

Bagaimana satu akun melayani banyak pelanggan?

Akun easyCoexistence Anda mewakili produk Anda, dan setiap pelanggan menjadi tag pada koneksi yang mereka bawa. Pelanggan tidak membuat akun sendiri, tidak pernah melihat kunci Anda, dan ditagih oleh Anda, bukan oleh easyCoexistence:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Bagaimana cara memberi tag setiap koneksi dengan pelanggan Anda?

Kirim external_ref pada sesi koneksi. Nilainya disimpan pada nomor atau saluran yang dibuat sesi tersebut, ditambahkan ke redirect, dan disertakan dalam event statusnya. Masuk dengan Facebook atau LinkedIn yang membawa beberapa Halaman memberi tag pada tiap Halaman. Untuk melihat akun satu pelanggan, filter salah satu daftar berikut:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

Bagaimana token pelanggan dipisahkan?

Setiap koneksi menyimpan token milik pelanggannya sendiri. Token nomor WhatsApp adalah token bisnis yang diterbitkan Meta saat Embedded Signup, terbatas pada aset pelanggan tersebut, dan token akun media sosial adalah token yang diberikan pemiliknya. Kredensial hanya datang melalui kunci Anda, dari backend Anda, dan ID yang tidak ada di akun Anda dijawab 404 not_found. Cari koneksi milik pelanggan tempat sebuah pekerjaan berada sebelum mengambil tokennya, agar pekerjaan satu pelanggan tidak pernah berjalan di akun pelanggan lain.

Bagaimana webhook bekerja per pelanggan?

Satu tujuan per akun, dipilih oleh Anda. Arahkan semua saluran ke satu URL dan rutekan berdasarkan account_id di body, atau berikan tiap pelanggan URL sendiri. Setiap saluran menandatangani dengan kunci rahasianya sendiri dari PUT /channels/{id}/webhook, jadi account_id memberi tahu kunci mana yang dipakai untuk verifikasi. Pesan nomor dikirim Meta ke webhook_url, yang diatur pada WhatsApp Business Account, jadi rutekan berdasarkan phone_number_id.

Bagaimana event status menyebutkan pelanggan mana yang dimaksud?

Dengan membawa external_ref Anda. Satu URL event per akun menerima event connection.* dan channel.*, masing-masing dengan tampilan koneksi atau saluran di dalamnya, termasuk external_ref, dan post.published serta post.failed membawa postingan dan salurannya. Event ditandatangani dengan kunci rahasia akun di X-EC-Signature dan dikirim ulang saat endpoint Anda gagal, jadi tangani setiap ID pengiriman hanya sekali.

Seberapa cepat Anda bisa mendaftarkan banyak pelanggan?

Pada 50 sesi koneksi terbuka dan 100 sesi baru per jam untuk setiap akun. Meta menghitung setiap pendaftaran WhatsApp pertama terhadap batas di seluruh aplikasi yang dibagi oleh semua akun easyCoexistence, dan batas ini mencegah impor satu platform menghabiskannya. Buat sesi ketika pelanggannya hampir terhubung, dan batas yang tercapai menjawab 429 cap_reached atau rate_limited.

Bagaimana jika akun pelanggan sudah terhubung di tempat lain?

Proses masuk ditolak. Akun media sosial hanya terhubung melalui satu akun easyCoexistence dalam satu waktu, jadi jika layanan lain yang memakai easyCoexistence sudah memegangnya, last_error pada sesi menyebutkannya, dan pelanggan menghapusnya di sana atau masuk dengan akun lain. Di dalam akun Anda sendiri, pelanggan dapat menghubungkan akun sebanyak yang mereka butuhkan, masing-masing diberi tag external_ref yang sama.

Bagaimana cara menghapus satu pelanggan?

Daftarkan koneksi dan saluran mereka berdasarkan external_ref, lalu DELETE setiap item. Menghapus nomor mencabut akses easyCoexistence di Meta dan menghentikan pemantauan; menghapus saluran mencabut akses di jaringan dan membatalkan postingannya yang masih menunggu di antrean. Penagihan untuk masing-masing berhenti pada akhir siklus, dan koneksi pelanggan lain tidak tersentuh.

Kesalahan umum

  • Memakai email sebagai external_ref. Email berubah dan nilainya disimpan pada setiap koneksi, jadi gunakan id tetap dari basis data Anda sendiri.
  • Memverifikasi event yang diteruskan dengan kunci rahasia pelanggan yang salah. Cari kunci berdasarkan account_id di body, karena setiap saluran menandatangani dengan kuncinya sendiri.
  • Mengirim tautan koneksi ke seluruh basis pelanggan sekaligus. Hanya 50 sesi yang boleh terbuka per akun, jadi undang pelanggan secara bertahap.
  • Menghapus pelanggan hanya di basis data Anda sendiri. Koneksinya tetap ada di akun dan tagihan Anda sampai tiap koneksi dihapus melalui API.
Melakukan ini dengan EasyCoexistence

easyCoexistence memungkinkan satu kunci API melayani seluruh basis pelanggan Anda: nomor WhatsApp mereka serta akun Instagram, Facebook, TikTok, YouTube dan LinkedIn, dan saluran lain, masing-masing diberi tag id pelanggan Anda, dengan token, webhook, dan event bertanda tangan sendiri, serta setiap koneksi dipantau 24/7. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah saya perlu satu akun easyCoexistence per pelanggan?

Tidak. Satu akun dan kuncinya dapat menampung koneksi banyak pelanggan, dibedakan dengan external_ref. Akun terpisah hanya diperlukan jika Anda ingin tagihan terpisah.

Apakah pelanggan saya bisa melihat akun satu sama lain?

Tidak melalui easyCoexistence. Mereka tidak pernah memegang kunci Anda, dan hanya membuka tautan koneksi milik mereka sendiri. Apa yang dilihat setiap pelanggan di dalam produk Anda ditentukan oleh kode Anda.

Bisakah saya memberi tiap pelanggan URL webhook yang berbeda?

Bisa. Setiap nomor dan setiap saluran menerima tujuannya sendiri, jadi URL khusus pelanggan bisa dipakai, begitu pula satu URL bersama yang dirutekan berdasarkan account_id.

Bagaimana akun multi-tenant ditagih?

Per koneksi dari seluruh pelanggan Anda secara bersama: US$ 9 hingga US$ 0.75 per koneksi per bulan, ditentukan oleh tingkat total jumlah Anda, dengan 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