Sette opp publiseringstilkobling via webhook

Hva handler det om?

Med kanaltilkoblingen Webhook overfører ALLMEDIA.AI hvert innlegg til et hvilket som helst eksternt system. Det kan være en egen tjeneste eller en arbeidsflyt i et automatiseringsverktøy som n8n eller Make. Ved publisering sender ALLMEDIA.AI en JSON-payload via HTTPS til adressen til tjenesten din. Tjenesten din publiserer innlegget på målplattformen og melder resultatet tilbake.

Payloaden er lik for alle målsystemer. Den fullstendige tekniske referansen finner du i utviklerdokumentasjonen: Publishing-API.

Forutsetninger

• En tjeneste med offentlig tilgjengelig HTTPS-adresse. Interne adresser, IP-adresser og private nettverk er sperret.
• En ledig plass for en kanaltilkobling i planen din. Webhook-tilkoblingen teller som enhver annen kanaltilkobling (Free 1, Pro 6, Agentic 15).
• Grunnleggende kunnskap om automatiseringsverktøyet ditt eller om utvikling av webtjenester.

Steg for steg

1. Forbered mottakeren. Opprett et endepunkt i tjenesten din som tar imot POST-forespørsler med JSON, for eksempel en webhook-trigger i n8n eller en Custom Webhook i Make. Noter HTTPS-adressen.
2. Opprett webhook-tilkobling. Åpne Planlegg & publiser → Tilkoblinger i ALLMEDIA.AI og klikk på Koble til kanal. Velg typen Webhook i dialogen «Velg kanalforbindelsestype» og gi tilkoblingen et navn.
3. Legg inn adressen. Skriv inn adressen til tjenesten din under Webhook-endepunkt.
4. Legg inn API-nøkkel. Åpne Ekspertinnstillinger. Velg en eksisterende API-nøkkel under API-nøkkelautentisering eller klikk på Opprett API-nøkkel. ALLMEDIA.AI sender nøkkelen med ved hvert kall i headeren x-allmedia-api-key. Uten API-nøkkel er endepunktet ditt ikke beskyttet. Det anbefales ikke.
5. Fastsett alternativer. Under Egendefinerte headere legger du til flere headere, for eksempel et eget token for systemet ditt. Eventuelt aktiverer du Include SEO fields, FAQ markup eller legger inn en Health check address.
6. Test tilkoblingen. Klikk på Test tilkobling. ALLMEDIA.AI sender en testpayload med "debugMode": true. Tjenesten din må aldri lage et ekte innlegg av den. Med Copy cURL kan du også gjenskape det samme kallet selv.
7. Tildel til en kanal. Lagre tilkoblingen. Åpne deretter kanalen under Innhold → Kanaler, bytt til Arbeidsflyt («Workflow») i kanalcanvaset og velg webhook-tilkoblingen i flisen Publisering («Veröffentlichung»). Først da kan du publisere via den.

Hva tjenesten din må gjøre

• Kontrollere API-nøkkelen: Sammenlign headeren x-allmedia-api-key med nøkkelen din og avvis forespørsler uten gyldig nøkkel med HTTP 401.
• Svare umiddelbart: Bekreft mottaket innen noen få sekunder med HTTP 200 og publiser etterpå. ALLMEDIA.AI avbryter forespørselen etter kort tid. Svarer ikke endepunktet ditt med en 2xx-status, settes innlegget umiddelbart til «Mislyktes».
• Ignorere test- og kontrollkall: Forespørsler med debugMode: true eller healthCheck: true må aldri opprette et innlegg.
• Unngå doble innlegg: Bruk postId som entydig nøkkel. En ny sending av det samme innlegget må ikke lage et innlegg nummer to.
• Melde tilbake resultatet: Send etter publiseringen (eller ved en endelig feil) en POST til callbackUrl fra payloaden. For autentisering bruker du headeren x-callback-secret med verdien fra callbackSecret eller API-nøkkelen din med x-allmedia-api-key og x-allmedia-tenant-id. Først denne callbacken setter innlegget til «Publisert» eller «Mislyktes».

Viktige felt i payloaden er postId, title, content (ren tekst for sosiale kanaler, HTML for blogg- og redaksjonskanaler), attachmentsV2 med mediene, mode (immediate, scheduled eller draft), channelId og callbackUrl.

Begrensninger og atferd

• Ingen automatisk gjentakelse: Et mislykket forsøk logges i innlegget. Du kan utløse publiseringen på nytt i appen.
• Medier: Per innlegg sendes opptil 20 bilder og 10 videoer med som offentlig tilgjengelige URL-er.
• Health check: Bare hvis du legger inn en health check-adresse, sjekker ALLMEDIA.AI den hver 6. time. Selve webhook-adressen kalles aldri automatisk. Etter to mislykkede forsøk får du en melding i bjellen og på e-post.

Den andre retningen: REST-API og MCP

Webhook-tilkoblingen sender innlegg ut av ALLMEDIA.AI. Vil du opprette innlegg utenfra, hente kanaler eller koble ALLMEDIA.AI til AI-assistenter som Claude, bruker du REST-API-et eller MCP-serveren.

• API-nøkkelen til dette oppretter du via profilmenyen under Min profil → Utvikler. Finnes det ennå ingen egen nøkkel, klikker du på Opprett ekstra nøkkel. Bare én manuell API-nøkkel kan være aktiv om gangen.
• Nøkkelen vises bare én gang i sin helhet. Kopier den med en gang.
• Detaljer: Opprette og administrere API-nøkler og API Quick Start: REST-API og MCP-server.

Vanlige spørsmål

Kan jeg med n8n eller Make publisere på plattformer som ALLMEDIA.AI ikke kobler til direkte?

Ja. Arbeidsflyten din tar imot innlegget via webhook-tilkoblingen og publiserer det med modulene i verktøyet ditt på målplattformen. Det viktige er at arbeidsflyten svarer umiddelbart med HTTP 200 og sender callbacken til slutt.

Hvor finner jeg innstillingene «Publishing Connections» eller «API Keys»?

Disse betegnelsene finnes ikke i appen. Publiseringstilkoblinger er kanaltilkoblinger under Planlegg & publiser → Tilkoblinger. API-nøkler finner du under Min profil → Utvikler.

Relaterte artikler

• Forstå kanaltilkoblinger
• Opprette og administrere API-nøkler
• API Quick Start: REST-API og MCP-server
• Hva som kan publiseres per kanal