API social media per agenzie: gestisci gli account dei tuoi clienti dal tuo software
Un'API social media per agenzie permette al software dell'agenzia di collegare, pubblicare, rispondere e fare report sugli account di ogni cliente. Con la Partner API di easyCoexistence, il numero WhatsApp di un cliente e i suoi account Instagram, Facebook, TikTok, YouTube e LinkedIn entrano nell'account dell'agenzia tramite link ospitati etichettati con l'id del cliente, e una sola chiave API pianifica, instrada e monitora tutti questi account.
La lunghezza massima di external_ref accettata da una sessione di connessione, cioè l'id dell'agenzia per il cliente, conservato su ogni connessione.
Per quanto tempo un link di connessione ospitato resta valido per il cliente che lo apre.
Cosa serve a un'app Meta per servire account Instagram professionali che non possiede né gestisce, dopo App Review e Business Verification.
Il ruolo nella Pagina LinkedIn che un membro deve avere per il permesso rw_organization_admin, che gestisce le Pagine e ne legge i report.
Quando la fatturazione si interrompe per una connessione di cliente che l'agenzia rimuove tramite API.
Come organizza l'API i clienti di un'agenzia?
Tramite il tuo id cliente. Invialo come external_ref in ogni sessione di connessione: resta su ogni numero e account creato dalla sessione e torna in ogni evento di stato. GET /channels?external_ref=client_118 elenca gli account social di quel cliente, con &channel=instagram per limitarlo a una rete, e GET /connections?external_ref=client_118 elenca i suoi numeri WhatsApp. Ogni cliente sta sull'unico account dell'agenzia, sotto una sola chiave ec_live_, ed è ciò che mette l'intero conteggio in una sola fascia di prezzo.
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"Come consegna un cliente l'accesso?
Tramite un link che l'agenzia invia. POST /connect-sessions con la rete come channel, l'external_ref del cliente e il nome dell'agenzia come partner_name restituisce un url; il cliente lo apre, accede dalla schermata di consenso della rete stessa, oppure usa il popup di Meta e scansiona un codice QR per un numero WhatsApp, e torna al redirect_url dell'agenzia. Un accesso con Facebook o LinkedIn può portare più Pagine in una volta, ciascuna con la propria connessione, quindi verifica l'elenco rispetto al brief del cliente.
Come l'agenzia pubblica per i clienti?
Dal proprio flusso di approvazione. Il software dell'agenzia conserva le bozze finché il cliente non dà il via libera, poi invia ogni post approvato a POST /channels/:id/posts con il suo publish_at, fino a 90 giorni in anticipo. GET /channels/:id/posts restituisce il calendario di un account, GET /posts con un filtro sullo stato mostra ciò che attende tra i clienti, e post.published e post.failed dicono al responsabile dell'account cosa è successo. I post su LinkedIn passano sempre dall'approvazione di una persona, che il passaggio di approvazione dell'agenzia già prevede.
Come l'agenzia risponde a commenti e DM per i clienti?
Da un'unica inbox che instrada per account. PUT /channels/:id/webhook imposta una destinazione per ogni account Instagram, Pagina Facebook e account TikTok, e ogni commento, menzione o DM inoltrato porta con sé account_id, che rimanda al cliente. I messaggi di un numero WhatsApp vanno da Meta al webhook_url impostato per quel numero. Le risposte escono dall'API di ciascuna rete con le credenziali di GET /channels/:id?credentials=1, e il team dell'agenzia può anche lavorare tra i clienti in Claude o ChatGPT tramite il connettore MCP sullo stesso account.
Come l'agenzia costruisce i report dei clienti?
Dalle analytics di ciascuna rete, interrogate con le credenziali dell'account del cliente. Gli insight di Instagram e Facebook provengono dalla Graph API di Meta, quelli di TikTok dalla sua API for Business, quelli di YouTube da YouTube Analytics, la cui base è inclusa nelle credenziali, e quelli di LinkedIn dai suoi endpoint di statistiche. Il job di report dell'agenzia recupera credenziali fresche per ogni account all'inizio di ogni esecuzione, scarica i dati del periodo e li archivia sotto l'external_ref del cliente.
Come sa l'agenzia che l'account di un cliente richiede attenzione?
Dagli eventi di stato firmati. channel.disconnected e connection.disconnected portano l'external_ref del cliente, così il software dell'agenzia può avvisare il responsabile dell'account di quel cliente e inviargli un nuovo link di connessione. Ogni connessione è monitorata 24/7, e anche il titolare dell'agenzia riceve un'email quando una cade. Un cliente che revoca l'accesso nelle impostazioni della rete compare allo stesso modo.
Che cosa succede nell'API quando un cliente se ne va?
Il job di rimozione dei clienti elenca le connessioni del cliente per external_ref e chiama DELETE /channels/:id e DELETE /connections/:id su ciascuna. La fatturazione per queste si ferma alla fine del ciclo di fatturazione, i post programmati su un canale rimosso vengono annullati e il token di un account social rimosso viene dimenticato. Un numero WhatsApp resta su Cloud API finché il cliente non lo disconnette dall'app WhatsApp Business.
Errori comuni
- Mettere in coda i post dei clienti prima che il cliente dia il via libera. Un post in coda viene pubblicato all'orario previsto senza un ulteriore controllo, quindi tieni le bozze nel passaggio di approvazione e inviale solo quando sono approvate.
- Inserire la chiave della Partner API nel front end del portale di un cliente. La chiave dà accesso alle credenziali di ogni cliente sull'account, quindi tienila sul server dell'agenzia.
- Aspettarsi eventi di commento dal canale YouTube di un cliente o dalla Pagina LinkedIn. easyCoexistence non ne riceve da nessuno dei due, quindi il job di report o di inbox li legge tramite l'API di ciascuna rete.
easyCoexistence dà al software dell'agenzia un'unica API per i numeri WhatsApp dei clienti e per i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, e altri canali in arrivo: link di connessione ospitati etichettati per cliente, una coda di pubblicazione, commenti e DM inoltrati, credenziali fresche per i report e ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con il prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Anche i clienti hanno bisogno di un proprio account easyCoexistence?
No. Il cliente apre il link ospitato e accede, e la connessione entra nell'account dell'agenzia, dove viene fatturata e monitorata.
L'agenzia può tenere i clienti su chiavi API separate?
Un account ha una sola chiave. Chiavi separate significano account easyCoexistence separati, ciascuno fatturato dalla prima fascia, per questo la maggior parte delle agenzie tiene i clienti separati tramite external_ref.
Il cliente può vedere il nome dell'agenzia durante la connessione?
Sì. La pagina ospitata mostra il nome inviato come partner_name. La schermata di consenso della rete indica easyCoexistence come l'app che chiede l'accesso.
Quanto costa easyCoexistence per un'agenzia?
Da US$ 9 a US$ 0,75 per connessione di cliente al mese, con il prezzo che scende man mano che l'agenzia aggiunge clienti, uguale su ogni rete, con i primi 3 giorni di prova gratuita.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il