Configurer une connexion de publication via webhook

De quoi s'agit-il ?

Avec la connexion de canal Webhook, ALLMEDIA.AI transmet chaque publication à n'importe quel système externe. Il peut s'agir de ton propre service ou d'un workflow dans un outil d'automatisation comme n8n ou Make. Lors de la publication, ALLMEDIA.AI envoie un payload JSON en HTTPS à l'adresse de ton service. Ton service publie la publication sur la plateforme cible et renvoie le résultat.

Le payload est le même pour tous les systèmes cibles. Tu trouves la référence technique complète dans la documentation développeur : Publishing API.

Prérequis

• Un service avec une adresse HTTPS accessible publiquement. Les adresses internes, les adresses IP et les réseaux privés sont bloqués.
• Une place libre pour une connexion de canal dans ton plan. La connexion Webhook compte comme toute autre connexion de canal (Free 1, Pro 6, Agentic 15).
• Des connaissances de base de ton outil d'automatisation ou du développement de services web.

Étape par étape

1. Préparer le destinataire. Dans ton service, crée un point de terminaison qui accepte des requêtes POST en JSON, par exemple un déclencheur Webhook dans n8n ou un Custom Webhook dans Make. Note l'adresse HTTPS.
2. Créer la connexion Webhook. Dans ALLMEDIA.AI, ouvre Planifier & publier → Publication et clique sur Connecter un canal. Dans la boîte de dialogue « Sélectionne un type de connexion de canal », choisis le type Webhook et donne-lui un nom.
3. Saisir l'adresse. Sous Point de terminaison Webhook, saisis l'adresse de ton service.
4. Enregistrer une clé API. Ouvre les Paramètres experts. Sous Authentification par clé API, choisis une clé API existante ou clique sur Créer une clé API. ALLMEDIA.AI envoie la clé à chaque appel dans l'en-tête x-allmedia-api-key. Sans clé API, ton point de terminaison n'est pas protégé. Ce n'est pas recommandé.
5. Définir les options. Sous En-têtes personnalisés, tu ajoutes d'autres en-têtes, par exemple un jeton propre à ton système. En option, tu actives Include SEO fields, le FAQ markup ou tu saisis une Health check address.
6. Tester la connexion. Clique sur Test connection. ALLMEDIA.AI envoie un payload de test avec "debugMode": true. Ton service ne doit jamais en faire une vraie publication. Avec Copy cURL, tu peux aussi reproduire toi-même le même appel.
7. Attribuer à un canal. Enregistre la connexion. Ouvre ensuite le canal sous Contenu → Canaux, passe sur Workflow dans le canevas du canal et choisis la connexion Webhook dans la tuile Publication („Veröffentlichung“). Ce n'est qu'alors que tu peux publier par son intermédiaire.

Ce que ton service doit faire

• Vérifier la clé API : compare l'en-tête x-allmedia-api-key avec ta clé et rejette les requêtes sans clé valide avec HTTP 401.
• Répondre immédiatement : confirme la réception en quelques secondes avec HTTP 200 et publie ensuite. ALLMEDIA.AI interrompt la requête au bout de peu de temps. Si ton point de terminaison ne répond pas avec un statut 2xx, la publication passe immédiatement à « Échoué ».
• Ignorer les appels de test et de vérification : les requêtes avec debugMode: true ou healthCheck: true ne doivent jamais créer de publication.
• Éviter les doublons : utilise postId comme clé unique. Un nouvel envoi de la même publication ne doit pas créer de deuxième publication.
• Renvoyer le résultat : après la publication (ou en cas d'erreur définitive), envoie un POST à la callbackUrl du payload. Pour l'authentification, utilise l'en-tête x-callback-secret avec la valeur de callbackSecret ou ta clé API avec x-allmedia-api-key et x-allmedia-tenant-id. C'est seulement ce callback qui fait passer la publication à « Publié » ou « Échoué ».

Les champs importants du payload sont postId, title, content (texte brut pour les canaux sociaux, HTML pour les canaux de blog et éditoriaux), attachmentsV2 avec les médias, mode (immediate, scheduled ou draft), channelId et callbackUrl.

Limites et comportement

• Pas de nouvelle tentative automatique : une tentative échouée est consignée dans la publication. Tu peux relancer la publication dans l'application.
• Médias : par publication, jusqu'à 20 images et 10 vidéos sont envoyées sous forme d'URL accessibles publiquement.
• Health check : ALLMEDIA.AI ne vérifie une adresse de health check toutes les 6 heures que si tu en saisis une. L'adresse du webhook elle-même n'est jamais appelée automatiquement. Après deux échecs, tu reçois un message dans la cloche et par e-mail.

L'autre sens : API REST et MCP

La connexion Webhook envoie les publications depuis ALLMEDIA.AI vers l'extérieur. Si tu veux créer des publications depuis l'extérieur, interroger des canaux ou connecter ALLMEDIA.AI à des assistants IA comme Claude, tu utilises l'API REST ou le serveur MCP.

• Tu crées la clé API pour cela via le menu du profil sous Mon profil → Développeur. S'il n'existe pas encore de clé propre, clique sur Créer une clé supplémentaire. Une seule clé API manuelle peut être active à la fois.
• La clé n'est affichée en entier qu'une seule fois. Copie-la immédiatement.
• Détails : Créer et gérer des clés API et API Quick Start : API REST et serveur MCP.

Questions fréquentes

Puis-je publier avec n8n ou Make sur des plateformes qu'ALLMEDIA.AI ne connecte pas directement ?

Oui. Ton workflow reçoit la publication via la connexion Webhook et la publie sur la plateforme cible avec les modules de ton outil. L'important est que le workflow réponde immédiatement avec HTTP 200 et envoie le callback à la fin.

Où trouver les paramètres « Publishing Connections » ou « API Keys » ?

Ces désignations n'existent pas dans l'application. Les connexions de publication sont des connexions de canal sous Planifier & publier → Publication. Tu trouves les clés API sous Mon profil → Développeur.

Articles connexes

• Comprendre les connexions de canal
• Créer et gérer des clés API
• API Quick Start : API REST et serveur MCP
• Ce qui peut être publié sur chaque canal