Nodo n8n

Pubblica su Instagram, TikTok, YouTube, X, Facebook, LinkedIn e Bluesky da qualsiasi workflow n8n.

n8n-nodes-chat33
npm

1. Installa

Nella tua istanza n8n vai in Settings → Community Nodes → Install e inserisci il nome del pacchetto:

nome del pacchetto
n8n-nodes-chat33

Richiede n8n con i nodi della community attivi (self-hosted o n8n Cloud con nodi della community verificati).

2. Crea la credenziale

  1. In Chat33 apri Impostazioni → Chiavi API e crea una chiave (bastano i permessi predefiniti: accounts:read, posts:read, posts:write, media:write).
  2. In n8n aggiungi una credenziale Chat33 API: lascia Base URL su https://chat33.io e incolla la chiave API.
  3. Clicca Test. Verifica la chiave con GET /api/v1/accounts.

3. Risorse e operazioni

RisorsaOperazioniNote
AccountGet ManyElenca i tuoi canali collegati; alimenta anche i menu a tendina degli account
PostCreate, Validate, Get, Get Many, Delete, Duplicate, Get LogsCreate/Validate scelgono gli account da un menu a tendina in tempo reale; Validate è una prova a vuoto (non viene pubblicato nulla)
MediaUploadFile binario dal workflow (fino a 500 MB) oppure importazione da URL pubblico (video fino a 4 GB per TikTok; YouTube 2 GB, X 512 MB, Instagram/Facebook 1 GB, LinkedIn 200 MB, Bluesky 300 MB)

Configure Platform Settings (nodo 0.2.0+): il menu a tendina degli account salva gli ID dei canali, quindi il nodo non sa quali piattaforme hai scelto. Spuntale qui e compaiono solo quelle raccolte. Ogni piattaforma accetta anche una Caption che sostituisce il testo condiviso solo per quel social, così un solo nodo può inviare un messaggio diverso a ciascuno.

YouTube Settings: spunta YouTube su ogni post YouTube. Made for Kids è imposto da YouTube/FTC e senza di esso il post viene rifiutato. La privacy è public per impostazione predefinita, quindi impostala se vuoi non in elenco o privato. Contiene anche titolo, descrizione, tag, categoria e notifica agli iscritti. I post programmati ignorano la scelta sulla privacy: vengono caricati come privati e YouTube li pubblica all’orario programmato.

TikTok Settings: se lasci TikTok non spuntato, il video finisce nelle bozze dell’account invece di essere pubblicato. Imposta Publish Mode su Direct Post per pubblicare, il che richiede anche un livello di privacy. Le opzioni che non imposti restano come sono, quindi commenti, duetti e stitch restano attivi a meno che tu non li disattivi. La dichiarazione commerciale e l’etichetta per i contenuti generati con IA corrispondono per te ai campi di conformità della Content Posting API di TikTok.

Instagram Settings: First Comment viene pubblicato subito dopo il post, ed è dove di solito vanno gli hashtag per tenerli fuori dalla didascalia.

X Settings: Post as Thread divide il testo in base a un separatore e concatena ogni parte come risposta, più i permessi di risposta.

LinkedIn Settings: visibilità (chiunque su LinkedIn o solo collegamenti), un URL di articolo da condividere come anteprima di link e titolo/descrizione del contenuto multimediale. I post vanno sul profilo personale del membro. Le Pagine aziendali non sono ancora supportate.

Ogni opzione accettata dall’API ora ha un campo tipizzato, quindi Additional Options → Platform Config (JSON) serve solo per ciò che è stato aggiunto all’API dopo il nodo; lo schema è nell’esploratore OpenAPI.

4. Esempio: pubblica un video da un webhook

Tre nodi: Webhook → Chat33 (Media Upload) → Chat33 (Post Create).

  1. Webhook: metodo POST, riceve il JSON { "videoUrl": "...", "caption": "..." }.
  2. Chat33 → Media → Upload: Input Type URL, File URL ={{ $json.body.videoUrl }}. Restituisce l’URL di un contenuto ospitato.
  3. Chat33 → Post → Create: scegli gli account dal menu a tendina, Text ={{ $('Webhook').item.json.body.caption }}, Media URLs ={{ $json.url }}, Additional Options → Media Type video, più le impostazioni di TikTok/YouTube se servono.

Avvialo:

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

La risposta contiene i post creati con stato QUEUED. Chat33 pubblica entro un minuto. Aggiungi un nodo Post → Get oppure imposta un callbackUrl per seguire lo stato finale.

Limiti dei contenuti multimediali

  • Video: fino a 4 GB con importazione da URL per TikTok (mp4, mov, webm); le altre piattaforme hanno limiti più bassi al momento della pubblicazione: YouTube 2 GB, X 512 MB, Instagram/Facebook 1 GB, LinkedIn 200 MB, Bluesky 300 MB
  • I file sopra i 500 MB destinati a TikTok vengono caricati in automatico a blocchi, senza passare da URL o domini, con una pubblicazione solo più lenta.
  • Immagini: fino a 20 MB (jpeg, png, webp, gif). Instagram/Facebook arrivano a 8 MB, LinkedIn a 10 MB, X a 5 MB, Bluesky a 2 MB
  • Caricamenti binari dal workflow stesso: fino a 500 MB (nodo 0.1.2+, che carica direttamente nello storage invece che tramite l’API). Oltre, ospita il file in un posto pubblico (https) e usa la modalità URL.
  • I post programmati ne conservano una copia. Quando programmi un post con contenuti sul tuo host, Chat33 copia il file nel proprio storage poco dopo la creazione del post, così un post programmato con settimane di anticipo viene pubblicato anche se il link originale scade o il file viene eliminato. I post immediati saltano questo passaggio: escono entro circa due minuti, quindi il link viene letto quando di sicuro esiste ancora.

Risoluzione dei problemi

Insufficient scope: ricrea la chiave API con i permessi predefiniti, oppure aggiungi il permesso mancante in Impostazioni → Chiavi API.

TikTok DIRECT_POST requires a privacy level: aggiungi TikTok Settings al nodo Post Create e scegli un livello di privacy consentito dall’account.

File too large: vedi i limiti qui sopra; comprimi il video oppure usa la modalità URL.

pacchetto npm Riferimento APIDocumentazione per AI