Multi-tenant social media API: isang API key, maraming account ng customer
Ang Partner API ng easyCoexistence ay multi-tenant sa disenyo: isang ec_live_ key sa inyong account ang kumokonekta at namamahala sa maraming WhatsApp number at social account ng inyong mga customer. Bawat koneksyon ay may customer id ninyo bilang external_ref, hawak ang sariling token ng customer na iyon, may sariling webhook destination, at lumalabas sa signed status event, kaya inililista ng GET /channels?external_ref= ang mga account ng isang customer lamang.
Pinakamahabang external_ref na tinatanggap ng connect session: ang sariling id ninyo para sa customer, na iniimbak sa koneksyong nalikha nito.
API key na maaaring hawakan ng isang easyCoexistence account sa isang pagkakataon; magkakahiwalay na key ay nangangahulugang magkakahiwalay na account na may magkakahiwalay na bill.
Connect session na maaaring nakabukas nang sabay-sabay sa isang account, kasama ang limitasyong 100 bagong session kada oras.
Edad ng signed event na timestamp kung kailan dapat itong tanggihan, at ang HMAC ay ikinukumpara sa constant time.
Paano pinagsisilbihan ng iisang account ang maraming customer?
Ang inyong easyCoexistence account ang kumakatawan sa inyong produkto, at bawat customer ay tag sa mga koneksyong dinadala nila. Walang sariling account na kailangang gawin ang mga customer, hindi nila nakikita ang inyong key, at kayo ang naniningil sa kanila, hindi ang easyCoexistence:
Paano ninyo i-tag ang bawat koneksyon sa inyong customer?
Ipadala ang external_ref sa connect session. Ang value ay iniimbak sa numero o channel na nalilikha ng session, idinadagdag sa redirect, at kasama sa status event nito. Ang isang Facebook o LinkedIn sign-in na nagdadala ng ilang Page ay nagta-tag sa bawat isa. Para makita ang mga account ng isang customer, i-filter ang alinmang listahan:
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"Paano pinananatiling hiwalay ang token ng mga customer?
Bawat koneksyon ay may sariling token ng customer nito. Ang token ng WhatsApp number ay ang business token na ibinibigay ng Meta sa Embedded Signup, nakatakda sa mga asset ng customer na iyon, at ang token ng social account ay ang ipinagkaloob ng may-ari nito. Ang mga credential ay ibinibigay lamang sa pamamagitan ng inyong key, mula sa inyong backend, at ang ID na wala sa inyong account ay sasagot ng 404 not_found. Hanapin muna ang koneksyon ng customer kung kanino ang trabaho bago kunin ang token nito, upang hindi tumakbo ang gawain ng isang tenant sa account ng iba.
Paano gumagana ang webhook bawat customer?
Isang destination bawat account, na pinipili ninyo. Ituro ang mga channel sa iisang URL at i-route ayon sa account_id sa body, o bigyan ang bawat customer ng sariling URL. Bawat channel ay nagsa-sign gamit ang sariling secret mula sa PUT /channels/{id}/webhook, kaya sinasabi ng account_id kung aling secret ang gagamitin sa pag-verify. Ang mga mensahe ng isang number ay galing sa Meta papunta sa webhook_url nito, na itinatakda sa WhatsApp Business Account, kaya i-route ang mga iyon ayon sa phone_number_id.
Paano sinasabi ng status event kung aling customer ang tinutukoy?
Sa pamamagitan ng pagdadala ng inyong external_ref. Isang events URL bawat account ang tumatanggap ng connection.* at channel.* na event, bawat isa may connection o channel view sa loob, kasama ang external_ref, at ang post.published at post.failed ay may dalang post at channel nito. Naka-sign ang mga event gamit ang sariling secret ng account sa X-EC-Signature at inuulit kapag pumapalya ang endpoint ninyo, kaya hawakan ang bawat delivery id nang isang beses lang.
Gaano kabilis ang onboarding ng maraming customer?
Hanggang 50 bukas na connect session at 100 bagong session kada oras bawat account. Binibilang ng Meta ang bawat unang WhatsApp onboarding laban sa limitasyong pang-app na ibinabahagi ng bawat easyCoexistence account, at pinipigilan ng mga cap na maubos ito ng import ng isang platform. Gumawa ng session kapag malapit nang kumonekta ang kaukulang customer, at ang cap ay sasagot ng 429 cap_reached o rate_limited.
Ano kung nakakonekta na sa iba ang account ng customer?
Tatanggihan ang sign-in. Isang easyCoexistence account lamang ang maaaring kumonekta sa isang social account sa isang pagkakataon, kaya kung may hawak na nito ang ibang serbisyong gumagamit ng easyCoexistence, sasabihin ito ng last_error ng session, at aalisin ito ng customer doon o mag-sign in gamit ang ibang account. Sa loob ng inyong account, maaaring kumonekta ang customer ng kasing dami ng account na kailangan niya, bawat isa ay may tag na parehong external_ref.
Paano tanggalin ang isang customer?
Ilista ang kanilang koneksyon at channel sa pamamagitan ng external_ref at i-DELETE ang bawat isa. Ang pag-alis ng number ay binabawi ang access ng easyCoexistence sa Meta at itinitigil ang monitoring; ang pag-alis ng channel ay binabawi ang access sa network at kinakansela ang mga post nitong nasa pila pa. Titigil ang singil sa bawat isa pagtatapos ng cycle, at ang iba pang koneksyon ng customer, gayundin ang sa ibang tenant, ay hindi ginagalaw.
Mga karaniwang pagkakamali
- Paggamit ng email bilang external_ref. Nagbabago ang email at iniimbak ang value sa bawat koneksyon, kaya gamitin ang stable na id mula sa sarili ninyong database.
- Pag-verify ng ipinasang event gamit ang secret ng maling tenant. Hanapin ang secret ayon sa account_id sa body, dahil bawat channel ay may sariling secret.
- Pagpapadala ng connect link sa buong customer base nang sabay-sabay. 50 session lamang ang maaaring nakabukas bawat account, kaya mag-imbita ng customer sa mga batch.
- Pagtanggal ng customer sa sarili ninyong database lamang. Nananatili ang kanilang koneksyon sa inyong account at sa inyong bill hanggang maalis ang bawat isa sa pamamagitan ng API.
Pinapayagan ng easyCoexistence ang isang API key na pagsilbihan ang buong customer base ninyo: ang kanilang WhatsApp number at ang kanilang Instagram, Facebook, TikTok, YouTube at LinkedIn account, at marami pang channel, bawat isa ay may tag na customer id ninyo, sariling token, webhook at signed event, at bawat koneksyon ay pinamomonitor 24/7. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag ng koneksyon, at may unang 3 araw na libre.
Mga madalas itanong
Kailangan ko ba ng isang easyCoexistence account bawat customer?
Hindi. Ang isang account at ang key nito ay maaaring humawak sa mga koneksyon ng maraming customer, na nakikilala sa pamamagitan ng external_ref. Kailangan lamang ng hiwalay na account kapag gusto ninyo ng hiwalay na bill.
Nakikita ba ng mga customer ko ang account ng isa't isa?
Hindi sa pamamagitan ng easyCoexistence. Hindi nila hawak ang inyong key, at ang sarili lamang nilang connect link ang binubuksan nila. Ang nakikita ng bawat customer sa loob ng inyong produkto ay nakadepende sa inyong code.
Maaari ko bang bigyan ang bawat customer ng ibang webhook URL?
Oo. Bawat number at bawat channel ay may sariling destination, kaya gumagana ang URL na partikular sa customer, gayundin ang isang shared URL na nire-route ayon sa account_id.
Paano sinisingil ang multi-tenant account?
Bawat koneksyon sa lahat ng customer ninyo nang sama-sama: mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, itinatakda ayon sa banda ng kabuuang bilang ninyo, at may unang 3 araw na libre.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong