Konfigurera en publiceringsanslutning via webhook

Vad handlar det om?

Med kanalanslutningen Webhook lämnar ALLMEDIA.AI över varje inlägg till valfritt externt system. Det kan vara en egen tjänst eller ett arbetsflöde i ett automatiseringsverktyg som n8n eller Make. Vid publiceringen skickar ALLMEDIA.AI en JSON-payload via HTTPS till din tjänsts adress. Din tjänst publicerar inlägget på målplattformen och rapporterar tillbaka resultatet.

Payloaden är densamma för alla målsystem. Den fullständiga tekniska referensen hittar du i utvecklardokumentationen: Publishing-API.

Förutsättningar

• En tjänst med en offentligt nåbar HTTPS-adress. Interna adresser, IP-adresser och privata nätverk är spärrade.
• En ledig plats för en kanalanslutning i din plan. Webhook-anslutningen räknas som alla andra kanalanslutningar (Free 1, Pro 6, Agentic 15).
• Grundläggande kunskaper i ditt automatiseringsverktyg eller i utveckling av webbtjänster.

Steg för steg

1. Förbered mottagaren. Skapa en slutpunkt i din tjänst som tar emot POST-förfrågningar med JSON, till exempel en webhook-trigger i n8n eller en Custom Webhook i Make. Anteckna HTTPS-adressen.
2. Skapa webhook-anslutningen. Öppna Planera & publicera → Publicering i ALLMEDIA.AI och klicka på Anslut kanal. Välj typen Webhook i dialogen ”Välj typ av kanalanslutning” och ange ett namn.
3. Ange adressen. Ange din tjänsts adress under Webhook-slutpunkt.
4. Lägg in en API-nyckel. Öppna Expertinställningar. Välj en befintlig API-nyckel under API-nyckelautentisering eller klicka på Skapa API-nyckel. ALLMEDIA.AI skickar med nyckeln i headern x-allmedia-api-key vid varje anrop. Utan API-nyckel är din slutpunkt inte skyddad. Det rekommenderas inte.
5. Ange alternativ. Under Anpassade rubriker lägger du till fler headers, till exempel en egen token för ditt system. Valfritt aktiverar du Include SEO fields, FAQ markup eller anger en Health check address.
6. Testa anslutningen. Klicka på Testa anslutning. ALLMEDIA.AI skickar en testpayload med "debugMode": true. Din tjänst får aldrig skapa ett riktigt inlägg av den. Med Copy cURL kan du också återskapa samma anrop själv.
7. Tilldela till en kanal. Spara anslutningen. Öppna sedan kanalen under Innehåll → Kanaler, byt till Workflow i kanalcanvasen och välj webhook-anslutningen i rutan Publicering. Först då kan du publicera via den.

Vad din tjänst måste göra

• Kontrollera API-nyckeln: Jämför headern x-allmedia-api-key med din nyckel och avvisa förfrågningar utan giltig nyckel med HTTP 401.
• Svara direkt: Bekräfta mottagandet inom några sekunder med HTTP 200 och publicera därefter. ALLMEDIA.AI avbryter förfrågan efter kort tid. Om din slutpunkt inte svarar med en 2xx-status sätts inlägget direkt på ”Misslyckades”.
• Ignorera test- och kontrollanrop: Förfrågningar med debugMode: true eller healthCheck: true får aldrig skapa ett inlägg.
• Undvik dubbla inlägg: Använd postId som unik nyckel. Om samma inlägg skickas igen får det inte skapa ett andra inlägg.
• Rapportera resultatet: Skicka efter publiceringen (eller vid ett slutgiltigt fel) en POST till callbackUrl från payloaden. För autentisering använder du headern x-callback-secret med värdet från callbackSecret eller din API-nyckel med x-allmedia-api-key och x-allmedia-tenant-id. Först denna callback sätter inlägget på ”Publicerad” eller ”Misslyckades”.

Viktiga fält i payloaden är postId, title, content (ren text för sociala kanaler, HTML för blogg- och redaktionella kanaler), attachmentsV2 med media, mode (immediate, scheduled eller draft), channelId och callbackUrl.

Begränsningar och beteende

• Ingen automatisk upprepning: Ett misslyckat försök loggas i inlägget. Du kan utlösa publiceringen igen i appen.
• Media: Per inlägg skickas upp till 20 bilder och 10 videor med som offentligt hämtbara URL:er.
• Hälsokontroll: Bara om du anger en adress för hälsokontroll kontrollerar ALLMEDIA.AI den var 6:e timme. Själva webhook-adressen anropas aldrig automatiskt. Efter två misslyckade försök får du ett meddelande i klockan och via e-post.

Den andra riktningen: REST-API och MCP

Webhook-anslutningen skickar inlägg ut från ALLMEDIA.AI. Om du vill skapa inlägg utifrån, hämta kanaler eller ansluta ALLMEDIA.AI till AI-assistenter som Claude använder du REST-API:t eller MCP-servern.

• API-nyckeln för detta skapar du via profilmenyn under Min profil → Utvecklare. Om det ännu inte finns någon egen nyckel klickar du på Skapa ytterligare nyckel. Bara en manuell API-nyckel kan vara aktiv åt gången.
• Nyckeln visas fullständigt bara en gång. Kopiera den direkt.
• Detaljer: Skapa och hantera API-nycklar och API Quick Start: REST-API och MCP-server.

Vanliga frågor

Kan jag med n8n eller Make publicera på plattformar som ALLMEDIA.AI inte ansluter direkt?

Ja. Ditt arbetsflöde tar emot inlägget via webhook-anslutningen och publicerar det med verktygets moduler på målplattformen. Viktigt är att arbetsflödet svarar direkt med HTTP 200 och skickar callbacken i slutet.

Var hittar jag inställningarna ”Publishing Connections” eller ”API Keys”?

De benämningarna finns inte i appen. Publiceringsanslutningar är kanalanslutningar under Planera & publicera → Publicering. API-nycklar hittar du under Min profil → Utvecklare.

Relaterade artiklar

• Förstå kanalanslutningar
• Skapa och hantera API-nycklar
• API Quick Start: REST-API och MCP-server
• Vad som kan publiceras per kanal