AccediInizia la prova gratuita
easyCoexistence API ufficiali

API per piattaforme multi-tenant: una chiave API, molti account dei clienti

La Partner API di easyCoexistence è multi-tenant per progettazione: una chiave ec_live_ sul tuo account connette e gestisce i numeri WhatsApp e gli account social di molti clienti. Ogni connessione porta l'id del cliente come external_ref, mantiene il token proprio di quel cliente, ha una propria destinazione webhook e compare negli eventi di stato firmati, quindi GET /channels?external_ref= elenca gli account di un solo cliente.

200 characters

Lunghezza massima di external_ref accettata da una sessione di connessione: l'id che usi per il cliente, salvato sulla connessione creata.

1 key

Chiavi API che un account easyCoexistence può avere contemporaneamente; chiavi separate significano account separati con fatture separate.

50 open

Sessioni di connessione che un account può tenere aperte insieme, accanto a un limite di 100 nuove sessioni all'ora.

5 minutes

Età oltre la quale il timestamp di un evento firmato va rifiutato, con l'HMAC confrontato in tempo costante.

Come fa un solo account a servire molti clienti?

Il tuo account easyCoexistence rappresenta il tuo prodotto, e ogni cliente è un'etichetta sulle connessioni che porta. I clienti non creano un account proprio, non vedono mai la tua chiave e vengono fatturati da te, non da 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

Come marchi ogni connessione con il tuo cliente?

Invia external_ref nella sessione di connessione. Il valore viene salvato sul numero o sul canale che la sessione crea, aggiunto al reindirizzamento e incluso nei suoi eventi di stato. Un accesso Facebook o LinkedIn che porta più Pagine marca ciascuna di esse. Per vedere gli account di un cliente, filtra una delle due 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"

Come restano separati i token dei clienti?

Ogni connessione mantiene il token del proprio cliente. Il token di un numero WhatsApp è il token dell'azienda che Meta emette in Embedded Signup, limitato agli asset di quel cliente, mentre il token di un account social è quello concesso dal suo titolare. Le credenziali arrivano solo tramite la tua chiave, dal tuo backend, e un ID che non è nel tuo account risponde 404 not_found. Cerca la connessione del cliente a cui appartiene un job prima di richiederne il token, così il lavoro di un cliente non viene mai eseguito sull'account di un altro.

Come funzionano i webhook per cliente?

Una destinazione per account, scelta da te. Puoi puntare i canali a un solo URL e instradare in base ad account_id nel corpo, oppure assegnare a ogni cliente un URL proprio. Ogni canale firma con il proprio segreto da PUT /channels/{id}/webhook, quindi account_id ti dice con quale segreto verificare. I messaggi di un numero vanno da Meta al suo webhook_url, impostato sul WhatsApp Business Account, quindi instradali in base a phone_number_id.

Come fanno gli eventi di stato a indicare a quale cliente si riferiscono?

Portando il tuo external_ref. Un URL di eventi per account riceve gli eventi connection.* e channel.*, ciascuno con la vista della connessione o del canale al suo interno, external_ref incluso, mentre post.published e post.failed portano il post e il suo canale. Gli eventi sono firmati con il segreto dell'account in X-EC-Signature e vengono ritentati quando il tuo endpoint non risponde, quindi elabora ogni id di consegna una sola volta.

Quanto velocemente puoi attivare molti clienti?

Con 50 sessioni di connessione aperte e 100 nuove all'ora per account. Meta conta ogni onboarding WhatsApp alla prima volta rispetto a un limite a livello di app che tutti gli account easyCoexistence condividono, e i tetti impediscono che l'importazione di una piattaforma lo esaurisca. Crea ogni sessione quando il suo cliente sta per connettersi: un tetto risponde 429 cap_reached oppure rate_limited.

Cosa succede se l'account di un cliente è già connesso altrove?

L'accesso viene rifiutato. Un account social si connette a un account easyCoexistence alla volta, quindi se un altro servizio che usa easyCoexistence lo ha già, last_error della sessione lo indica e il cliente lo rimuove da lì oppure accede con un altro account. All'interno del tuo account, un cliente può connettere tutti gli account che gli servono, ciascuno marcato con lo stesso external_ref.

Come rimuovi un cliente?

Elenca le sue connessioni e i suoi canali per external_ref ed esegui DELETE su ciascuno. Rimuovere un numero revoca l'accesso di easyCoexistence presso Meta e interrompe il monitoraggio; rimuovere un canale revoca l'accesso presso la rete e annulla i suoi post ancora in coda. La fatturazione di ciascuno si ferma alla fine del ciclo, mentre le altre connessioni del cliente, come quelle degli altri clienti, restano intatte.

Errori comuni

  • Usare un'email come external_ref. Le email cambiano e il valore è salvato su ogni connessione, quindi usa l'id stabile del tuo database.
  • Verificare gli eventi inoltrati con il segreto del cliente sbagliato. Cerca il segreto tramite account_id nel corpo, perché ogni canale firma con il proprio.
  • Inviare i link di connessione a tutta la base clienti insieme. Solo 50 sessioni possono essere aperte per account, quindi invita i clienti a ondate.
  • Eliminare un cliente solo nel tuo database. Le sue connessioni restano sul tuo account e sulla tua fattura finché ciascuna non viene rimossa tramite API.
Farlo con EasyCoexistence

easyCoexistence permette a una sola chiave API di servire tutta la tua base clienti: i loro numeri WhatsApp, i loro account Instagram, Facebook, TikTok, YouTube e LinkedIn, e altri canali ancora, ciascuno marcato con l'id del tuo cliente, con il proprio token, webhook ed eventi firmati, e ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo che scende man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.

Domande frequenti

Mi serve un account easyCoexistence per ogni cliente?

No. Un solo account e la sua chiave possono contenere le connessioni di molti clienti, distinte tramite external_ref. Account separati servono solo se vuoi fatture separate.

I miei clienti possono vedere gli account degli altri?

Non tramite easyCoexistence. Non possiedono mai la tua chiave e aprono solo i propri link di connessione. Ciò che ogni cliente vede all'interno del tuo prodotto è deciso dal tuo codice.

Posso assegnare a ogni cliente un URL webhook diverso?

Sì. Ogni numero e ogni canale ha una propria destinazione, quindi funziona sia un URL dedicato per cliente sia un URL condiviso instradato tramite account_id.

Come viene fatturato un account multi-tenant?

Per connessione su tutti i tuoi clienti insieme: da US$ 9 a US$ 0,75 per connessione al mese, in base alla fascia del totale, 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