Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

API multi-client pentru social media: o cheie API, conturile multor clienți

API-ul pentru parteneri al easyCoexistence este multi-client prin concepție: o cheie ec_live_ din contul dumneavoastră conectează și gestionează numerele WhatsApp și conturile de social media ale mai multor clienți. Fiecare conexiune poartă ID-ul clientului dumneavoastră ca external_ref, deține propriul token al acelui client, are propria destinație webhook și apare în evenimentele de stare semnate, astfel încât GET /channels?external_ref= listează conturile unui singur client.

200 characters

Cea mai lungă valoare external_ref acceptată de o sesiune de conectare: ID-ul propriu al clientului, stocat pe conexiunea pe care o creează.

1 key

Chei API pe care le poate deține un cont easyCoexistence simultan; chei separate înseamnă conturi separate cu facturi separate.

50 open

Sesiuni de conectare pe care un cont le poate avea deschise simultan, alături de o limită de 100 de sesiuni noi pe oră.

5 minutes

Vârsta după care marcajul de timp al unui eveniment semnat trebuie respins, iar HMAC-ul se compară în timp constant.

Cum servește un singur cont mai mulți clienți?

Contul dumneavoastră easyCoexistence reprezintă produsul dumneavoastră, iar fiecare client este o etichetă pusă pe conexiunile pe care le aduce. Clienții nu își creează un cont propriu, nu văd niciodată cheia dumneavoastră și sunt facturați de dumneavoastră, nu de easyCoexistence:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Cum etichetați fiecare conexiune cu clientul dumneavoastră?

Trimiteți external_ref în sesiunea de conectare. Valoarea este stocată pe numărul sau canalul pe care îl creează sesiunea, adăugată la redirecționare și inclusă în evenimentele sale de stare. O autentificare Facebook sau LinkedIn care aduce mai multe pagini etichetează fiecare pagină în parte. Pentru a vedea conturile unui client, filtrați oricare dintre liste:

One customer's social accounts and numbers
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"

Cum sunt păstrate separat token-urile clienților?

Fiecare conexiune deține token-ul propriului client. Token-ul unui număr WhatsApp este token-ul de firmă emis de Meta la Embedded Signup, limitat la activele acelui client, iar token-ul unui cont de social media este cel acordat de proprietarul său. Credențialele vin doar prin cheia dumneavoastră, de pe serverul dumneavoastră, iar un ID care nu se află în contul dumneavoastră răspunde cu 404 not_found. Căutați conexiunea clientului căruia îi aparține o sarcină înainte de a prelua token-ul acestuia, astfel încât lucrul unui client să nu ruleze niciodată pe contul altuia.

Cum funcționează webhook-urile pentru fiecare client?

Câte o destinație pentru fiecare cont, aleasă de dumneavoastră. Indicați canalele către o singură adresă URL și rutați după account_id din corp sau dați fiecărui client o adresă URL proprie. Fiecare canal semnează cu propriul secret din PUT /channels/{id}/webhook, astfel încât account_id vă spune cu ce secret să verificați. Mesajele unui număr merg de la Meta către webhook_url, care se setează pe contul WhatsApp Business, deci rutați-le după phone_number_id.

Cum indică evenimentele de stare clientul la care se referă?

Prin faptul că poartă external_ref-ul dumneavoastră. Un URL de evenimente pe cont primește evenimentele connection.* și channel.*, fiecare cu vizualizarea conexiunii sau a canalului inclusă, external_ref cu tot, iar post.published și post.failed poartă postarea și canalul său. Evenimentele sunt semnate cu secretul propriu al contului în X-EC-Signature și reîncercate când endpoint-ul dumneavoastră eșuează, deci tratați ID-ul fiecărei livrări o singură dată.

Cât de repede puteți integra mulți clienți?

La 50 de sesiuni de conectare deschise și 100 de sesiuni noi pe oră pentru fiecare cont. Meta numără fiecare integrare WhatsApp făcută pentru prima dată față de o limită la nivelul întregii aplicații, pe care o împart toate conturile easyCoexistence, iar plafoanele împiedică importul unei platforme să o consume. Creați fiecare sesiune când clientul este pe punctul de a se conecta, iar un plafon răspunde cu 429 cap_reached sau rate_limited.

Ce se întâmplă dacă contul unui client este deja conectat altundeva?

Autentificarea este refuzată. Un cont de social media se conectează printr-un singur cont easyCoexistence la un moment dat, deci dacă alt serviciu care folosește easyCoexistence îl deține, last_error din sesiune spune asta, iar clientul îl elimină acolo sau se autentifică cu alt cont. În cadrul propriului cont, un client poate conecta câte conturi are nevoie, fiecare etichetat cu același external_ref.

Cum eliminați un client?

Listați conexiunile și canalele lor după external_ref și ștergeți fiecare cu DELETE. Eliminarea unui număr revocă accesul easyCoexistence la Meta și oprește monitorizarea; eliminarea unui canal revocă accesul la rețea și anulează postările sale care așteaptă încă în coadă. Facturarea pentru fiecare se oprește la sfârșitul ciclului, iar celelalte conexiuni ale clientului, ca cele ale altor clienți, rămân neatinse.

Greșeli frecvente

  • Folosirea unei adrese de e-mail ca external_ref. Adresele de e-mail se schimbă, iar valoarea este stocată pe fiecare conexiune, deci folosiți ID-ul stabil din propria bază de date.
  • Verificarea evenimentelor redirecționate cu secretul greșit al altui client. Căutați secretul după account_id din corp, deoarece fiecare canal semnează cu al său.
  • Trimiterea linkurilor de conectare către întreaga bază de clienți deodată. Doar 50 de sesiuni pot fi deschise pe cont, deci invitați clienții în valuri.
  • Ștergerea unui client doar în propria bază de date. Conexiunile lor rămân pe contul dumneavoastră și pe factura dumneavoastră până când fiecare este eliminată prin API.
Faceți acest lucru cu EasyCoexistence

easyCoexistence permite unei singure chei API să deservească întreaga bază de clienți: numerele lor WhatsApp și conturile lor de Instagram, Facebook, TikTok, YouTube și LinkedIn, plus alte canale, fiecare etichetat cu ID-ul clientului dumneavoastră, cu propriul token, webhook și evenimente semnate, iar fiecare conexiune este monitorizată 24/7. De la US$ 9 la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioada de probă gratuită de 3 zile.

Întrebări frecvente

Am nevoie de un cont easyCoexistence pentru fiecare client?

Nu. Un singur cont și cheia sa pot ține conexiunile mai multor clienți, diferențiate prin external_ref. Conturile separate sunt necesare doar dacă doriți facturi separate.

Pot clienții mei să vadă conturile altora?

Nu prin easyCoexistence. Ei nu dețin niciodată cheia dumneavoastră și deschid doar propriile linkuri de conectare. Ce vede fiecare client în produsul dumneavoastră este decis de codul dumneavoastră.

Pot oferi fiecărui client un URL webhook diferit?

Da. Fiecare număr și fiecare canal primește propria destinație, deci funcționează atât un URL specific clientului, cât și un URL comun rutat după account_id.

Cum se facturează un cont multi-client?

Pe conexiune, cumulat pentru toți clienții dumneavoastră: de la US$ 9 la US$ 0,75 pe conexiune pe lună, stabilit de banda în care se află totalul dumneavoastră, cu perioada de probă gratuită de 3 zile.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la