Višeklijentski API za društvene mreže: jedan API ključ, računi mnogih klijenata
Partner API usluge easyCoexistence osmišljen je kao višeklijentski: jedan ključ ec_live_ na vašem računu povezuje WhatsApp brojeve i račune društvenih mreža mnogih klijenata te njima upravlja. Svaka veza nosi id vašeg klijenta kao external_ref, ima vlastiti token tog klijenta, vlastito odredište webhooka i pojavljuje se u potpisanim događajima o statusu, pa GET /channels?external_ref= popisuje račune jednog klijenta.
Najduži external_ref koji sesija povezivanja prihvaća: vlastiti id klijenta, pohranjen na vezi koju ona stvara.
Broj API ključeva koje račun easyCoexistence drži istovremeno; zasebni ključevi znače zasebne račune s odvojenom naplatom.
Broj sesija povezivanja koje jedan račun može imati otvorene istovremeno, uz ograničenje od 100 novih sesija na sat.
Starost nakon koje se vremenski žig potpisanog događaja treba odbiti, uz usporedbu HMAC-a konstantnim vremenom.
Kako jedan račun služi mnogim klijentima?
Vaš račun easyCoexistence predstavlja vaš proizvod, a svaki klijent je oznaka na vezama koje donosi. Klijenti nemaju vlastiti račun, nikad ne vide vaš ključ, a naplaćujete ih vi, a ne easyCoexistence:
Kako označiti svaku vezu svojim klijentom?
Pošaljite external_ref u sesiji povezivanja. Vrijednost se pohranjuje na broj ili kanal koji sesija stvara, dodaje se u preusmjeravanje i uključuje u njezine događaje o statusu. Prijava putem Facebooka ili LinkedIna koja donosi više stranica označava svaku od njih. Za prikaz računa jednog klijenta filtrirajte bilo koji popis:
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"Kako se tokeni klijenata drže odvojeno?
Svaka veza ima token svog klijenta. Token WhatsApp broja je poslovni token koji Meta izdaje putem postupka Embedded Signup, vezan uz imovinu tog klijenta, a token društvenog računa je onaj koji mu je vlasnik dodijelio. Vjerodajnice dolaze isključivo putem vašeg ključa, s vašeg poslužitelja, a ID koji nije na vašem računu vraća 404 not_found. Prije dohvaćanja tokena pronađite vezu za klijenta kojem posao pripada, tako da se rad jednog klijenta nikad ne izvodi na računu drugoga.
Kako webhookovi rade po klijentu?
Jedno odredište po računu, koje birate vi. Usmjerite kanale na jedan URL i usmjeravajte ih prema account_id u tijelu zahtjeva ili dajte svakom klijentu vlastiti URL. Svaki kanal potpisuje vlastitim tajnim ključem iz PUT /channels/{id}/webhook, pa vam account_id govori kojim ključem provjeriti potpis. Poruke jednog broja Meta šalje na njegov webhook_url, koji se postavlja na WhatsApp Business Account, pa ih usmjeravajte prema phone_number_id.
Kako događaji o statusu kažu kojem klijentu pripadaju?
Nose vaš external_ref. Jedan URL za događaje po računu prima događaje connection.* i channel.*, a svaki sadrži prikaz veze ili kanala s external_ref; post.published i post.failed nose objavu i njezin kanal. Događaje potpisuje vlastiti tajni ključ računa u zaglavlju X-EC-Signature, a ponavljaju se kad vaš endpoint ne uspije, pa svaki delivery id obradite samo jednom.
Koliko brzo možete uvesti mnogo klijenata?
Do 50 otvorenih sesija povezivanja i 100 novih na sat po računu. Meta broji svako prvo WhatsApp uvođenje prema ograničenju na razini aplikacije koje dijele svi računi easyCoexistence, a ta ograničenja sprječavaju da uvoz jedne platforme potroši cijelo ograničenje. Sesiju stvarajte u trenutku kad je njezin klijent spreman na povezivanje, a ograničenje vraća 429 cap_reached ili rate_limited.
Što ako je račun klijenta već povezan drugdje?
Prijava se odbija. Društveni račun se povezuje kroz jedan račun easyCoexistence u jednom trenutku, pa ako ga drži neka druga usluga koja koristi easyCoexistence, last_error sesije to kaže i klijent ga uklanja tamo ili se prijavljuje drugim računom. Unutar vašeg računa klijent može povezati koliko god računa treba, svaki označen istim external_ref.
Kako ukloniti jednog klijenta?
Popišite njegove veze i kanale po external_ref i obrišite svaku pomoću zahtjeva DELETE. Uklanjanje broja opoziva pristup easyCoexistence kod Mete i prekida praćenje; uklanjanje kanala opoziva pristup na mreži i otkazuje njegove objave koje još čekaju u redu. Naplata za svaku prestaje na kraju ciklusa, a ostale veze tog klijenta, kao i veze drugih klijenata, ostaju netaknute.
Uobičajene pogreške
- Upotreba e-adrese kao external_ref. Adrese se mijenjaju, a vrijednost se pohranjuje na svaku vezu, zato koristite stabilan id iz vaše vlastite baze podataka.
- Provjeravanje proslijeđenih događaja tajnim ključem drugog klijenta. Ključ potražite po account_id iz tijela zahtjeva, jer svaki kanal potpisuje vlastitim ključem.
- Slanje poveznica za povezivanje cijeloj bazi klijenata odjednom. Po računu može biti otvoreno samo 50 sesija, pa klijente pozivajte u valovima.
- Brisanje klijenta samo u vlastitoj bazi podataka. Njegove veze ostaju na vašem računu i u vašoj naplati dok se svaka ne ukloni putem API-ja.
easyCoexistence omogućuje jednom API ključu da služi cijeloj bazi klijenata: njihovim WhatsApp brojevima te računima Instagrama, Facebooka, TikToka, YouTubea i LinkedIna i još kanala, svaki označen id-om vašeg klijenta, s vlastitim tokenom, webhookom i potpisanim događajima, uz praćenje svake veze 24/7. US$ 9 do US$ 0,75 po vezi mjesečno, uz sniženje kako dodajete veze, s prvih 3 dana besplatno.
Često postavljana pitanja
Trebam li jedan račun easyCoexistence po klijentu?
Ne. Jedan račun i njegov ključ mogu držati veze mnogih klijenata, razlikovane po external_ref. Zasebni računi potrebni su samo ako želite zasebnu naplatu.
Mogu li klijenti vidjeti tuđe račune?
Ne putem easyCoexistencea. Klijenti nikad ne drže vaš ključ i otvaraju samo vlastite poveznice za povezivanje. Što svaki klijent vidi unutar vašeg proizvoda, odlučuje vaš kod.
Mogu li svakom klijentu dati drugačiji webhook URL?
Da. Svaki broj i svaki kanal ima vlastito odredište, pa URL za pojedinog klijenta radi, kao i jedan zajednički URL usmjeravan prema account_id.
Kako se naplaćuje račun za više klijenata?
Po vezi, zbrojeno za sve vaše klijente: US$ 9 do US$ 0,75 po vezi mjesečno, prema pojasu vašeg ukupnog broja, s prvih 3 dana besplatno.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na