Opsæt en publiceringsforbindelse via webhook

Hvad handler det om?

Med kanalforbindelsen Webhook overdrager ALLMEDIA.AI hvert indlæg til et vilkårligt eksternt system. Det kan være din egen tjeneste eller et workflow i et automatiseringsværktøj som n8n eller Make. Ved udgivelse sender ALLMEDIA.AI en JSON-payload via HTTPS til din tjenestes adresse. Din tjeneste udgiver indlægget på målplatformen og melder resultatet tilbage.

Payloaden er den samme for alle målsystemer. Den fulde tekniske reference finder du i udviklerdokumentationen: Publishing-API.

Forudsætninger

• En tjeneste med en offentligt tilgængelig HTTPS-adresse. Interne adresser, IP-adresser og private netværk er spærret.
• En ledig plads til en kanalforbindelse i din plan. Webhook-forbindelsen tæller som enhver anden kanalforbindelse (Free 1, Pro 6, Agentic 15).
• Grundlæggende kendskab til dit automatiseringsværktøj eller til udvikling af webtjenester.

Trin for trin

1. Forbered modtageren. Opret et slutpunkt i din tjeneste, der modtager POST-forespørgsler med JSON, for eksempel en webhook-trigger i n8n eller en custom webhook i Make. Notér HTTPS-adressen.
2. Opret webhook-forbindelsen. Åbn Planlæg & udgiv → Udgivelse i ALLMEDIA.AI, og klik på Forbind kanal. Vælg typen Webhook i dialogen »Vælg kanalforbindelsestype«, og giv den et navn.
3. Indtast adressen. Indtast din tjenestes adresse under Webhook-slutpunkt.
4. Tilføj en API-nøgle. Åbn Ekspertindstillinger. Vælg en eksisterende API-nøgle under API-nøgle-autentificering, eller klik på Opret API-nøgle. ALLMEDIA.AI sender nøglen med i headeren x-allmedia-api-key ved hvert kald. Uden API-nøgle er dit slutpunkt ikke beskyttet. Det anbefales ikke.
5. Fastlæg indstillinger. Under Brugerdefinerede headers tilføjer du flere headers, for eksempel et eget token til dit system. Valgfrit aktiverer du Include SEO fields, FAQ markup eller indtaster en Health check address.
6. Test forbindelsen. Klik på Test forbindelse. ALLMEDIA.AI sender en test-payload med "debugMode": true. Din tjeneste må aldrig lave et rigtigt indlæg ud fra den. Med Copy cURL kan du også selv gentage det samme kald.
7. Knyt den til en kanal. Gem forbindelsen. Åbn derefter kanalen under Indhold → Kanaler, skift til Workflow i kanal-canvas, og vælg webhook-forbindelsen i feltet Udgivelse („Veröffentlichung“). Først derefter kan du udgive via den.

Hvad din tjeneste skal gøre

• Tjek API-nøglen: Sammenlign headeren x-allmedia-api-key med din nøgle, og afvis forespørgsler uden gyldig nøgle med HTTP 401.
• Svar med det samme: Bekræft modtagelsen inden for få sekunder med HTTP 200, og udgiv derefter. ALLMEDIA.AI afbryder forespørgslen efter kort tid. Svarer dit slutpunkt ikke med en 2xx-status, sættes indlægget straks til »Mislykkedes«.
• Ignorér test- og kontrolkald: Forespørgsler med debugMode: true eller healthCheck: true må aldrig oprette et indlæg.
• Undgå dobbelte indlæg: Brug postId som entydig nøgle. En ny afsendelse af det samme indlæg må ikke oprette et indlæg mere.
• Meld resultatet tilbage: Send efter udgivelsen (eller ved en endelig fejl) en POST til callbackUrl fra payloaden. Til autentificering bruger du headeren x-callback-secret med værdien fra callbackSecret eller din API-nøgle med x-allmedia-api-key og x-allmedia-tenant-id. Først dette callback sætter indlægget til »Udgivet« eller »Mislykkedes«.

Vigtige felter i payloaden er postId, title, content (ren tekst ved sociale kanaler, HTML ved blog- og redaktionelle kanaler), attachmentsV2 med medierne, mode (immediate, scheduled eller draft), channelId og callbackUrl.

Begrænsninger og adfærd

• Ingen automatisk gentagelse: Et mislykket forsøg logges i indlægget. Du kan udløse udgivelsen igen i appen.
• Medier: Pr. indlæg sendes op til 20 billeder og 10 videoer med som offentligt tilgængelige URL'er.
• Health check: Kun hvis du indtaster en health check-adresse, kontrollerer ALLMEDIA.AI den hver 6. time. Selve webhook-adressen kaldes aldrig automatisk. Efter to mislykkede forsøg får du en meddelelse ved klokken og via e-mail.

Den anden retning: REST-API og MCP

Webhook-forbindelsen sender indlæg ud af ALLMEDIA.AI. Vil du oprette indlæg udefra, hente kanaler eller forbinde ALLMEDIA.AI med AI-assistenter som Claude, bruger du REST-API'et eller MCP-serveren.

• API-nøglen til det opretter du via profilmenuen under Min profil → Udvikler. Findes der endnu ingen egen nøgle, klikker du på Opret yderligere nøgle. Der kan kun være én manuel API-nøgle aktiv ad gangen.
• Nøglen vises kun fuldt ud én gang. Kopiér den med det samme.
• Detaljer: Opret og administrér API-nøgler og API Quick Start: REST-API og MCP-server.

Ofte stillede spørgsmål

Kan jeg med n8n eller Make udgive på platforme, som ALLMEDIA.AI ikke tilslutter direkte?

Ja. Dit workflow modtager indlægget via webhook-forbindelsen og udgiver det med dit værktøjs moduler på målplatformen. Det vigtige er, at workflowet svarer med HTTP 200 med det samme og sender callbacket til sidst.

Hvor finder jeg indstillingerne »Publishing Connections« eller »API Keys«?

De betegnelser findes ikke i appen. Publiceringsforbindelser er kanalforbindelser under Planlæg & udgiv → Udgivelse. API-nøgler finder du under Min profil → Udvikler.

Relaterede artikler

• Forstå kanalforbindelser
• Opret og administrér API-nøgler
• API Quick Start: REST-API og MCP-server
• Hvad der kan udgives pr. kanal