Postavljanje veze za objavljivanje putem webhooka

O čemu se radi?

S vezom kanala Webhook ALLMEDIA.AI svaku objavu predaje bilo kojem vanjskom sustavu. To može biti tvoja vlastita usluga ili tijek rada u alatu za automatizaciju kao što su n8n ili Make. Pri objavljivanju ALLMEDIA.AI šalje JSON payload putem HTTPS-a na adresu tvoje usluge. Tvoja usluga objavljuje objavu na ciljnoj platformi i javlja rezultat natrag.

Payload je jednak za sve ciljne sustave. Potpunu tehničku referencu nalaziš u dokumentaciji za razvojne programere: Publishing API.

Preduvjeti

• Usluga s javno dostupnom HTTPS adresom. Interne adrese, IP adrese i privatne mreže su blokirane.
• Slobodno mjesto za vezu kanala u tvojem planu. Webhook veza broji se kao svaka druga veza kanala (Free 1, Pro 6, Agentic 15).
• Osnovno znanje o tvojem alatu za automatizaciju ili o razvoju web-usluga.

Korak po korak

1. Pripremi primatelja. U svojoj usluzi izradi krajnju točku (endpoint) koja prima POST zahtjeve s JSON-om, na primjer webhook okidač u n8n-u ili Custom Webhook u Makeu. Zabilježi HTTPS adresu.
2. Izradi webhook vezu. U ALLMEDIA.AI otvori Plan → Publishing i klikni Connect channel. U dijalogu „Select connector type“ odaberi vrstu Webhook i zadaj naziv.
3. Unesi adresu. Pod Webhook Endpoint unesi adresu svoje usluge.
4. Dodaj API ključ. Otvori Expert Settings (stručne postavke). Pod API Key Authentication odaberi postojeći API ključ ili klikni Create API Key. ALLMEDIA.AI ključ šalje pri svakom pozivu u zaglavlju x-allmedia-api-key. Bez API ključa tvoja krajnja točka nije zaštićena. To se ne preporučuje.
5. Odredi opcije. Pod Custom Headers dodaješ daljnja zaglavlja, primjerice vlastiti token svojeg sustava. Po želji uključi Include SEO fields, FAQ markup ili unesi Health check address.
6. Testiraj vezu. Klikni Test connection. ALLMEDIA.AI šalje testni payload s "debugMode": true. Tvoja usluga od njega nikada ne smije napraviti pravu objavu. Pomoću Copy cURL isti poziv možeš i sam ponoviti.
7. Dodijeli kanalu. Spremi vezu. Zatim otvori kanal pod Content → Channels, na platnu kanala prijeđi na Workflow i u pločici Veröffentlichung (objavljivanje) odaberi webhook vezu. Tek tada preko nje možeš objavljivati.

Što tvoja usluga mora učiniti

• Provjeri API ključ: Usporedi zaglavlje x-allmedia-api-key sa svojim ključem i zahtjeve bez valjanog ključa odbij s HTTP 401.
• Odgovori odmah: Primitak potvrdi unutar nekoliko sekundi s HTTP 200, a zatim objavi. ALLMEDIA.AI prekida zahtjev nakon kratkog vremena. Ako tvoja krajnja točka ne odgovori statusom 2xx, objava se odmah postavlja na „Failed“.
• Zanemari testne i kontrolne pozive: Zahtjevi s debugMode: true ili healthCheck: true nikada ne smiju stvoriti objavu.
• Izbjegavaj dvostruke objave: Koristi postId kao jedinstveni ključ. Ponovno slanje iste objave ne smije stvoriti drugu objavu.
• Javi rezultat: Nakon objavljivanja (ili kod konačne pogreške) pošalji POST na callbackUrl iz payloada. Za autentifikaciju koristiš zaglavlje x-callback-secret s vrijednošću iz callbackSecret ili svoj API ključ s x-allmedia-api-key i x-allmedia-tenant-id. Tek taj callback postavlja objavu na „Published“ ili „Failed“.

Važna polja u payloadu su postId, title, content (čisti tekst kod društvenih kanala, HTML kod blogovskih i uredničkih kanala), attachmentsV2 s medijima, mode (immediate, scheduled ili draft), channelId i callbackUrl.

Ograničenja i ponašanje

• Nema automatskog ponavljanja: Neuspjeli pokušaj bilježi se u objavi. Objavljivanje možeš ponovno pokrenuti u aplikaciji.
• Mediji: Po objavi šalje se do 20 slika i 10 videozapisa kao javno dostupni URL-ovi.
• Provjera stanja: Samo ako uneseš adresu za provjeru stanja (health check), ALLMEDIA.AI je provjerava svakih 6 sati. Sama webhook adresa nikada se ne poziva automatski. Nakon dva neuspjela pokušaja dobivaš poruku u zvonu i e-poštom.

Drugi smjer: REST API i MCP

Webhook veza šalje objave iz ALLMEDIA.AI prema van. Ako želiš izvana stvarati objave, dohvaćati kanale ili ALLMEDIA.AI povezati s AI asistentima kao što je Claude, koristiš REST API ili MCP poslužitelj.

• API ključ za to izrađuješ preko izbornika profila pod My Profile → Developer. Ako još nemaš vlastiti ključ, klikneš Create additional key. Istodobno može biti aktivan samo jedan ručni API ključ.
• Ključ se potpuno prikazuje samo jednom. Odmah ga kopiraj.
• Detalji: Izradi API ključeve i upravljaj njima i API Quick Start: REST API i MCP poslužitelj.

Česta pitanja

Mogu li s n8n-om ili Makeom objavljivati na platformama koje ALLMEDIA.AI ne povezuje izravno?

Da. Tvoj tijek rada prima objavu putem webhook veze i objavljuje je na ciljnoj platformi pomoću modula tvojeg alata. Važno je da tijek rada odmah odgovori s HTTP 200 i na kraju pošalje callback.

Gdje nalazim postavke „Publishing Connections“ ili „API Keys“?

Ti nazivi ne postoje u aplikaciji. Veze za objavljivanje su veze kanala pod Plan → Publishing. API ključeve nalaziš pod My Profile → Developer.

Povezani članci

• Razumijevanje veza kanala
• Izradi API ključeve i upravljaj njima
• API Quick Start: REST API i MCP poslužitelj
• Što se može objaviti na pojedinom kanalu