# Generowanie obrazków w Zapierze przez Webhooks by Zapier: przepis

> Obrazki w Zapie przez Webhooks by Zapier: konfiguracja Custom Request, mapowanie pól, wysyłka adresu obrazka do Dysku Google lub Slacka i limity planów.

Opublikowano 2026-11-06 · https://shareglint.com/pl/integrations/zapier

Żeby generować obrazki w Zapierze, dodaj krok **Webhooks by Zapier** ze zdarzeniem **Custom Request**: metoda `POST`, adres `https://shareglint.com/v1/images?wait=true`, nagłówek `Authorization: Bearer` z twoim kluczem API i treść w JSON-ie z szablonem oraz wartościami zmapowanymi z wyzwalacza. Wynik tego kroku zawiera publiczny adres `url` gotowego obrazka, którego każdy kolejny krok może użyć jako pliku. W katalogu aplikacji Zapiera nie ma aplikacji Shareglint; ten jeden krok to cała integracja.

## Czego potrzebujesz po stronie Zapiera

Webhooks by Zapier to **aplikacja premium**: centrum pomocy Zapiera podaje ją dla planów Professional, Team i Enterprise, a nie dla Free ([Pomoc Zapiera](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zaps), aktualizacja z 10 sierpnia 2026). Alternatywy w planie Free nie wypadają lepiej:

- **API by Zapier** (beta) też jest aplikacją premium, dostępną tylko w planach płatnych; jej przewaga polega na tym, że klucz API nie leży w zwykłych polach kroku ([Pomoc Zapiera](https://help.zapier.com/hc/en-us/articles/44391650357005-Send-API-requests-in-Zap-workflows)).
- **Code by Zapier** działa w planie Free, ale z czasem wykonania **1 sekundy** (30 sekund w planach Professional i Team) — za mało, żeby poczekać na render ([Code by Zapier](https://help.zapier.com/hc/en-us/articles/45405528551181-Using-Code-by-Zapier)).

Po stronie Shareglint utwórz w panelu osobny klucz API dla Zapiera, żeby móc go unieważnić bez ruszania innych integracji.

## Przepis: obrazek dla każdego nowego wiersza (albo wpisu, albo zamówienia)

**Wyzwalacz** → **Webhooks by Zapier: Custom Request** → miejsce, do którego trafia obrazek.

Wyzwalaczem może być cokolwiek, co ma potrzebny tekst: nowy wiersz w Arkuszach Google, nowy wpis w WordPressie, nowy produkt w Shopify, nowe zgłoszenie z formularza. Skonfiguruj krok webhooka:

- **Event:** Custom Request. (Zwykłe zdarzenie POST buduje treść z par klucz–wartość; API oczekuje zagnieżdżonego obiektu `modifications`, który Custom Request wysyła dokładnie tak, jak go wpiszesz. Zapier też odsyła do Custom Request przy zagnieżdżonym JSON-ie).
- **Method:** `POST`
- **URL:** `https://shareglint.com/v1/images?wait=true`
- **Data** (surowy JSON; w miejsca wartości wstaw pola z wyzwalacza):

```json
{
  "template": "blog-og",
  "format": "jpeg",
  "modifications": {
    "title": "{{Title from the trigger}}",
    "author": "{{Author from the trigger}}",
    "site": "northwind.dev"
  }
}
```

- **Headers:** `Authorization` → `Bearer sk_live_…` oraz `Content-Type` → `application/json`.

Kliknij **Test step**. Odpowiedź wraca już rozłożona na pola, takie jak `id`, `status` i `url`. Ten `url` to właśnie obrazek.

Jedno ostrzeżenie przy surowym JSON-ie: Zapier wstawia zmapowane wartości bez zmian, więc tytuł z cudzysłowem prostym (`"`) psuje JSON. Jeśli twoje dane mogą zawierać cudzysłowy, dodaj przed webhookiem krok **Formatter** (Text → Replace, zamiana `"` na `\"`) albo użyj API by Zapier, które zbuduje treść za ciebie.

## Obrazek w następnym kroku

Pola plików w Zapierze przyjmują „a URL link that supports files” (link URL obsługujący pliki), o ile jest publicznie dostępny i prowadzi do bezpośredniego pobrania, a nie do strony podglądu ([Pomoc Zapiera: pliki](https://help.zapier.com/hc/en-us/articles/8496288813453-Send-files-in-Zap-workflows)). Adres renderu spełnia oba warunki, więc mapuj `url` wprost do:

- **Google Drive → Upload File:** File = `url`; obrazek ląduje w folderze.
- **Slack → Send Channel Message:** wstaw `url` do wiadomości albo do pola pliku, żeby go wgrać.
- **Google Sheets → Update Row:** zapisz `url` w kolumnie, a `=IMAGE(…)` w tej komórce pokaże obrazek w arkuszu.
- **WordPress, Webflow, inny CMS:** ustaw `url` jako obrazek wyróżniający wpisu albo pole `og:image`.
- **Kroki social media**, które przyjmują adres obrazka: przekaż `url` jako obrazek posta.

Jeśli potrzebujesz kilku rozmiarów tego samego obrazka, dodaj do treści `"sizes": ["og", "square", "story"]`. Odpowiedź ma wtedy listę `renders` z jednym `url` na rozmiar, w kolejności, w jakiej podałeś rozmiary, więc kolejne kroki mogą wybrać każdy z nich według pozycji.

## Wiele wierszy naraz

Zap uruchamia się raz na każdy element z wyzwalacza, co pasuje do nowych wierszy i nowych wpisów. Przy starszym katalogu — 500 produktów, wpisy z zeszłego roku — jedno wywołanie hurtowe jest prostsze niż 500 uruchomień Zapa: wyślij wiersze do `POST /v1/batches` (wystarczy `csv_url` opublikowanego arkusza) i odbierz jeden plik ZIP. Limit wierszy na zlecenie według planu: Free 50, Starter 500, Pro 1 000, Scale 2 000, Business 5 000. Szczegóły opisuje [poradnik o CSV i Arkuszach Google](https://shareglint.com/en/guides/bulk-og-images-from-csv-google-sheets) (po angielsku).

## Gdy coś pójdzie nie tak

- **402 `quota_exceeded`:** renderów na ten miesiąc już nie ma; nic nie zostaje naliczone. Zapier pokazuje krok jako zakończony błędem. Podnieś plan albo dokup paczkę 1 000 obrazków za $8.
- **422:** nieprawidłowe zapytanie — na przykład nieznany szablon, rozmiar albo format; treść odpowiedzi mówi, co jest nie tak.
- **503 `sync_overloaded`:** obrazek nie był gotowy w czasie oczekiwania. Odpowiedź i tak zawiera `id` renderu; późniejszy krok `GET /v1/images/{id}` (Custom Request z metodą `GET`) go zwróci, a nic nie wyrenderuje się dwa razy. Zapier nie publikuje limitu czasu dla kroków webhooka, więc przy animowanych GIF-ach i MP4, które renderują się dłużej, zamiast `?wait=true` użyj webhooka (`webhook_url`) kierującego do Zapa z wyzwalaczem „Catch Hook”.

Ponowione albo odtworzone uruchomienia Zapa są bezpieczne: ten sam szablon z tymi samymi wartościami zwraca istniejący obrazek bez zużywania limitu.

## Koszt

Jeden render na obrazek i rozmiar; powtórki są darmowe. 100 renderów miesięcznie w planie Free ma znak wodny; Starter kosztuje $9 miesięcznie za 2 000 renderów ([cennik](https://shareglint.com/pl/pricing)). Zapier rozlicza swoje zadania (tasks) osobno.

## Czego nie robi

- Nie ma natywnej aplikacji w Zapierze ani wyzwalaczy czy wyszukiwań; wszystko idzie przez krok webhooka.
- Nie działa w darmowym planie Zapiera, bo potrzebne kroki HTTP są aplikacjami premium.
- Nie przechowuje twoich danych z Zapiera: każde zapytanie niesie wartości, a zostaje tylko wyrenderowany obrazek, przez okres przechowywania przewidziany w twoim planie.

## FAQ

### Czy Shareglint ma swoją aplikację w Zapierze?

Nie. Zap wywołuje API przez Webhooks by Zapier (albo API by Zapier), czyli ogólne kroki HTTP Zapiera. Cała integracja to jeden krok Custom Request z adresem URL, nagłówkiem Authorization i treścią w JSON-ie.

### Czy to działa w darmowym planie Zapiera?

Nie. Zapier zalicza Webhooks by Zapier i API by Zapier do aplikacji premium, dostępnych w planach płatnych, a Code by Zapier w planie Free przerywa działanie po 1 sekundzie — to za krótko, żeby doczekać się renderu. Potrzebny jest płatny plan Zapiera.

### Jak przenieść obrazek do Dysku Google albo Slacka?

Zmapuj pole url z kroku webhooka do pola File w następnej aplikacji. Zapier przyjmuje tam publiczny adres do bezpośredniego pobrania pliku, a adres renderu jest właśnie taki.

### Co, jeśli Zap uruchomi się dwa razy dla tego samego elementu?

Ten sam szablon z tymi samymi wartościami zwraca za darmo istniejący obrazek, więc powtórzone albo zdublowane uruchomienie Zapa nie zużywa dodatkowego limitu.