API ya mitandao ya kijamii yenye wateja wengi: ufunguo mmoja wa API, akaunti nyingi za wateja
Partner API ya easyCoexistence imeundwa kwa wateja wengi tangu mwanzo: ufunguo mmoja wa ec_live_ kwenye akaunti yako huunganisha na kusimamia nambari nyingi za WhatsApp na akaunti nyingi za mitandao ya kijamii za wateja. Kila muunganisho hubeba kitambulisho cha mteja wako kama external_ref, hushikilia token ya mteja huyo, hupata webhook yake yenyewe na huonekana kwenye matukio ya hali yaliyosainiwa, hivyo GET /channels?external_ref= huorodhesha akaunti za mteja mmoja.
Urefu mrefu zaidi wa external_ref ambao kipindi cha kuunganisha hupokea: kitambulisho chako mwenyewe cha mteja, kinachohifadhiwa kwenye muunganisho unaoundwa.
Idadi ya funguo za API ambazo akaunti ya easyCoexistence inashikilia kwa wakati mmoja; funguo tofauti humaanisha akaunti tofauti zenye bili tofauti.
Vipindi vya kuunganisha ambavyo akaunti moja inaweza kuwa nayo wazi kwa wakati mmoja, pamoja na kikomo cha vipindi vipya 100 kwa saa.
Muda baada ya ambao muhuri wa wakati wa tukio lililosainiwa unapaswa kukataliwa, na HMAC hulinganishwa kwa muda usiobadilika.
Akaunti moja inahudumiaje wateja wengi?
Akaunti yako ya easyCoexistence inawakilisha bidhaa yako, na kila mteja ni alama kwenye muunganisho anaouleta. Wateja hawaundi akaunti yao wenyewe, hawaoni ufunguo wako kamwe, na wanatozwa na wewe, si na easyCoexistence:
Unawekaje alama ya mteja wako kwenye kila muunganisho?
Tuma external_ref kwenye kipindi cha kuunganisha. Thamani hiyo huhifadhiwa kwenye nambari au chaneli inayoundwa na kipindi, huongezwa kwenye uelekezaji upya na kujumuishwa kwenye matukio yake ya hali. Kuingia kwa Facebook au LinkedIn kunakoleta kurasa kadhaa huweka alama kila moja. Ili kuona akaunti za mteja mmoja, chuja orodha yoyote kati ya hizi mbili:
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"Token za wateja zinatenganishwaje?
Kila muunganisho hushikilia token ya mteja wake mwenyewe. Token ya nambari ya WhatsApp ni token ya biashara ambayo Meta hutoa wakati wa Embedded Signup, iliyowekwa kwenye mali za mteja huyo, na token ya akaunti ya mtandao wa kijamii ni ile ambayo mmiliki wake alitoa ruhusa. Vitambulisho huja tu kupitia ufunguo wako, kutoka kwenye seva yako, na kitambulisho kisicho kwenye akaunti yako hujibu 404 not_found. Tafuta muunganisho wa mteja ambaye kazi inamhusu kabla ya kuchukua token yake, ili kazi ya mteja mmoja isiendeshwe kamwe kwenye akaunti ya mteja mwingine.
Webhook zinafanyaje kazi kwa kila mteja?
Webhook moja kwa kila akaunti, unayoichagua wewe. Elekeza chaneli kwenye URL moja na uelekeze kulingana na account_id kwenye mwili wa ombi, au mpe kila mteja URL yake mwenyewe. Kila chaneli husaini kwa siri yake kutoka PUT /channels/{id}/webhook, kwa hiyo account_id inakuambia ni siri gani ya kuthibitishia nayo. Jumbe za nambari hutoka Meta hadi webhook_url yake, iliyowekwa kwenye WhatsApp Business Account, kwa hiyo zielekeze kwa phone_number_id.
Matukio ya hali yanaonyeshaje mteja husika?
Kwa kubeba external_ref yako. URL moja ya matukio kwa kila akaunti hupokea matukio ya connection.* na channel.*, kila moja ikiwa na mtazamo wa muunganisho au chaneli ndani yake, pamoja na external_ref, na post.published na post.failed hubeba chapisho na chaneli yake. Matukio husainiwa kwa siri ya akaunti yenyewe katika X-EC-Signature na hujaribiwa tena endpoint yako inaposhindwa, kwa hiyo shughulikia kila delivery id mara moja tu.
Unawasajili wateja wengi kwa kasi gani?
Vipindi 50 vya kuunganisha vilivyo wazi na vipya 100 kwa saa kwa kila akaunti. Meta huhesabu kila muunganisho wa kwanza wa WhatsApp dhidi ya kikomo cha programu nzima kinachoshirikiwa na kila akaunti ya easyCoexistence, na vikomo hivi huzuia uingizaji wa jukwaa moja kumaliza kikomo hicho. Unda kila kipindi wakati mteja wake yuko tayari kuunganisha, na kikomo kikifikiwa kinajibu 429 cap_reached au rate_limited.
Itakuwaje mteja akiwa ameunganishwa tayari mahali pengine?
Kuingia kunakataliwa. Akaunti ya mitandao ya kijamii huunganishwa kupitia akaunti moja ya easyCoexistence kwa wakati mmoja, kwa hiyo huduma nyingine inayotumia easyCoexistence ikiishikilia, last_error ya kipindi inasema hivyo, na mteja aiondoe huko au aingie kwa akaunti tofauti. Ndani ya akaunti yako mwenyewe, mteja anaweza kuunganisha akaunti nyingi anazohitaji, kila moja ikiwa na alama ya external_ref ile ile.
Unamwondoa vipi mteja mmoja?
Orodhesha muunganisho na chaneli zake kwa external_ref, kisha tuma DELETE kwa kila moja. Kuondoa nambari hufuta ruhusa ya easyCoexistence kwa Meta na kusimamisha ufuatiliaji; kuondoa chaneli hufuta ufikiaji kwenye mtandao na kufuta machapisho yake yanayosubiri kwenye foleni. Bili kwa kila moja inasimama mwishoni mwa mzunguko, na miunganisho mingine ya mteja huyo, kama ya wateja wengine, haiguswi.
Makosa ya kawaida
- Kutumia barua pepe kama external_ref. Barua pepe hubadilika, na thamani hiyo huhifadhiwa kwenye kila muunganisho, kwa hiyo tumia kitambulisho thabiti kutoka kwenye hifadhidata yako.
- Kuthibitisha matukio yaliyosambazwa kwa siri ya mteja asiye sahihi. Tafuta siri kwa account_id iliyo kwenye mwili wa ombi, kwa sababu kila chaneli husaini kwa siri yake.
- Kutuma viungo vya kuunganisha kwa wateja wako wote kwa wakati mmoja. Vipindi 50 pekee vinaweza kuwa wazi kwa kila akaunti, kwa hiyo waalike wateja kwa makundi.
- Kumfuta mteja kwenye hifadhidata yako pekee. Miunganisho yake itabaki kwenye akaunti yako na bili yako hadi kila moja iondolewe kupitia API.
easyCoexistence inaruhusu ufunguo mmoja wa API kuhudumia wateja wako wote: nambari zao za WhatsApp na akaunti zao za Instagram, Facebook, TikTok, YouTube na LinkedIn, pamoja na chaneli nyingine zaidi, kila moja ikiwa na alama ya kitambulisho cha mteja wako, token yake, webhook na matukio yaliyosainiwa, na kila muunganisho ukifuatiliwa saa 24 kwa siku. Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kinashuka unapoongeza miunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, ninahitaji akaunti moja ya easyCoexistence kwa kila mteja?
Hapana. Akaunti moja na ufunguo wake inaweza kushikilia muunganisho wa wateja wengi, zinazotofautishwa kwa external_ref. Akaunti tofauti zinahitajika tu unapotaka bili tofauti.
Je, wateja wangu wanaweza kuona akaunti za kila mmoja?
Si kupitia easyCoexistence. Hawashiki ufunguo wako kamwe, na hufungua viungo vyao vya kuunganisha pekee. Kile kila mteja anachokiona ndani ya bidhaa yako kinaamuliwa na msimbo wako.
Je, naweza kumpa kila mteja URL tofauti ya webhook?
Ndiyo. Kila nambari na kila chaneli inachukua mwelekeo wake, kwa hiyo URL mahususi kwa mteja inafanya kazi, kama vile URL moja ya pamoja inayoelekezwa kwa account_id.
Akaunti yenye wateja wengi inatozwa vipi?
Kwa muunganisho katika wateja wako wote kwa pamoja: kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, kwa kuzingatia ngazi ya jumla ya idadi yako, na siku 3 za kwanza bila malipo.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye