Višekorisnički API za društvene mreže: jedan API ključ, nalozi mnogih klijenata
Partner API servisa easyCoexistence je višekorisnički po zamisli: jedan ključ ec_live_ na vašem nalogu povezuje i upravlja brojevima WhatsApp-a i nalozima na društvenim mrežama mnogih vaših klijenata. Svaka veza nosi ID vašeg klijenta kao external_ref, čuva token tog klijenta, ima sopstveno odredište za webhook i pojavljuje se u potpisanim događajima o statusu, pa GET /channels?external_ref= vraća naloge jednog klijenta.
Najduži external_ref koji sesija povezivanja prihvata: vaš sopstveni ID klijenta, sačuvan na vezi koju sesija kreira.
Broj API ključeva koje nalog easyCoexistence drži istovremeno; zasebni ključevi znače zasebne naloge sa zasebnim naplatama.
Broj sesija povezivanja koje jedan nalog može istovremeno da drži otvorenim, uz ograničenje od 100 novih sesija na sat.
Starost posle koje treba odbiti vremenski žig potpisanog događaja, uz poređenje HMAC-a u konstantnom vremenu.
Kako jedan nalog služi mnogim klijentima?
Vaš nalog na easyCoexistence predstavlja vaš proizvod, a svaki klijent je oznaka na vezama koje donosi. Klijenti ne prave sopstveni nalog, ne vide vaš ključ i naplaćujete ih vi, a ne easyCoexistence:
Kako označiti svaku vezu vašim klijentom?
Pošaljite external_ref u sesiji povezivanja. Vrednost se čuva na broju ili kanalu koji sesija napravi, dodaje se u preusmeravanje i uključuje u njegove događaje o statusu. Prijava preko Facebook-a ili LinkedIn-a koja donosi više stranica označava svaku od njih. Da biste videli naloge jednog klijenta, filtrirajte bilo koju listu:
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 čuvaju odvojeno?
Svaka veza čuva token svog klijenta. Token broja WhatsApp-a je poslovni token koji Meta izdaje pri toku Embedded Signup, vezan za imovinu tog klijenta, a token društvenog naloga je onaj koji mu je dao vlasnik naloga. Pristupni podaci dolaze samo preko vašeg ključa, s vašeg backenda, a ID koji nije na vašem nalogu vraća 404 not_found. Pre nego što preuzmete token, pronađite vezu za klijenta kome zadatak pripada, da posao jednog klijenta nikada ne bi radio na nalogu drugog.
Kako webhook-ovi funkcionišu po klijentu?
Jedno odredište po nalogu, koje birate vi. Usmerite kanale na jedan URL i rutirajte po account_id u telu zahteva, ili dajte svakom klijentu sopstveni URL. Svaki kanal potpisuje sopstvenim tajnim ključem koji postavljate preko PUT /channels/{id}/webhook, pa vam account_id kaže kojim ključem da proverite potpis. Poruke broja šalju se od Mete na webhook_url, koji se postavlja na WhatsApp Business Account, zato ih rutirajte po phone_number_id.
Kako događaji o statusu kažu kom klijentu pripadaju?
Tako što nose vaš external_ref. Jedan URL za događaje po nalogu prima connection.* i channel.* događaje, a svaki sadrži prikaz veze ili kanala, uključujući external_ref. Događaji post.published i post.failed nose objavu i njen kanal. Događaji se potpisuju sopstvenim tajnim ključem naloga u zaglavlju X-EC-Signature i ponavljaju se kada vaš endpoint ne uspe, zato obradite svaki delivery id samo jednom.
Koliko brzo možete da uvedete mnogo klijenata?
Najviše 50 otvorenih sesija povezivanja i 100 novih na sat po nalogu. Meta svako prvo WhatsApp uvođenje računa u ograničenje na nivou aplikacije, koje dele svi nalozi easyCoexistence, a ta ograničenja sprečavaju da uvoz jedne platforme iscrpi ceo kapacitet. Pravite svaku sesiju kada je njen klijent spreman da se poveže, a kad se ograničenje dostigne, odgovor je 429 cap_reached ili rate_limited.
Šta ako je nalog klijenta već povezan negde drugde?
Prijava se odbija. Društveni nalog se u jednom trenutku povezuje samo preko jednog naloga easyCoexistence, pa ako ga drži drugi servis koji koristi easyCoexistence, polje last_error sesije to kaže, a klijent ga uklanja tamo ili se prijavljuje drugim nalogom. Unutar vašeg naloga klijent može da poveže koliko god naloga treba, a svaki je označen sa istim external_ref.
Kako uklanjate jednog klijenta?
Navedite njegove veze i kanale po external_ref i obrišite svaku pomoću DELETE. Uklanjanje broja opoziva pristup koji easyCoexistence ima kod Mete i prekida praćenje; uklanjanje kanala opoziva pristup kod mreže i otkazuje 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.
Česte greške
- Korišćenje e-pošte kao external_ref. Adrese se menjaju, a vrednost se čuva na svakoj vezi, zato koristite stabilan ID iz vaše baze.
- Provera prosleđenih događaja pogrešnim tajnim ključem drugog klijenta. Potražite ključ po account_id u telu zahteva, jer svaki kanal potpisuje sopstvenim ključem.
- Slanje linkova za povezivanje celoj bazi klijenata odjednom. Otvoreno može biti samo 50 sesija po nalogu, zato pozivajte klijente u talasima.
- Brisanje klijenta samo u vašoj bazi. Njegove veze ostaju na vašem nalogu i na vašoj naplati dok se svaka ne ukloni preko API-ja.
easyCoexistence omogućava jednom API ključu da služi celoj bazi vaših klijenata: njihovim WhatsApp brojevima i njihovim nalozima na Instagramu, Facebooku, TikToku, YouTube-u i LinkedIn-u, i još kanala, svaki označen ID-jem vašeg klijenta, sa sopstvenim tokenom, webhook-om i potpisanim događajima, a veze se prate 24/7. Od US$ 9 do US$ 0,75 po vezi mesečno, sa padom kako dodajete veze, uz prva 3 dana besplatno.
Često postavljana pitanja
Treba li mi po jedan nalog easyCoexistence za svakog klijenta?
Ne. Jedan nalog i njegov ključ mogu da drže veze mnogih klijenata, razlikovane po external_ref. Zasebni nalozi su potrebni samo ako želite zasebne naplate.
Mogu li klijenti da vide tuđe naloge?
Ne preko easyCoexistence. Oni nikad ne drže vaš ključ i otvaraju samo sopstvene linkove za povezivanje. Šta svaki klijent vidi unutar vašeg proizvoda određuje vaš kod.
Mogu li svakom klijentu da dam drugačiji webhook URL?
Da. Svaki broj i svaki kanal dobija sopstveno odredište, pa radi i URL specifičan za klijenta i jedan zajednički URL koji rutira po account_id.
Kako se naplaćuje nalog sa više klijenata?
Po vezi, zbirno za sve vaše klijente: od US$ 9 do US$ 0,75 po vezi mesečno, a cenu određuje opseg ukupnog broja veza, uz prva 3 dana besplatno.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na