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

Ż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, 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).
• 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).

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):

{
  "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). 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 (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). 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.