Nastavení publikačního připojení přes webhook

O co jde?

S připojením kanálu Webhook předává ALLMEDIA.AI každý příspěvek libovolnému externímu systému. Může to být vlastní služba nebo workflow v automatizačním nástroji, jako je n8n nebo Make. Při zveřejnění pošle ALLMEDIA.AI JSON payload přes HTTPS na adresu tvé služby. Tvoje služba příspěvek zveřejní na cílové platformě a ohlásí výsledek zpět.

Payload je pro všechny cílové systémy stejný. Úplnou technickou referenci najdeš v dokumentaci pro vývojáře: Publishing API.

Předpoklady

• Služba s veřejně dostupnou HTTPS adresou. Interní adresy, IP adresy a privátní sítě jsou blokované.
• Volné místo pro připojení kanálu ve tvém plánu. Připojení přes webhook se počítá jako každé jiné připojení kanálu (Free 1, Pro 6, Agentic 15).
• Základní znalosti tvého automatizačního nástroje nebo vývoje webových služeb.

Krok za krokem

1. Připrav příjemce. Ve své službě založ koncový bod, který přijímá požadavky POST s JSON, například webhook trigger v n8n nebo Custom Webhook v Make. Poznamenej si HTTPS adresu.
2. Založ připojení přes webhook. V ALLMEDIA.AI otevři Plánovat a publikovat → Publikování a klikni na Propojit kanál. V dialogu „Vybrat typ připojení kanálu“ vyber typ Webhook a zadej název.
3. Zadej adresu. Do pole Webhook koncový bod zadej adresu své služby.
4. Ulož API klíč. Otevři Expertní nastavení. V sekci Autentizace API klíčem vyber existující API klíč nebo klikni na Vytvořit API klíč. ALLMEDIA.AI posílá klíč při každém volání v hlavičce x-allmedia-api-key. Bez API klíče není tvůj koncový bod chráněný. To se nedoporučuje.
5. Nastav možnosti. V Vlastní hlavičky doplníš další hlavičky, třeba vlastní token svého systému. Volitelně zapneš Include SEO fields, Označení FAQ nebo zadáš Health check address.
6. Otestuj připojení. Klikni na Otestovat připojení. ALLMEDIA.AI pošle testovací payload s "debugMode": true. Tvoje služba z něj nikdy nesmí vytvořit skutečný příspěvek. Přes Copy cURL můžeš stejné volání zopakovat i sám.
7. Přiřaď ke kanálu. Ulož připojení. Pak otevři kanál v Obsah → Kanály, na plátně kanálu přepni na Workflow a v dlaždici Zveřejnění („Veröffentlichung“) vyber připojení přes webhook. Teprve potom přes něj můžeš zveřejňovat.

Co musí tvoje služba dělat

• Kontrolovat API klíč: Porovnej hlavičku x-allmedia-api-key se svým klíčem a požadavky bez platného klíče odmítni s HTTP 401.
• Odpovídat okamžitě: Potvrď přijetí během několika sekund s HTTP 200 a zveřejni až potom. ALLMEDIA.AI požadavek po krátké době přeruší. Pokud tvůj koncový bod neodpoví stavem 2xx, příspěvek se okamžitě nastaví na „Selhalo“.
• Ignorovat testovací a kontrolní volání: Požadavky s debugMode: true nebo healthCheck: true nikdy nesmějí založit příspěvek.
• Vyhnout se duplicitním příspěvkům: Použij postId jako jedinečný klíč. Opětovné odeslání stejného příspěvku nesmí vytvořit druhý příspěvek.
• Ohlásit výsledek: Po zveřejnění (nebo při definitivní chybě) pošli POST na callbackUrl z payloadu. K autentizaci použiješ hlavičku x-callback-secret s hodnotou z callbackSecret, nebo svůj API klíč s x-allmedia-api-key a x-allmedia-tenant-id. Teprve tento callback nastaví příspěvek na „Zveřejněno“ nebo „Selhalo“.

Důležitá pole v payloadu jsou postId, title, content (čistý text u sociálních kanálů, HTML u blogových a redakčních kanálů), attachmentsV2 s médii, mode (immediate, scheduled nebo draft), channelId a callbackUrl.

Omezení a chování

• Žádné automatické opakování: Neúspěšný pokus se zaznamená u příspěvku. Zveřejnění můžeš v aplikaci spustit znovu.
• Média: S každým příspěvkem jde až 20 obrázků a 10 videí jako veřejně dostupné URL.
• Health check: Jen pokud zadáš adresu pro health check, ALLMEDIA.AI ji kontroluje každých 6 hodin. Samotná adresa webhooku se nikdy automaticky nevolá. Po dvou neúspěšných pokusech dostaneš upozornění ve zvonečku a e-mailem.

Opačný směr: REST API a MCP

Připojení přes webhook posílá příspěvky z ALLMEDIA.AI ven. Pokud chceš zvenku zakládat příspěvky, dotazovat se na kanály nebo propojit ALLMEDIA.AI s AI asistenty, jako je Claude, použij REST API nebo MCP server.

• API klíč k tomu vytvoříš přes nabídku profilu v Můj profil → Vývojář. Pokud ještě nemáš vlastní klíč, klikni na Vytvořit další klíč. Současně může být aktivní jen jeden ruční API klíč.
• Klíč se celý zobrazí jen jednou. Hned ho zkopíruj.
• Podrobnosti: Vytvoření a správa API klíčů a API Quick Start: REST API a MCP server.

Časté otázky

Můžu přes n8n nebo Make zveřejňovat na platformách, které ALLMEDIA.AI přímo nepřipojuje?

Ano. Tvůj workflow přijme příspěvek přes připojení typu webhook a zveřejní ho moduly tvého nástroje na cílové platformě. Důležité je, aby workflow okamžitě odpověděl s HTTP 200 a na konci poslal callback.

Kde najdu nastavení „Publishing Connections“ nebo „API Keys“?

Tyto názvy v aplikaci neexistují. Publikační připojení jsou připojení kanálů v Plánovat a publikovat → Publikování. API klíče najdeš v Můj profil → Vývojář.

Související články

• Připojení kanálů: jak fungují
• Vytvoření a správa API klíčů
• API Quick Start: REST API a MCP server
• Co lze zveřejnit na kterém kanálu