Közzétételi kapcsolat beállítása webhookkal

Miről szól?

A Webhook csatornakapcsolattal az ALLMEDIA.AI minden bejegyzést átad egy tetszőleges külső rendszernek. Ez lehet egy saját szolgáltatás vagy egy munkafolyamat egy automatizálási eszközben, például az n8n-ben vagy a Make-ben. Közzétételkor az ALLMEDIA.AI egy JSON-payloadot küld HTTPS-en a szolgáltatásod címére. A szolgáltatásod közzéteszi a bejegyzést a célplatformon, és visszajelzi az eredményt.

A payload minden célrendszerhez azonos. A teljes technikai referenciát a fejlesztői dokumentációban: Publishing API találod.

Előfeltételek

• Egy nyilvánosan elérhető HTTPS-címmel rendelkező szolgáltatás. Belső címek, IP-címek és privát hálózatok le vannak tiltva.
• Egy szabad csatornakapcsolat-hely a csomagodban. A Webhook-kapcsolat ugyanúgy számít, mint bármely más csatornakapcsolat (Free 1, Pro 6, Agentic 15).
• Alapismeretek az automatizálási eszközödben vagy webszolgáltatások fejlesztésében.

Lépésről lépésre

1. Készítsd elő a fogadót. Hozz létre a szolgáltatásodban egy végpontot, amely JSON-t tartalmazó POST-kéréseket fogad, például egy Webhook-triggert az n8n-ben vagy egy Custom Webhookot a Make-ben. Jegyezd fel a HTTPS-címet.
2. Hozd létre a Webhook-kapcsolatot. Az ALLMEDIA.AI-ban nyisd meg a Tervezés és közzététel → Csatlakozók oldalt, és kattints a Csatorna csatlakoztatása gombra. A „Csatornakapcsolat típusának kiválasztása” párbeszédablakban válaszd a Webhook típust, és adj nevet a kapcsolatnak.
3. Add meg a címet. A Webhook végpont alatt add meg a szolgáltatásod címét.
4. Add meg az API-kulcsot. Nyisd meg a Szakértői beállítások részt. Az API-kulcs hitelesítés alatt válassz egy meglévő API-kulcsot, vagy kattints az API-kulcs létrehozása gombra. Az ALLMEDIA.AI minden híváskor elküldi a kulcsot az x-allmedia-api-key fejlécben. API-kulcs nélkül a végpontod nincs védve. Ez nem ajánlott.
5. Állítsd be a lehetőségeket. Az Egyéni fejlécek alatt további fejléceket adhatsz meg, például a rendszered saját tokenjét. Igény szerint bekapcsolhatod az Include SEO fields és a FAQ markup opciót, vagy megadhatsz egy Health check address címet.
6. Teszteld a kapcsolatot. Kattints a Kapcsolat tesztelése gombra. Az ALLMEDIA.AI egy teszt-payloadot küld "debugMode": true értékkel. A szolgáltatásod ebből soha nem hozhat létre valódi bejegyzést. A Copy cURL gombbal ugyanezt a hívást magad is lefuttathatod.
7. Rendeld csatornához. Mentsd a kapcsolatot. Ezután nyisd meg a csatornát a Tartalom → Csatornák alatt, a csatornavásznon („Kanal-Kanvas“) válts a Workflow nézetre, és a Közzététel („Veröffentlichung“) csempén válaszd ki a Webhook-kapcsolatot. Csak ezután tehetsz közzé rajta keresztül.

Mit kell tennie a szolgáltatásodnak

• API-kulcs ellenőrzése: Hasonlítsd össze az x-allmedia-api-key fejlécet a kulcsoddal, és az érvényes kulcs nélküli kéréseket utasítsd el HTTP 401-gyel.
• Azonnali válasz: Néhány másodpercen belül igazold vissza a fogadást HTTP 200-zal, és csak utána tedd közzé a bejegyzést. Az ALLMEDIA.AI rövid idő után megszakítja a kérést. Ha a végpontod nem 2xx státusszal válaszol, a bejegyzés azonnal „Sikertelen” állapotba kerül.
• Teszt- és ellenőrző hívások figyelmen kívül hagyása: A debugMode: true vagy healthCheck: true értékű kérések soha nem hozhatnak létre bejegyzést.
• Duplikált bejegyzések elkerülése: Használd a postId értéket egyedi kulcsként. Ugyanannak a bejegyzésnek az ismételt küldése nem hozhat létre második bejegyzést.
• Eredmény visszajelzése: A közzététel után (vagy végleges hiba esetén) küldj egy POST-kérést a payloadban lévő callbackUrl címre. A hitelesítéshez az x-callback-secret fejlécet használod a callbackSecret értékével, vagy az API-kulcsodat az x-allmedia-api-key és x-allmedia-tenant-id fejlécekkel. Csak ez a callback állítja a bejegyzést „Közzétéve” vagy „Sikertelen” állapotba.

A payload fontos mezői: postId, title, content (közösségimédia-csatornáknál egyszerű szöveg, blog- és szerkesztőségi csatornáknál HTML), attachmentsV2 a médiafájlokkal, mode (immediate, scheduled vagy draft), channelId és callbackUrl.

Korlátok és viselkedés

• Nincs automatikus újrapróbálkozás: A sikertelen kísérletet a bejegyzés naplózza. A közzétételt az alkalmazásban újra elindíthatod.
• Médiafájlok: Bejegyzésenként legfeljebb 20 kép és 10 videó kerül át nyilvánosan elérhető URL-ként.
• Health check: Az ALLMEDIA.AI csak akkor ellenőrzi 6 óránként a health check címet, ha megadtál ilyet. Magát a Webhook-címet soha nem hívja meg automatikusan. Két sikertelen kísérlet után értesítést kapsz a csengő ikonnál és e-mailben.

A másik irány: REST API és MCP

A Webhook-kapcsolat a bejegyzéseket kifelé küldi az ALLMEDIA.AI-ból. Ha kívülről szeretnél bejegyzéseket létrehozni, csatornákat lekérdezni vagy az ALLMEDIA.AI-t AI-asszisztensekhez, például Claude-hoz kapcsolni, a REST API-t vagy az MCP-szervert használod.

• Az ehhez szükséges API-kulcsot a profilmenüben, a Profilom → Fejlesztő alatt hozod létre. Ha még nincs saját kulcsod, kattints a További kulcs létrehozása gombra. Egyszerre csak egy manuális API-kulcs lehet aktív.
• A kulcs csak egyszer jelenik meg teljes egészében. Azonnal másold ki.
• Részletek: API-kulcsok létrehozása és kezelése és API gyorsindítás: REST API és MCP-szerver.

Gyakori kérdések

Közzétehetek n8n-nel vagy Make-kel olyan platformokra, amelyeket az ALLMEDIA.AI közvetlenül nem kapcsol be?

Igen. A munkafolyamatod a Webhook-kapcsolaton keresztül fogadja a bejegyzést, és az eszközöd moduljaival közzéteszi a célplatformon. Fontos, hogy a munkafolyamat azonnal HTTP 200-zal válaszoljon, és a végén elküldje a callbacket.

Hol találom a „Publishing Connections” vagy „API Keys” beállítást?

Ilyen elnevezések nincsenek az alkalmazásban. A közzétételi kapcsolatok csatornakapcsolatok a Tervezés és közzététel → Csatlakozók alatt. Az API-kulcsokat a Profilom → Fejlesztő alatt találod.

Kapcsolódó cikkek

• A csatornakapcsolatok megértése
• API-kulcsok létrehozása és kezelése
• API gyorsindítás: REST API és MCP-szerver
• Mit lehet csatornánként közzétenni?