7 min di letturaAgenzie

Accorciatori URL white-label per agenzie: setup clienti

Come un'agenzia gestisce link brevi white-label per i clienti: workspace, ruoli, DNS, branding, fatturazione e report, e cosa fa oggi l'API reseller di Elido

Ana Kowalska
Marketing solutions engineering

A un'agenzia serve più di un logo su una dashboard. Serve un muro netto tra i clienti, un modo per il personale dei clienti di accedere senza vedersi a vicenda, un DNS ripetibile per il ventesimo cliente e una risposta a "chi manda la fattura?". Questa guida copre quel lato operativo.

La domanda generale su cosa significhi white-label, e su come i vendor lo elencano, sta nella guida agli accorciatori di URL white-label. Non la ripeto qui. Tutto ciò che segue su Elido è stato verificato nel codice il 2026-10-24, e dove qualcosa non esiste lo dico.

Un workspace per cliente

Non mettere i clienti in un workspace condiviso. Vedrebbero i link e le analytics degli altri, e non potresti dare a uno di loro un export senza prima ripulirlo. Il modello che funziona è un workspace padre per il tuo team e un workspace per ogni cliente.

Su Elido, qualsiasi utente con accesso effettuato può creare un workspace e ne diventa owner, quindi crei tu ogni workspace cliente. L'API reseller registra poi la relazione. Registri un account reseller sul tuo workspace padre con POST /v1/workspaces/{id}/reseller (ragione sociale, email di contatto, dominio e configurazione di branding facoltativi). Colleghi un cliente con POST /v1/workspaces/{id}/reseller/workspaces, passando il workspace_id del cliente e un label interno che il cliente non vede mai. Esistono anche endpoint di elenco e rimozione.

Sii chiaro su cosa sia. Il collegamento registra un'associazione. Non crea il workspace, non sposta la fatturazione e non aggrega l'uso. È un registro di quali workspace cliente appartengono alla tua agenzia.

Un workspace padre reseller dell'agenzia che si ramifica in tre workspace cliente isolati, ciascuno con il proprio dominio personalizzato e branding, tutti risolti attraverso l'edge condiviso di Elido

Ruoli per il tuo team e per il personale dei clienti

Ogni workspace ha membri con uno di quattro ruoli: owner, admin, editor o viewer. Ogni ruolo corrisponde a un insieme di permessi, e l'API applica i permessi per ogni route. Branding e gestione reseller hanno permessi propri, quindi un editor non può cambiare per errore il branding di un cliente.

Una ripartizione sensata:

  • Tu e il tuo responsabile account: owner o admin su ogni workspace cliente.
  • I marketer del cliente che costruiscono link: editor.
  • Gli stakeholder del cliente che leggono soltanto i report: viewer.

Inviti le persone via email dal workspace, e le chiavi API sono legate a un workspace e a un ruolo, quindi una chiave che dai allo sviluppatore di un cliente non può raggiungere un altro cliente. Single sign-on e SCIM esistono per workspace, il che conta per i clienti enterprise; vedi SCIM e SSO.

Onboarding di un cliente

Esegui ogni volta la stessa sequenza. È automatizzabile, e il percorso dalla dashboard è identico.

Flusso di setup reseller in cinque passi: abilitare il reseller sul workspace dell'agenzia, collegare un workspace cliente, configurare il DNS del cliente, impostare il branding per workspace, fino al cliente che accede al proprio portale
  1. Registra una volta, collega per cliente. Registra l'account reseller, poi crea il workspace cliente e collegalo:
curl -X POST https://api.elido.app/v1/workspaces/$AGENCY_WS/reseller/workspaces \
  -H "Authorization: Bearer $ELIDO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workspace_id": 99201, "label": "Client: TechCorp EMEA"}'

2. Punta il dominio del cliente. In Impostazioni, aggiungi l'hostname. La dashboard restituisce due record per il pannello DNS del cliente:

_elido-verify.techcorp-emea.example.  TXT    "verify=<token>"
go.techcorp-emea.example.             CNAME  edge.elido.me.

Un worker in background ricontrolla il DNS ogni 30 secondi per un massimo di 24 ore, poi il certificato viene emesso alla prima richiesta. Per un wildcard, il CNAME è *.example.com e il TXT sta sul dominio padre. La guida ai domini personalizzati copre i record CAA e la propagazione, e la documentazione lo elenca sotto domini personalizzati, dal piano Starter.

3. Applica il branding al workspace. Una sola chiamata imposta nome, logo, colore, nome del mittente delle email e hostname del portale:

curl -X PUT https://api.elido.app/v1/workspaces/99201/branding \
  -H "Authorization: Bearer $ELIDO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"brand_name":"TechCorp Links","primary_color":"#0a2463",
       "email_from_name":"TechCorp Links",
       "portal_hostname":"links.techcorp-emea.example","enabled":true}'

Ecco il problema che sorprende le agenzie. Il controllo del piano legge il piano del workspace a cui applichi il branding, non quello del tuo padre. Un workspace cliente in Free o in un livello a pagamento inferiore riceve 402 Payment Required. Business è per workspace cliente.

4. Invita il cliente. Aggiungi il suo personale come editor o viewer e resta tu owner. Le email che ricevono portano il nome del tuo brand, il colore, il logo e il nome visualizzato del mittente. L'indirizzo di invio resta quello di Elido, cosa che direi ai clienti fin dall'inizio.

Fatturazione: sii onesto con i clienti

Qui la rivendita white-label si inceppa, quindi ti do il quadro completo invece di una risposta commerciale.

Elido fattura per workspace. L'API reseller non produce una fattura consolidata, una tariffa all'ingrosso o un estratto per cliente. Quindi acquisti il piano di ogni workspace cliente, oppure lasci che sia il cliente a sottoscriverlo, e fatturi il tuo ricarico fuori dal prodotto. Se vuoi un'unica fattura che copra venti clienti, il prodotto oggi non lo permette. L'ho messo nel backlog di implementazione, e preferisco che tu lo sappia ora piuttosto che scoprirlo a fine mese.

Due conseguenze pratiche. Primo, prezza il tuo servizio come servizio gestito (setup, report, supporto) e non come postazione rivenduta, perché il costo voce per voce per te è visibile per workspace. Secondo, calcola il tuo costo per cliente dalla pagina dei prezzi per il piano di cui ogni cliente ha bisogno. Il branding impone Business su ogni cliente che vuoi completamente brandizzato, e questo pesa sui conti più del volume di click.

Report per cliente

Le analytics sono limitate al workspace, quindi un viewer vede solo i click di quel cliente. Tramite l'API, una chiave legata a un workspace può interrogare le analytics di quel workspace, e ci sono job di esportazione CSV asincroni per estrazioni più grandi. Basta per un report mensile al cliente.

Manca una vista aggregata tra clienti. Un riepilogo di tutta l'agenzia oggi significa una query per workspace, messe insieme nel tuo foglio di calcolo o strumento di BI. Mettilo in conto se fai report alla tua direzione.

Clienti UE e trattamento dei dati

Quando rivendi a clienti UE, loro sono titolari, tu sei responsabile del trattamento e la piattaforma è sub-responsabile ai sensi dell'articolo 28 del GDPR. Il contratto con il cliente richiede un DPA che tratti i dati dei click come dati personali e nomini i tuoi sub-responsabili. Prendi l'elenco dei sub-responsabili e i termini del DPA dalla pagina trust di Elido e non da questo blog, perché cambiano. Qui non faccio promesse sulla residenza dei dati. Il post sul GDPR ha il dettaglio articolo per articolo, e il post sulla residenza dei dati UE copre cosa chiede un DPO.

Trasferire un portafoglio clienti

Spostare i clienti da un altro strumento ha tre binari: link, DNS e comunicazione.

Esporta prima i link di ogni cliente, con slug, destinazione, dominio e tag, e segnala i link stampati su carta o incorporati dove non puoi modificarli. Importa con POST /v1/workspaces/{id}/links/bulk prima di toccare il DNS e verifica alcuni redirect. Abbassa il TTL del CNAME a 300 secondi almeno 48 ore prima, fai il passaggio in un'ora tranquilla e tieni il vecchio account per circa due settimane. Avvisa i clienti con una settimana di anticipo.

Lo storico dei click non migra tra strumenti, quindi esporta i report di ogni cliente prima che il vecchio account si chiuda. Il playbook di migrazione da Bitly ha le specifiche di Bitly.

Cosa mostrano gli altri strumenti sulla separazione dei clienti

Le pagine prezzi pubbliche dicono poco sulle funzionalità per agenzie. Lette il 2026-10-24:

VendorCosa elenca la pagina prezzi per separare i clienti
RebrandlyWorkspace: 1 in Free ed Essentials, 2+ Professional, 5+ Growth
Short.ioEnterprise: gruppi di utenti con accesso a insiemi diversi di domini
BitlyNon verificato nella pagina
DubNon verificato nella pagina
ElidoWorkspace per cliente, ruoli, registro reseller; nessuna fatturazione consolidata

Fonti: Rebrandly, Short.io, Bitly e Dub, consultate il 2026-10-24. L'assenza in una pagina prezzi non prova l'assenza nel prodotto, quindi chiedi a ogni vendor di mostrarti il flusso di onboarding dei clienti in una prova.

Correlati sul blog

Domande frequenti

Come deve separare i clienti un'agenzia in un accorciatore di link?

Dai a ogni cliente il proprio workspace, così link, domini, analytics e membri restano isolati, e tieni il tuo team in un workspace padre. Un unico workspace condiviso significa che i clienti possono vedere i link e i dati degli altri. Su Elido ogni workspace ha i propri membri e ruoli, e l'API reseller collega i workspace dei clienti al tuo account agenzia.

Elido fattura i miei clienti al posto mio?

No. La fatturazione in Elido è per workspace, e l'API reseller collega i workspace ma non produce fatture consolidate né estratti destinati ai clienti. Le agenzie fatturano i propri clienti e usano le analytics per workspace per giustificare i numeri. La fatturazione reseller consolidata è nel nostro backlog di implementazione, quindi chiedi prima di costruirci sopra un modello di rivendita.

Ogni cliente può accedere al proprio hostname?

Sì, nel piano Business. Un workspace può impostare un hostname del portale come links.client.com, e la dashboard risolve quell'host nel workspace del cliente. Il workspace del cliente stesso deve essere in Business, perché l'endpoint di branding controlla il piano del workspace a cui si applica il branding e altrimenti restituisce 402.

Quali ruoli posso dare al personale del cliente?

I ruoli del workspace sono owner, admin, editor e viewer, ciascuno supportato da un insieme di permessi. Un revisore del cliente che ha bisogno solo dei report è un viewer. Un marketer del cliente che crea link è un editor. Invitali dal workspace e resta tu owner così puoi ancora gestire domini e branding.

Come faccio i report dei risultati per cliente?

Le analytics sono limitate al workspace, quindi ogni cliente vede solo i propri click, e puoi ottenere gli stessi numeri tramite l'API con una chiave legata a quel workspace. Non c'è ancora una vista aggregata tra clienti, quindi un report di tutta l'agenzia richiede una query per ogni workspace cliente.

Cosa succede ai link dei clienti se lascio la piattaforma?

I link brevi continuano a funzionare solo finché il DNS del dominio punta alla piattaforma. Prima di spostarti, esporta i link, abbassa il TTL del CNAME, importa nel nuovo strumento, poi trasferisci il DNS. Lo storico dei click non si sposta tra strumenti, quindi esporta prima i report per i tuoi clienti e tieni aperto il vecchio account durante la sovrapposizione.

Prova Elido

Incolla un URL, ottieni un link breve

Senza registrazione. Il link vive 30 giorni. Iscriviti per conservarlo.

Senza registrazione. Crea un account gratuito per 50 link al mese.

Prova Elido

Accorciatore di URL ospitato nell'UE: domini personalizzati, analisi approfondite e API aperta. Piano gratuito - senza carta di credito.

Tag
white label url shortener
agency url shortener
reseller url shortener
client workspaces
white label link management
agency link reporting

Continua a leggere