Wtyczka Chrome

Dodaj firmę odczytaną ze strony (wtyczka)

Tworzy lead z danych, które użytkownik zobaczył i poprawił w popupie wtyczki. Zapis idzie tą samą ścieżką co aplikacja: dedupe (domena, NIP, e-mail, telefon, nazwa i miasto), atomowe naliczenie limitu leadów i przypisanie do klienta agencji (workspace_id). Pochodzenie danych trafia do rejestru art. 14 RODO: źródło manual, szczegół wtyczka_chrome (albo wtyczka_chrome:google_maps), adres strony i czas zapisu. Adres źródła sprawdzamy tą samą polityką co wtyczka: LinkedIn i serwisy zabraniające scrapingu są odrzucane (422). Przy poprawnym NIP uzupełniamy puste pola z rejestru (CEIDG dla jednoosobowych działalności, KRS dla spółek; wspólny budżet zapytań, najwyżej kilka sekund): REGON, PKD, województwo, adres, miasto i status firmy; nigdy nie nadpisujemy tego, co podał użytkownik, i nie przenosimy danych osobowych właściciela. Duplikat zwraca 409 duplicate_lead z existing_lead_id.

Wymagany zakres klucza: extension:write.

post/leads/capture

Request

  • Base URL: https://outreachpilot.pl/api/v1
  • URL: https://outreachpilot.pl/api/v1/leads/capture
  • Auth: HTTP bearer

Request body

kind'website' | 'google_maps' required

website = strona firmowa, google_maps = wizytówka miejsca w Mapach Google.

source_urlstring required

Adres strony, z której odczytano dane (zapisujemy go w rejestrze pochodzenia danych, art. 14 RODO). Musi być adresem dozwolonym przez politykę wtyczki: nigdy LinkedIn ani serwisy zabraniające scrapingu.

captured_atstring date-time

Chwila odczytu strony przez wtyczkę (ISO 8601). Zapisujemy ją przy leadzie, gdy mieści się w ostatniej dobie.

company_namestring

Nazwa firmy.

emailstring

Adres e-mail (unikalny w Twojej bazie).

phonestring

Telefon.

websitestring

Strona WWW firmy (adres lub sama domena).

nipstring

NIP. Sprawdzamy sumę kontrolną; przy poprawnym NIP uzupełniamy puste pola z rejestru (CEIDG, KRS).

regonstring

REGON (9 lub 14 cyfr, z sumą kontrolną).

krsstring

Numer KRS (10 cyfr), jeśli strona go podaje.

addressstring

Adres.

citystring

Miasto.

industrystring

Branża lub kategoria (w Mapach Google: kategoria wizytówki).

ratingnumber

Ocena z Map Google (tylko google_maps).

reviewsinteger

Liczba opinii z Map Google.

facebook_urlstring

Profil firmy na Facebooku (sam adres).

instagram_urlstring

Profil firmy na Instagramie (sam adres).

linkedin_company_urlstring

Strona firmy na LinkedIn (linkedin.com/company/...). Zapisujemy sam adres: nigdy go nie otwieramy ani nie pobieramy. Adresy profili osób odrzucamy.

tagsstring[]

Tagi (maks. 20).

workspace_idstring

Klient agencji, do ktorego trafia zapis (ID z GET /workspaces, klient musi byc aktywny). Bez pola: "Moja firma".

Response

Utworzono.

Changes

No recorded changes to this operation across all 1 revision of this API.