Skracacze URL white-label dla agencji: konfiguracja klienta

Agencja potrzebuje czegoś więcej niż logo na panelu. Potrzebujesz czystego muru między klientami, sposobu, by pracownicy klienta logowali się, nie widząc się nawzajem, DNS-u, który powtórzysz dla dwudziestego klienta, i odpowiedzi na pytanie "kto wystawia fakturę?". Ten przewodnik omawia tę stronę operacyjną.

Ogólne pytanie, co oznacza white-label i jak dostawcy to opisują, znajdziesz w przewodniku o skracaczach URL white-label. Nie powtarzam go tutaj. Wszystko o Elido poniżej sprawdziłem w kodzie 2026-10-24, a gdy czegoś nie ma, mówię to wprost.

Jeden workspace na klienta

Nie umieszczaj klientów we wspólnym workspace. Widzieliby swoje linki i analitykę, a nie mógłbyś przekazać jednemu z nich eksportu bez wcześniejszego czyszczenia. Wzorzec, który działa, to nadrzędny workspace dla Twojego zespołu i jeden workspace na klienta.

W Elido każdy zalogowany użytkownik może utworzyć workspace i zostaje jego właścicielem, więc każdy workspace klienta tworzysz sam. Reseller API zapisuje potem relację. Rejestrujesz konto resellera w nadrzędnym workspace przez POST /v1/workspaces/{id}/reseller (nazwa firmy, e-mail kontaktowy, opcjonalna domena i konfiguracja brandingu). Klienta łączysz przez POST /v1/workspaces/{id}/reseller/workspaces, podając workspace_id klienta i wewnętrzną label, której klient nie widzi. Są też endpointy listowania i usuwania.

Bądź jasny, czym to jest. Połączenie zapisuje skojarzenie. Nie tworzy workspace, nie przenosi rozliczeń ani nie sumuje zużycia. To rejestr tego, które workspace klientów należą do Twojej agencji.

Role dla Twojego zespołu i pracowników klienta

Każdy workspace ma członków z jedną z czterech ról: owner, admin, editor lub viewer. Każda rola odpowiada zestawowi uprawnień, a API egzekwuje uprawnienia per trasa. Branding i zarządzanie resellerem mają własne uprawnienia, więc editor nie zmieni przypadkiem brandingu klienta.

Rozsądny podział:

• Ty i Twój opiekun konta: owner lub admin w każdym workspace klienta.
• Marketerzy klienta budujący linki: editor.
• Interesariusze klienta, którzy tylko czytają raporty: viewer.

Zapraszasz ludzi e-mailem z poziomu workspace, a klucze API są powiązane z workspace i rolą, więc klucz przekazany programiście klienta nie dosięgnie innego klienta. Single sign-on i SCIM istnieją per workspace, co ma znaczenie dla klientów enterprise; zobacz SCIM i SSO.

Wdrażanie jednego klienta

Powtarzaj za każdym razem tę samą sekwencję. Da się ją oskryptować, a ścieżka w panelu jest identyczna.

1. Zarejestruj raz, łącz per klient. Zarejestruj konto resellera, potem utwórz workspace klienta i połącz go:

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. Wskaż domenę klienta. W Ustawieniach dodaj host. Panel zwraca dwa rekordy do panelu DNS klienta:

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

Worker w tle sprawdza DNS co 30 sekund przez maksymalnie 24 godziny, a certyfikat jest wystawiany przy pierwszym żądaniu. Dla wildcardu CNAME to *.example.com, a TXT leży na domenie nadrzędnej. Przewodnik po własnych domenach omawia rekordy CAA i propagację, a dokumentacja wymienia to w sekcji własnych domen, od planu Starter.

3. Nadaj workspace branding. Jedno wywołanie ustawia nazwę, logo, kolor, nazwę nadawcy e-maili i host portalu:

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}'

Oto haczyk, który zaskakuje agencje. Sprawdzenie planu odczytuje plan workspace, któremu nadajesz branding, a nie Twojego nadrzędnego. Workspace klienta w planie Free lub niższym płatnym dostaje 402 Payment Required. Business obowiązuje per workspace klienta.

4. Zaproś klienta. Dodaj jego pracowników jako editorów lub viewerów i zostań właścicielem. E-maile, które dostają, noszą Twoją nazwę marki, kolor, logo i wyświetlaną nazwę nadawcy. Adres nadawczy nadal należy do Elido, o czym powiedziałbym klientom z góry.

Rozliczenia: bądź szczery wobec klientów

Tu odsprzedaż white-label się załamuje, więc dam pełny obraz zamiast odpowiedzi sprzedażowej.

Elido rozlicza per workspace. Reseller API nie tworzy skonsolidowanej faktury, stawki hurtowej ani zestawienia per klient. Kupujesz więc plan każdego workspace klienta albo pozwalasz klientowi subskrybować i fakturujesz własną marżę poza produktem. Jeśli chcesz jednego rachunku obejmującego dwudziestu klientów, produkt jeszcze tego nie potrafi. Wpisałem to do backlogu wdrożeń i wolę, żebyś wiedział teraz, niż odkrył na koniec miesiąca.

Dwie praktyczne konsekwencje. Po pierwsze, wycen swoją usługę jako usługę zarządzaną (konfiguracja, raportowanie, wsparcie), a nie jako odsprzedane stanowisko, bo koszt pozycji dla Ciebie jest widoczny per workspace. Po drugie, wylicz swój koszt per klient ze strony cennika dla planu, którego każdy klient potrzebuje. Branding wymusza Business u każdego klienta, którego chcesz w pełni oznaczyć, i to dominuje w rachunku bardziej niż wolumen kliknięć.

Raportowanie per klient

Analityka jest ograniczona do workspace, więc viewer widzi tylko kliknięcia tego klienta. Przez API klucz powiązany z workspace może odpytywać analitykę tego workspace, a do większych pobrań są asynchroniczne zadania eksportu CSV. To wystarcza na miesięczny raport dla klienta.

Brakuje widoku zbiorczego klientów. Podsumowanie całej agencji oznacza dziś jedno zapytanie na workspace, sklejone we własnym arkuszu lub narzędziu BI. Uwzględnij to, jeśli raportujesz własnemu kierownictwu.

Klienci z UE i przetwarzanie danych

Gdy odsprzedajesz klientom z UE, oni są administratorami, Ty procesorem, a platforma podprocesorem według art. 28 RODO. Twoja umowa z klientem potrzebuje umowy powierzenia (DPA), która obejmuje dane o kliknięciach jako dane osobowe i wymienia Twoich podprocesorów. Listę podprocesorów i warunki DPA bierz ze strony zaufania Elido, a nie z tego bloga, bo się zmieniają. Nie składam tu obietnic dotyczących rezydencji danych. Wpis o RODO ma szczegóły artykuł po artykule, a wpis o rezydencji danych w UE omawia pytania inspektora ochrony danych.

Przenoszenie portfela klientów

Przenoszenie klientów z innego narzędzia ma trzy ścieżki: linki, DNS i komunikację.

Najpierw wyeksportuj linki każdego klienta, ze slugiem, celem, domeną i tagami, i oznacz linki wydrukowane na papierze lub osadzone tam, gdzie nie możesz ich edytować. Zaimportuj przez POST /v1/workspaces/{id}/links/bulk przed ruszeniem DNS i przetestuj kilka przekierowań. Obniż TTL rekordu CNAME do 300 sekund co najmniej 48 godzin wcześniej, przełącz o spokojnej porze i zachowaj stare konto na około dwa tygodnie. Powiadom klientów z tygodniowym wyprzedzeniem.

Historia kliknięć nie migruje między narzędziami, więc wyeksportuj raporty dla każdego klienta, zanim stare konto zostanie zamknięte. Poradnik migracji z Bitly zawiera szczegóły dotyczące Bitly.

Co inne narzędzia pokazują w zakresie rozdzielania klientów

Publiczne strony cenników mówią niewiele o funkcjach dla agencji. Odczytano 2026-10-24:

Źródła: Rebrandly, Short.io, Bitly i Dub, dostęp 2026-10-24. Brak na stronie cennika nie dowodzi braku w produkcie, więc poproś każdego dostawcę, by pokazał w wersji próbnej proces wdrażania klienta.

Powiązane na blogu

• Skracacze URL white-label: co naprawdę obejmuje etykieta
• Skonfiguruj markowe krótkie linki: wybierz domenę, wdróż w jedno popołudnie
• SCIM i SSO w narzędziach marketingowych: o co pyta IT enterprise
• Rezydencja danych w UE dla narzędzi marketingowych: o co pyta Twój DPO
• Migracja z Bitly: poradnik