API media sosial berbilang pelanggan: satu kunci API, banyak akaun pelanggan
Partner API easyCoexistence direka sebagai berbilang pelanggan: satu ec_live_ kunci pada akaun anda menyambung dan mengurus banyak nombor WhatsApp dan akaun media sosial pelanggan. Setiap sambungan membawa id pelanggan anda sebagai external_ref, memegang token milik pelanggan itu, mempunyai destinasi webhook sendiri dan muncul dalam acara status bertandatangan, jadi GET /channels?external_ref= menyenaraikan akaun satu pelanggan sahaja.
external_ref terpanjang yang diterima sesi sambungan: id anda sendiri untuk pelanggan, disimpan pada sambungan yang dicipta.
Kunci API yang boleh dimiliki sebuah akaun easyCoexistence pada satu-satu masa; kunci berasingan bermaksud akaun berasingan dengan bil berasingan.
Bilangan sesi sambungan yang boleh dibuka serentak bagi satu akaun, di samping had 100 sesi baharu sejam.
Had usia selepas cap masa acara bertandatangan patut ditolak, dengan HMAC dibandingkan dalam masa malar.
Bagaimana satu akaun melayani banyak pelanggan?
Akaun easyCoexistence anda mewakili produk anda, dan setiap pelanggan ialah tag pada sambungan yang mereka bawa. Pelanggan tidak mencipta akaun sendiri, tidak pernah melihat kunci anda dan dicaj oleh anda, bukan oleh easyCoexistence:
Bagaimana anda menandakan setiap sambungan dengan pelanggan anda?
Hantar external_ref pada sesi sambungan. Nilainya disimpan pada nombor atau saluran yang dicipta oleh sesi itu, ditambah kepada pengalihan dan disertakan dalam acara status. Log masuk Facebook atau LinkedIn yang membawa beberapa Halaman menandakan setiap satu. Untuk melihat akaun satu pelanggan, tapis mana-mana senarai:
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 sambungan memegang token pelanggannya sendiri. Token nombor WhatsApp ialah token perniagaan yang dikeluarkan Meta pada Embedded Signup, dengan skop kepada aset pelanggan itu, dan token akaun media sosial ialah token yang diberikan oleh pemiliknya. Kelayakan hanya datang melalui kunci anda, daripada bahagian belakang sistem anda, dan ID yang tiada dalam akaun anda menjawab 404 not_found. Cari sambungan bagi pelanggan yang memiliki tugas itu sebelum mengambil tokennya, supaya kerja satu pelanggan tidak pernah berjalan pada akaun pelanggan lain.
Bagaimana webhook berfungsi mengikut pelanggan?
Satu destinasi bagi setiap akaun, dipilih oleh anda. Arahkan saluran ke satu URL dan hala mengikut account_id dalam badan, atau beri setiap pelanggan URL sendiri. Setiap saluran menandatangani dengan rahsianya sendiri daripada PUT /channels/{id}/webhook, jadi account_id memberitahu anda rahsia mana yang perlu digunakan untuk pengesahan. Mesej bagi nombor WhatsApp dihantar daripada Meta ke webhook_url, yang ditetapkan pada WhatsApp Business Account, jadi hala mengikut phone_number_id.
Bagaimana acara status memberitahu pelanggan mana yang berkaitan?
Dengan membawa external_ref anda. Satu URL acara bagi setiap akaun menerima acara connection.* dan channel.*, setiap satu dengan paparan sambungan atau saluran di dalamnya, termasuk external_ref, dan post.published serta post.failed membawa siaran dan salurannya. Acara ditandatangani dengan rahsia akaun itu sendiri dalam X-EC-Signature dan dicuba semula apabila endpoint anda gagal, jadi kendalikan setiap id penghantaran sekali sahaja.
Seberapa pantas anda boleh mendaftarkan ramai pelanggan?
Pada 50 sesi sambungan yang dibuka dan 100 sesi baharu sejam bagi setiap akaun. Meta mengira setiap pendaftaran WhatsApp kali pertama terhadap had seluruh aplikasi yang dikongsi setiap akaun easyCoexistence, dan had ini menghalang import satu platform daripada menghabiskannya. Cipta setiap sesi apabila pelanggannya hampir menyambung, dan had akan menjawab 429 cap_reached atau rate_limited.
Bagaimana jika akaun pelanggan sudah disambung di tempat lain?
Log masuk ditolak. Akaun media sosial hanya boleh disambung melalui satu akaun easyCoexistence pada satu-satu masa, jadi jika perkhidmatan lain yang menggunakan easyCoexistence memegangnya, last_error sesi akan menyatakannya dan pelanggan perlu mengeluarkannya di sana atau log masuk dengan akaun lain. Dalam akaun anda sendiri, pelanggan boleh menyambungkan seberapa banyak akaun yang diperlukan, setiap satu ditandakan dengan external_ref yang sama.
Bagaimana anda menamatkan perkhidmatan satu pelanggan?
Senaraikan sambungan dan saluran mereka mengikut external_ref dan DELETE setiap satu. Mengeluarkan nombor membatalkan akses easyCoexistence di Meta dan menghentikan pemantauan; mengeluarkan saluran membatalkan akses di rangkaian dan membatalkan siaran yang masih menunggu dalam barisan. Caj bagi setiap satu berhenti pada akhir kitaran, dan sambungan lain pelanggan itu, seperti milik pelanggan lain, tidak terjejas.
Kesilapan biasa
- Menggunakan e-mel sebagai external_ref. E-mel berubah dan nilai itu disimpan pada setiap sambungan, jadi gunakan id tetap daripada pangkalan data anda sendiri.
- Mengesahkan acara yang dimajukan dengan rahsia pelanggan yang salah. Cari rahsia dengan account_id dalam badan, kerana setiap saluran menandatangani dengan rahsianya sendiri.
- Menghantar pautan sambungan kepada seluruh pangkalan pelanggan anda sekaligus. Hanya 50 sesi boleh dibuka bagi setiap akaun, jadi jemput pelanggan secara berperingkat-peringkat.
- Memadam pelanggan hanya dalam pangkalan data anda sendiri. Sambungan mereka kekal pada akaun dan bil anda sehingga setiap satu dikeluarkan melalui API.
easyCoexistence membolehkan satu kunci API melayani seluruh pangkalan pelanggan anda: nombor WhatsApp mereka serta akaun Instagram, Facebook, TikTok, YouTube dan LinkedIn mereka, dan lebih banyak saluran, setiap satu ditandakan dengan id pelanggan anda, dengan token, webhook dan acara bertandatangan sendiri, serta setiap sambungan dipantau 24/7. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah saya perlu satu akaun easyCoexistence bagi setiap pelanggan?
Tidak. Satu akaun dan kuncinya boleh memegang sambungan banyak pelanggan, yang dibezakan melalui external_ref. Akaun berasingan hanya diperlukan jika anda mahu bil berasingan.
Bolehkah pelanggan saya melihat akaun satu sama lain?
Tidak melalui easyCoexistence. Mereka tidak pernah memegang kunci anda, dan hanya membuka pautan sambungan mereka sendiri. Apa yang dilihat setiap pelanggan dalam produk anda ditentukan oleh kod anda.
Bolehkah saya beri setiap pelanggan URL webhook yang berbeza?
Boleh. Setiap nombor dan setiap saluran menerima destinasinya sendiri, jadi URL khusus pelanggan berfungsi, begitu juga satu URL dikongsi yang dihalakan mengikut account_id.
Bagaimana akaun berbilang pelanggan dibil?
Mengikut sambungan merentasi semua pelanggan anda bersama-sama: US$ 9 hingga US$ 0.75 setiap sambungan sebulan, ditetapkan oleh julat jumlah keseluruhan anda, dengan 3 hari pertama percuma.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada