Publicatieverbinding via webhook instellen

Waar gaat het om?

Met de kanaalverbinding Webhook geeft ALLMEDIA.AI elk bericht door aan een willekeurig extern systeem. Dat kan een eigen dienst zijn of een workflow in een automatiseringstool zoals n8n of Make. Bij het publiceren stuurt ALLMEDIA.AI een JSON-payload via HTTPS naar het adres van je dienst. Je dienst publiceert het bericht op het doelplatform en meldt het resultaat terug.

De payload is voor alle doelsystemen gelijk. De volledige technische referentie vind je in de ontwikkelaarsdocumentatie: Publishing-API.

Voorwaarden

• Een dienst met een publiek bereikbaar HTTPS-adres. Interne adressen, IP-adressen en privénetwerken zijn geblokkeerd.
• Een vrije plek voor een kanaalverbinding in je abonnement. De webhookverbinding telt mee zoals elke andere kanaalverbinding (Free 1, Pro 6, Agentic 15).
• Basiskennis van je automatiseringstool of van het ontwikkelen van webdiensten.

Stap voor stap

1. Ontvanger voorbereiden. Maak in je dienst een endpoint aan dat POST-verzoeken met JSON accepteert, bijvoorbeeld een webhooktrigger in n8n of een Custom Webhook in Make. Noteer het HTTPS-adres.
2. Webhookverbinding aanmaken. Open in ALLMEDIA.AI Plannen & publiceren → Publiceren en klik op Kanaal verbinden. Kies in het dialoogvenster „Kanaalverbindingstype selecteren” het type Webhook en geef een naam op.
3. Adres invullen. Vul onder Webhook-eindpunt het adres van je dienst in.
4. API-sleutel opslaan. Open de Expertinstellingen. Kies onder API-sleutel authenticatie een bestaande API-sleutel of klik op API-sleutel aanmaken. ALLMEDIA.AI stuurt de sleutel bij elke aanroep mee in de header x-allmedia-api-key. Zonder API-sleutel is je endpoint niet beveiligd. Dat wordt niet aanbevolen.
5. Opties vastleggen. Onder Aangepaste headers voeg je extra headers toe, bijvoorbeeld een eigen token van je systeem. Optioneel activeer je Include SEO fields, de FAQ markup of vul je een Health check address in.
6. Verbinding testen. Klik op Test connection. ALLMEDIA.AI stuurt een testpayload met "debugMode": true. Je dienst mag daar nooit een echt bericht van maken. Met Copy cURL kun je dezelfde aanroep ook zelf nabootsen.
7. Aan een kanaal toewijzen. Sla de verbinding op. Open dan het kanaal onder Content → Kanalen, ga in het kanaalcanvas naar Workflow en kies de webhookverbinding in de tegel Publicatie. Pas dan kun je erlangs publiceren.

Wat je dienst moet doen

• API-sleutel controleren: vergelijk de header x-allmedia-api-key met je sleutel en weiger verzoeken zonder geldige sleutel met HTTP 401.
• Meteen antwoorden: bevestig de ontvangst binnen enkele seconden met HTTP 200 en publiceer daarna. ALLMEDIA.AI breekt het verzoek na korte tijd af. Antwoordt je endpoint niet met een 2xx-status, dan wordt het bericht meteen op „Mislukt” gezet.
• Test- en controleaanroepen negeren: verzoeken met debugMode: true of healthCheck: true mogen nooit een bericht aanmaken.
• Dubbele berichten vermijden: gebruik postId als unieke sleutel. Opnieuw versturen van hetzelfde bericht mag geen tweede bericht opleveren.
• Resultaat terugmelden: stuur na het publiceren (of bij een definitieve fout) een POST naar de callbackUrl uit de payload. Voor authenticatie gebruik je de header x-callback-secret met de waarde uit callbackSecret of je API-sleutel met x-allmedia-api-key en x-allmedia-tenant-id. Pas deze callback zet het bericht op „Gepubliceerd” of „Mislukt”.

Belangrijke velden in de payload zijn postId, title, content (platte tekst bij socialmediakanalen, HTML bij blog- en redactiekanalen), attachmentsV2 met de media, mode (immediate, scheduled of draft), channelId en callbackUrl.

Grenzen en gedrag

• Geen automatische herhaling: een mislukte poging wordt in het bericht gelogd. Je kunt de publicatie in de app opnieuw starten.
• Media: per bericht gaan maximaal 20 afbeeldingen en 10 video's mee als publiek op te vragen URL's.
• Health check: alleen als je een health-check-adres invult, controleert ALLMEDIA.AI dat elke 6 uur. Het webhookadres zelf wordt nooit automatisch aangeroepen. Na twee mislukte pogingen krijg je een melding in de bel en per e-mail.

De andere richting: REST-API en MCP

De webhookverbinding stuurt berichten uit ALLMEDIA.AI naar buiten. Wil je van buitenaf berichten aanmaken, kanalen opvragen of ALLMEDIA.AI verbinden met AI-assistenten zoals Claude, dan gebruik je de REST-API of de MCP-server.

• De API-sleutel daarvoor maak je aan via het profielmenu onder Mijn profiel → Ontwikkelaar. Is er nog geen eigen sleutel, dan klik je op Extra sleutel aanmaken. Er kan maar één handmatige API-sleutel tegelijk actief zijn.
• De sleutel wordt maar één keer volledig getoond. Kopieer hem meteen.
• Details: API-sleutels aanmaken en beheren en API Quick Start: REST-API en MCP-server.

Veelgestelde vragen

Kan ik met n8n of Make publiceren op platforms die ALLMEDIA.AI niet direct koppelt?

Ja. Je workflow ontvangt het bericht via de webhookverbinding en publiceert het met de modules van je tool op het doelplatform. Belangrijk is dat de workflow meteen met HTTP 200 antwoordt en aan het eind de callback stuurt.

Waar vind ik de instellingen „Publishing Connections” of „API Keys”?

Die benamingen bestaan niet in de app. Publicatieverbindingen zijn kanaalverbindingen onder Plannen & publiceren → Publiceren. API-sleutels vind je onder Mijn profiel → Ontwikkelaar.

Gerelateerde artikelen

• Kanaalverbindingen begrijpen
• API-sleutels aanmaken en beheren
• API Quick Start: REST-API en MCP-server
• Wat er per kanaal gepubliceerd kan worden