Configurar una conexión de publicación mediante webhook

¿De qué se trata?

Con la conexión de canal Webhook, ALLMEDIA.AI entrega cada publicación a cualquier sistema externo. Puede ser un servicio propio o un flujo en una herramienta de automatización como n8n o Make. Al publicar, ALLMEDIA.AI envía un payload JSON por HTTPS a la dirección de tu servicio. Tu servicio publica la publicación en la plataforma de destino y comunica el resultado.

El payload es el mismo para todos los sistemas de destino. La referencia técnica completa está en la documentación para desarrolladores: Publishing API.

Requisitos

• Un servicio con una dirección HTTPS accesible públicamente. Las direcciones internas, las direcciones IP y las redes privadas están bloqueadas.
• Un hueco libre para una conexión de canal en tu plan. La conexión Webhook cuenta como cualquier otra conexión de canal (Free 1, Pro 6, Agentic 15).
• Conocimientos básicos de tu herramienta de automatización o del desarrollo de servicios web.

Paso a paso

1. Preparar el receptor. Crea en tu servicio un endpoint que acepte solicitudes POST con JSON, por ejemplo un disparador Webhook en n8n o un Custom Webhook en Make. Anota la dirección HTTPS.
2. Crear la conexión Webhook. En ALLMEDIA.AI, abre Planificar y publicar → Publicación y haz clic en Conectar canal. En el diálogo «Seleccionar tipo de conexión de canal», elige el tipo Webhook y asigna un nombre.
3. Introducir la dirección. En Endpoint de Webhook introduce la dirección de tu servicio.
4. Guardar la clave API. Abre la Configuración avanzada. En Autenticación con clave API elige una clave API existente o haz clic en Crear clave API. ALLMEDIA.AI envía la clave en cada llamada en el encabezado x-allmedia-api-key. Sin clave API, tu endpoint no está protegido. No se recomienda.
5. Definir opciones. En Encabezados personalizados añades más encabezados, por ejemplo un token propio de tu sistema. Opcionalmente activas Include SEO fields o FAQ markup, o introduces una Health check address.
6. Probar la conexión. Haz clic en Probar conexión. ALLMEDIA.AI envía un payload de prueba con "debugMode": true. Tu servicio nunca debe convertirlo en una publicación real. Con Copy cURL puedes reproducir tú mismo la misma llamada.
7. Asignarla a un canal. Guarda la conexión. Después abre el canal en Contenido → Canales, cambia en el canvas del canal a Workflow y elige la conexión Webhook en la tarjeta Publicación. Solo entonces puedes publicar a través de ella.

Qué debe hacer tu servicio

• Comprobar la clave API: compara el encabezado x-allmedia-api-key con tu clave y rechaza las solicitudes sin clave válida con HTTP 401.
• Responder de inmediato: confirma la recepción en pocos segundos con HTTP 200 y publica después. ALLMEDIA.AI cancela la solicitud tras poco tiempo. Si tu endpoint no responde con un estado 2xx, la publicación pasa de inmediato a «Fallido».
• Ignorar las llamadas de prueba y comprobación: las solicitudes con debugMode: true o healthCheck: true nunca deben crear una publicación.
• Evitar publicaciones duplicadas: usa postId como clave única. Un nuevo envío de la misma publicación no debe crear una segunda publicación.
• Comunicar el resultado: después de publicar (o ante un error definitivo), envía un POST a la callbackUrl del payload. Para autenticarte usas el encabezado x-callback-secret con el valor de callbackSecret, o tu clave API con x-allmedia-api-key y x-allmedia-tenant-id. Solo este callback cambia la publicación a «Publicado» o «Fallido».

Los campos importantes del payload son postId, title, content (texto plano en canales sociales, HTML en canales de blog y editoriales), attachmentsV2 con los medios, mode (immediate, scheduled o draft), channelId y callbackUrl.

Límites y comportamiento

• Sin reintento automático: un intento fallido queda registrado en la publicación. Puedes volver a lanzar la publicación en la aplicación.
• Medios: por publicación se envían hasta 20 imágenes y 10 vídeos como URL accesibles públicamente.
• Health check: solo si introduces una dirección de health check, ALLMEDIA.AI la comprueba cada 6 horas. La dirección del webhook nunca se llama automáticamente. Tras dos intentos fallidos recibes un aviso en la campana y por correo electrónico.

La otra dirección: API REST y MCP

La conexión Webhook envía publicaciones desde ALLMEDIA.AI hacia fuera. Si quieres crear publicaciones desde fuera, consultar canales o conectar ALLMEDIA.AI con asistentes de IA como Claude, usas la API REST o el servidor MCP.

• La clave API para ello la creas desde el menú de perfil, en Mi perfil → Desarrollador. Si todavía no tienes una clave propia, haz clic en Crear clave adicional. Solo puede haber una clave API manual activa a la vez.
• La clave solo se muestra completa una vez. Cópiala de inmediato.
• Detalles: Crear y gestionar claves API y API Quick Start: API REST y servidor MCP.

Preguntas frecuentes

¿Puedo publicar con n8n o Make en plataformas que ALLMEDIA.AI no conecta directamente?

Sí. Tu flujo recibe la publicación a través de la conexión Webhook y la publica con los módulos de tu herramienta en la plataforma de destino. Lo importante es que el flujo responda de inmediato con HTTP 200 y envíe el callback al final.

¿Dónde encuentro los ajustes «Publishing Connections» o «API Keys»?

Esas denominaciones no existen en la aplicación. Las conexiones de publicación son conexiones de canal en Planificar y publicar → Publicación. Las claves API las encuentras en Mi perfil → Desarrollador.

Artículos relacionados

• Entender las conexiones de canal
• Crear y gestionar claves API
• API Quick Start: API REST y servidor MCP
• Qué se puede publicar en cada canal