Nastavenie pripojenia na publikovanie cez webhook

O čo ide?

S pripojením kanála Webhook odovzdá ALLMEDIA.AI každý príspevok ľubovoľnému externému systému. Môže to byť vlastná služba alebo workflow v nástroji na automatizáciu, ako sú n8n alebo Make. Pri publikovaní ALLMEDIA.AI pošle JSON payload cez HTTPS na adresu tvojej služby. Tvoja služba príspevok publikuje na cieľovej platforme a nahlási výsledok späť.

Payload je rovnaký pre všetky cieľové systémy. Úplnú technickú referenciu nájdeš v dokumentácii pre vývojárov: Publishing API.

Predpoklady

• Služba s verejne dostupnou HTTPS adresou. Interné adresy, IP adresy a súkromné siete sú blokované.
• Voľné miesto na pripojenie kanála v tvojom pláne. Webhookové pripojenie sa počíta ako každé iné pripojenie kanála (Free 1, Pro 6, Agentic 15).
• Základné znalosti tvojho nástroja na automatizáciu alebo vývoja webových služieb.

Krok za krokom

1. Priprav príjemcu. Vo svojej službe založ koncový bod (endpoint), ktorý prijíma požiadavky POST s JSON, napríklad webhookový spúšťač v n8n alebo Custom Webhook v Make. Poznač si HTTPS adresu.
2. Založ webhookové pripojenie. V ALLMEDIA.AI otvor Plan → Publishing a klikni na Connect channel. V dialógu „Select connector type“ zvoľ typ Webhook a zadaj názov.
3. Zadaj adresu. Do poľa Webhook Endpoint zadaj adresu svojej služby.
4. Ulož API kľúč. Otvor Expert Settings (expertné nastavenia). V časti API Key Authentication zvoľ existujúci API kľúč alebo klikni na Create API Key. ALLMEDIA.AI posiela kľúč pri každom volaní v hlavičke x-allmedia-api-key. Bez API kľúča nie je tvoj koncový bod chránený. To sa neodporúča.
5. Nastav možnosti. V časti Custom Headers doplníš ďalšie hlavičky, napríklad vlastný token svojho systému. Voliteľne zapneš Include SEO fields, FAQ markup alebo zadáš Health check address.
6. Otestuj pripojenie. Klikni na Test connection. ALLMEDIA.AI pošle testovací payload s "debugMode": true. Tvoja služba z neho nikdy nesmie vytvoriť skutočný príspevok. Pomocou Copy cURL môžeš to isté volanie zopakovať aj sám.
7. Priraď ku kanálu. Ulož pripojenie. Potom otvor kanál v Content → Channels, na plátne kanála prepni na Workflow a v dlaždici Veröffentlichung (publikovanie) zvoľ webhookové pripojenie. Až potom cez neho môžeš publikovať.

Čo musí tvoja služba robiť

• Overiť API kľúč: Porovnaj hlavičku x-allmedia-api-key so svojím kľúčom a požiadavky bez platného kľúča odmietni s HTTP 401.
• Odpovedať okamžite: Prijatie potvrď do niekoľkých sekúnd s HTTP 200 a až potom publikuj. ALLMEDIA.AI požiadavku po krátkom čase preruší. Ak tvoj koncový bod neodpovie stavom 2xx, príspevok sa okamžite nastaví na „Failed“.
• Ignorovať testovacie a kontrolné volania: Požiadavky s debugMode: true alebo healthCheck: true nikdy nesmú vytvoriť príspevok.
• Zabrániť duplicitným príspevkom: Použi postId ako jedinečný kľúč. Opätovné odoslanie toho istého príspevku nesmie vytvoriť druhý príspevok.
• Nahlásiť výsledok: Po publikovaní (alebo pri definitívnej chybe) pošli POST na callbackUrl z payloadu. Na autentifikáciu použiješ hlavičku x-callback-secret s hodnotou z callbackSecret alebo svoj API kľúč s x-allmedia-api-key a x-allmedia-tenant-id. Až tento callback nastaví príspevok na „Published“ alebo „Failed“.

Dôležité polia v payloade sú postId, title, content (čistý text pri sociálnych kanáloch, HTML pri blogových a redakčných kanáloch), attachmentsV2 s médiami, mode (immediate, scheduled alebo draft), channelId a callbackUrl.

Obmedzenia a správanie

• Žiadne automatické opakovanie: Neúspešný pokus sa zaznamená v príspevku. Publikovanie môžeš v aplikácii spustiť znova.
• Médiá: Ku každému príspevku sa posiela až 20 obrázkov a 10 videí ako verejne dostupné URL.
• Kontrola stavu: Len ak zadáš adresu na kontrolu stavu (health check), ALLMEDIA.AI ju kontroluje každých 6 hodín. Samotná adresa webhooku sa nikdy nevolá automaticky. Po dvoch neúspešných pokusoch dostaneš správu cez zvonček a e-mailom.

Opačný smer: REST API a MCP

Webhookové pripojenie posiela príspevky z ALLMEDIA.AI von. Ak chceš zvonka zakladať príspevky, načítavať kanály alebo prepojiť ALLMEDIA.AI s AI asistentmi ako Claude, použiješ REST API alebo MCP server.

• API kľúč na to vytvoríš cez ponuku profilu v My Profile → Developer. Ak ešte nemáš vlastný kľúč, klikneš na Create additional key. Naraz môže byť aktívny len jeden manuálny API kľúč.
• Kľúč sa celý zobrazí len raz. Hneď ho skopíruj.
• Podrobnosti: Vytvorenie a správa API kľúčov a API Quick Start: REST API a MCP server.

Časté otázky

Môžem s n8n alebo Make publikovať na platformy, ktoré ALLMEDIA.AI priamo nepripája?

Áno. Tvoj workflow prijme príspevok cez webhookové pripojenie a publikuje ho na cieľovej platforme pomocou modulov tvojho nástroja. Dôležité je, aby workflow okamžite odpovedal s HTTP 200 a na konci poslal callback.

Kde nájdem nastavenia „Publishing Connections“ alebo „API Keys“?

Tieto názvy v aplikácii neexistujú. Pripojenia na publikovanie sú pripojenia kanálov v Plan → Publishing. API kľúče nájdeš v My Profile → Developer.

Súvisiace články

• Ako fungujú pripojenia kanálov
• Vytvorenie a správa API kľúčov
• API Quick Start: REST API a MCP server
• Čo sa dá publikovať na jednotlivých kanáloch