Dokumentacija za programere

n8n čvor

Objavljuj na Instagramu, TikToku, YouTube-u, X-u, Facebooku, LinkedInu i Bluesky-ju iz bilo kog n8n workflow-a.

n8n-nodes-chat33
npm

1. Instalacija

U svojoj n8n instanci idi na Settings → Community Nodes → Install i unesi naziv paketa:

naziv paketa
n8n-nodes-chat33

Traži n8n sa uključenim community čvorovima (self-hosted ili n8n Cloud sa verifikovanim community čvorovima).

2. Napravi kredencijal

  1. U Chat33 otvori Podešavanja → API ključevi i napravi ključ (podrazumevani scope-ovi su dovoljni: accounts:read, posts:read, posts:write, media:write).
  2. U n8n-u dodaj kredencijal Chat33 API: ostavi Base URL na https://chat33.io i nalepi API ključ.
  3. Klikni Test. Ključ se proverava pozivom GET /api/v1/accounts.

3. Resursi i operacije

ResursOperacijeNapomene
AccountGet ManyIzlistava tvoje povezane kanale, a puni i padajuće liste naloga
PostCreate, Validate, Get, Get Many, Delete, Duplicate, Get LogsCreate i Validate biraju naloge iz padajuće liste uživo. Validate je probni rad (ništa se ne objavljuje)
MediaUploadBinarni fajl iz workflow-a (do 500MB) ili preuzimanje sa javnog URL-a (video do 4GB za TikTok; YouTube 2GB, X 512MB, Instagram/Facebook 1GB, LinkedIn 200MB, Bluesky 300MB)

Configure Platform Settings (čvor 0.2.0+): padajuća lista naloga čuva ID-jeve kanala, pa čvor ne zna koje su platforme izabrane. Označi ih ovde i pojaviće se samo te kolekcije. Svaka platforma prima i Caption, koji zamenjuje zajednički tekst samo za tu mrežu, pa jedan čvor može da pošalje drugačiju poruku na svaku.

YouTube Settings: označi YouTube na svakoj YouTube objavi. Made for Kids je obavezno po pravilima YouTube-a i FTC-a i objava se bez njega odbija. Privatnost je podrazumevano public, pa je podesi ako želiš unlisted ili private. Tu su i naslov, opis, tagovi, kategorija i obaveštenje pretplatnicima. Zakazane objave ignorišu izbor privatnosti: otpremaju se kao private, a YouTube ih menja u zakazano vreme.

TikTok Settings: ako TikTok ne označiš, video završava u nacrtima naloga umesto da se objavi. Za objavljivanje postavi Publish Mode na Direct Post, što traži i nivo privatnosti. Opcije koje ne postaviš ostaju nepromenjene, pa komentari, dueti i stitch ostaju uključeni dok ih ne isključiš. Komercijalna oznaka i oznaka za AI sadržaj se automatski mapiraju na polja za usklađenost u TikTok Content Posting API-ju.

Instagram Settings: First Comment se objavljuje odmah posle objave. Tu obično idu hešteg oznake, da ostanu van opisa.

X Settings: Post as Thread deli tekst po separatoru i nadovezuje svaki deo kao odgovor. Tu su i dozvole za odgovore.

LinkedIn Settings: vidljivost (svi na LinkedInu ili samo veze), URL članka koji se deli kao link kartica i naslov i opis medija. Objave idu na lični profil člana. Company Pages još nisu podržane.

Svaka opcija koju API prima sada ima svoje tipizirano polje, pa Additional Options → Platform Config (JSON) treba samo za ono što je dodato u API posle čvora. Šema je u OpenAPI pregledu.

4. Primer: objava videa iz webhooka

Tri čvora: Webhook → Chat33 (Media Upload) → Chat33 (Post Create).

  1. Webhook: metod POST, prima JSON { "videoUrl": "...", "caption": "..." }.
  2. Chat33 → Media → Upload: Input Type URL, File URL ={{ $json.body.videoUrl }}. Vraća URL hostovanog medija.
  3. Chat33 → Post → Create: izaberi naloge iz padajuće liste, Text ={{ $('Webhook').item.json.body.caption }}, Media URLs ={{ $json.url }}, Additional Options → Media Type video, plus TikTok/YouTube podešavanja po potrebi.

Pokreni ga:

bash
curl -X POST https://your-n8n.example.com/webhook/my-path \
  -H "Content-Type: application/json" \
  -d '{"videoUrl": "https://example.com/video.mp4", "caption": "Hello from n8n 🚀"}'

Odgovor sadrži napravljene objave sa statusom QUEUED. Chat33 objavljuje u roku od jednog minuta. Dodaj čvor Post → Get ili postavi callbackUrl da pratiš konačni status.

Ograničenja medija

  • Video: do 4GB preko URL-a za TikTok (mp4, mov, webm). Ostale platforme imaju niže ograničenje pri objavljivanju: YouTube 2GB, X 512MB, Instagram/Facebook 1GB, LinkedIn 200MB, Bluesky 300MB
  • Fajlovi preko 500MB namenjeni TikToku automatski se šalju u delovima, bez URL-a i domena, samo se objavljuju sporije.
  • Slike: do 20MB (jpeg, png, webp, gif). Instagram/Facebook do 8MB, LinkedIn do 10MB, X do 5MB, Bluesky do 2MB
  • Binarno otpremanje iz samog workflow-a: do 500MB (čvor 0.1.2+, koji otprema direktno u skladište, a ne preko API-ja). Za veće fajlove postavi fajl na bilo koju javnu adresu (https) i koristi URL režim.
  • Zakazane objave čuvaju kopiju. Kad zakažeš objavu čiji su mediji na tvom hostu, Chat33 kopira fajl u svoje skladište ubrzo pošto se objava napravi, pa se objava zakazana nedeljama unapred objavljuje i ako tvoj originalni link istekne ili se fajl obriše. Neposredne objave to preskaču: objavljuju se za oko dva minuta, pa se link preuzima dok je sigurno još tu.

Rešavanje problema

Insufficient scope: ponovo napravi API ključ sa podrazumevanim scope-ovima ili dodaj scope koji nedostaje u Podešavanja → API ključevi.

TikTok DIRECT_POST requires a privacy level: dodaj TikTok Settings na čvor Post Create i izaberi nivo privatnosti koji nalog dozvoljava.

File too large: pogledaj ograničenja medija iznad; kompresuj video ili koristi URL režim.

npm paket API referencaAI dokumentacija