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

API social media pentru agenții: gestionați conturile clienților din propriul software

Un API pentru agenții permite software-ului agenției să conecteze, să publice, să răspundă și să raporteze despre conturile fiecărui client. Cu Partner API de la easyCoexistence, numărul WhatsApp al unui client și conturile sale de Instagram, Facebook, TikTok, YouTube și LinkedIn se alătură contului agenției prin linkuri găzduite etichetate cu id-ul clientului, iar o singură cheie API programează, direcționează și monitorizează toate acestea.

200 characters

Cel mai lung external_ref pe care îl acceptă o sesiune de conectare: id-ul agenției pentru client, păstrat pe fiecare conexiune.

1 hour

Cât timp funcționează un link de conectare găzduit pentru clientul care îl deschide.

Advanced Access

Ce are nevoie o aplicație Meta pentru a deservi conturi profesionale de Instagram pe care nu le deține și nu le administrează, după App Review și verificarea afacerii.

ADMINISTRATOR

Rolul de pagină LinkedIn necesar unui membru pentru permisiunea rw_organization_admin, care administrează paginile și citește rapoartele lor.

End of cycle

Când se oprește facturarea pentru o conexiune a unui client pe care agenția o elimină prin API.

Cum organizează API-ul clienții unei agenții?

După id-ul clientului, trimis ca external_ref la fiecare sesiune de conectare. Acesta rămâne pe fiecare număr și cont creat de sesiune și revine în fiecare eveniment de stare. GET /channels?external_ref=client_118 listează conturile sociale ale clientului, iar &channel=instagram le restrânge la o singură rețea, iar GET /connections?external_ref=client_118 listează numerele sale WhatsApp. Fiecare client se află sub unicul cont al agenției, sub o singură cheie ec_live_, ceea ce face ca întregul număr să intre într-o singură bandă de preț.

One client's accounts
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

Cum predă un client accesul?

Printr-un link trimis de agenție. POST /connect-sessions cu rețeaua drept channel, external_ref-ul clientului și numele agenției drept partner_name returnează un url. Clientul îl deschide, se autentifică pe ecranul de consimțământ al rețelei sau rulează fereastra Meta și scanează un cod QR pentru un număr WhatsApp, apoi revine la redirect_url-ul agenției. O autentificare cu Facebook sau LinkedIn poate aduce mai multe pagini deodată, fiecare cu propria conexiune, deci verificați lista în raport cu brief-ul clientului.

Cum publică agenția pentru clienți?

Din propriul flux de aprobare. Software-ul agenției păstrează ciornele până când clientul le aprobă, apoi trimite fiecare postare aprobată la POST /channels/:id/posts cu publish_at, până la 90 de zile înainte. GET /channels/:id/posts oferă calendarul unui cont, GET /posts cu un filtru de stare arată ce așteaptă între clienți, iar post.published și post.failed îi spun managerului de conturi ce s-a întâmplat. Postările LinkedIn trec întotdeauna prin aprobarea unei persoane, ceea ce oferă deja pasul de aprobare al agenției.

Cum răspunde agenția la comentarii și DM-uri pentru clienți?

Dintr-o singură căsuță de mesaje care direcționează după cont. PUT /channels/:id/webhook setează o destinație pentru fiecare cont de Instagram, pagină de Facebook și cont de TikTok, iar fiecare comentariu, mențiune sau DM-uri redirecționate poartă account_id, care duce la client. Mesajele unui număr WhatsApp pleacă de la Meta către webhook_url-ul setat pentru el. Răspunsurile pleacă prin API-ul fiecărei rețele, cu credențialele din GET /channels/:id?credentials=1, iar echipa agenției poate lucra și între clienți în Claude sau ChatGPT prin conectorul MCP de pe același cont.

Cum construiește agenția rapoarte pentru clienți?

Din analizele fiecărei rețele, apelate cu credențialele contului clientului. Datele Instagram și Facebook vin din Graph API-ul Meta, cele TikTok din API-ul pentru afaceri, cele YouTube din YouTube Analytics, a cărui bază o includ credențialele, iar cele LinkedIn din endpoint-urile sale de statistici. Jobul de raportare al agenției obține credențiale proaspete pentru fiecare cont la începutul fiecărei rulări, extrage cifrele perioadei și le arhivează sub external_ref-ul clientului.

Cum află agenția că un cont al clientului necesită atenție?

Din evenimente de stare semnate. channel.disconnected și connection.disconnected poartă external_ref-ul clientului, astfel încât software-ul agenției poate alerta managerul de conturi al clientului și îi poate trimite clientului un link nou de conectare. Fiecare conexiune este monitorizată 24/7, iar proprietarul agenției primește și un e-mail când una se întrerupe. Un client care retrage accesul din setările rețelei apare în același mod.

Ce se întâmplă în API când pleacă un client?

Jobul de offboarding al agenției listează conexiunile clientului după external_ref și apelează DELETE /channels/:id și DELETE /connections/:id pentru fiecare. Facturarea lor se oprește la sfârșitul ciclului, postările programate pe un canal eliminat sunt anulate, iar token-ul unui cont social eliminat este uitat. Un număr WhatsApp rămâne pe Cloud API până când clientul îl deconectează din aplicația WhatsApp Business.

Greșeli frecvente

  • Punerea în coadă a postărilor clientului înainte ca acesta să aprobe. O postare pusă în coadă se publică la ora ei fără altă verificare, așa că țineți ciornele în pasul de aprobare și trimiteți-le doar după aprobare.
  • Punerea cheii Partner API în front-end-ul unui portal de clienți. Cheia ajunge la credențialele tuturor clienților din cont, așa că păstrați-o pe serverul agenției.
  • Așteptarea evenimentelor de comentarii de pe canalul YouTube al unui client sau de pe pagina LinkedIn. easyCoexistence nu primește niciunul de la acestea, așa că jobul de raportare sau de căsuța de mesaje le citește prin API-ul fiecărei rețele.
Faceți acest lucru cu EasyCoexistence

easyCoexistence oferă software-ului unei agenții un singur API pentru numerele WhatsApp ale clienților și conturile lor de Instagram, Facebook, TikTok, YouTube și LinkedIn, plus alte canale: linkuri de conectare găzduite etichetate pe client, o coadă de publicare, comentarii și DM-uri redirecționate, credențiale proaspete pentru rapoarte și fiecare conexiune monitorizată 24/7. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, cu scădere pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Clienții au nevoie de propriul cont easyCoexistence?

Nu. Clientul deschide linkul găzduit și se autentifică, iar conexiunea se alătură contului agenției, unde este facturată și monitorizată.

Poate agenția să păstreze clienții pe chei API separate?

Un cont are o singură cheie. Chei separate înseamnă conturi easyCoexistence separate, fiecare facturată din prima bandă, așa că cele mai multe agenții țin clienții separați după external_ref.

Poate clientul să vadă numele agenției la conectare?

Da. Pagina găzduită arată numele trimis drept partner_name. Ecranul de consimțământ al rețelei numește easyCoexistence drept aplicația care cere accesul.

Cât costă easyCoexistence pentru o agenție?

De la US$ 9 până la US$ 0,75 pe conexiune de client pe lună, cu scădere pe măsură ce agenția adaugă clienți, la fel pe fiecare rețea, cu primele 3 zile gratuite.

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