API/Webhook + AymarTech

Envía artículos generados por IA a tu endpoint automáticamente o tras aprobación usando webhooks firmados.

API/Webhook es para sitios web a medida y stacks CMS no compatibles. Tu sitio puede obtener artículos aprobados o auto-publicados de AymarTech con una clave API y recibir notificaciones webhook cuando cambie el estado del artículo.

Problemas

Por qué la publicación SEO se queda atascada

La mayoría de los equipos no falla por falta de ideas. Falla porque cada artículo exige demasiadas pequeñas decisiones manuales antes de salir publicado.

Elegir temas se vuelve una apuesta

La demanda de keywords, la intención de búsqueda y el encaje con el negocio quedan repartidos entre pestañas, así que el siguiente artículo se elige por opinión y no por evidencia.

Cada artículo se convierte en una checklist operativa

Briefs, borradores, imágenes, metadatos, enlaces internos y QA saltan entre herramientas hasta volver el proceso lento e inconsistente.

La publicación se frena en la última milla

Los borradores terminados esperan slugs, formato, campos de la plataforma y alguien con tiempo para poner todo en vivo.

Qué obtienes

De demanda real de búsqueda a artículos listos para indexar

Keywords que la gente ya busca

AymarTech encuentra consultas con demanda real, intención clara y una oportunidad razonable de atraer tráfico cualificado.

Investigación profunda en muchas fuentes

Cada artículo se construye con investigación amplia de fuentes, para cubrir el tema con sustancia y no con relleno genérico.

Publicación compatible con Google

Estructura limpia, metadatos, slugs, enlaces internos y publicación directa ayudan a Google a descubrir e indexar artículos nuevos más rápido.

Flujo de contenido

De keyword a artículo SEO terminado

01

Encontrar demanda

AymarTech identifica temas de baja competencia que tus clientes ya están buscando.

02

Escribir y optimizar

El artículo se escribe, verifica, formatea, enriquece con imágenes y se prepara con detalles SEO.

03

Entregar el payload

AymarTech prepara el artículo para la Publishing API y los eventos webhook, y luego entrega automáticamente o espera aprobación.

Para quién es

Úsala cuando controles el código, quieras renderizado personalizado o necesites que AymarTech avise a tu backend con entrega automática o confirmación antes de exponer los datos del artículo.

Qué se publica o entrega

Carga útil AymarTech expone artículos publicados mediante la Publishing API y puede enviar webhooks article_published, article_updated y article_unpublished. Los payloads de webhook incluyen event, article id, slug, headline, estado de publicación y updatedAt; las respuestas de artículo de la API incluyen contenido y metadatos para el renderizado.

Configuración

Todos los formularios de conexión, botones OAuth, selectores de destino, ajustes de modo de publicación y pruebas están en el panel de AymarTech. Elige publicación automática o exige confirmación antes de salir en vivo.

Abrir integraciones del panel →
  1. Abre el proyecto en AymarTech y ve a los ajustes de publishing/API del panel.
  2. Genera una clave API para el proyecto.
  3. Define BLOG_WRITER_BASE_URL con la URL base de la publish API del proyecto y BLOG_WRITER_API_KEY con la clave generada en el entorno de tu sitio.
  4. Usa GET /articles para listas, GET /articles?slug=... para páginas de artículo y GET /sitemap para sitemaps dinámicos.
  5. Elige entrega automática o confirmación antes de exponer datos del artículo y, opcionalmente, añade una URL de webhook y un secret para revalidación de caché o flujos posteriores.
  6. Envía un webhook de prueba desde el panel y confirma que tu endpoint responde 2xx.

Cómo funciona la publicación o entrega de artículos

  • La Publishing API solo devuelve datos de artículos aprobados o auto-publicados del proyecto asociado a la clave API.
  • Los webhooks se envían tras aprobación o auto-publicación en los eventos article_published, article_updated y article_unpublished.
  • Si hay un secret de webhook configurado, AymarTech envía los encabezados X-Webhook-Signature y X-Webhook-Secret.
  • Las firmas de webhook son HMAC-SHA256 sobre el cuerpo JSON del payload.
  • Tu sitio sigue siendo responsable del HTML, metadatos SEO, URLs canónicas, hreflang e invalidación de caché.

Solución de problemas

  • 401 de la Publishing API: confirma que la clave API está en X-API-Key o Authorization: Bearer.
  • No se devuelven artículos: confirma que están aprobados o auto-publicados en AymarTech y que el ID de proyecto/URL base son correctos.
  • Desajuste de firma del webhook: verifica que tu servidor calcula HMAC sobre el cuerpo JSON crudo exacto con el secret guardado.
  • Timeout del webhook: responde rápido con 2xx y mueve el procesamiento pesado a una cola.
  • Sitemap desactualizado: genéralo dinámicamente o revalídalo cuando lleguen webhooks article_published.

Preguntas frecuentes

¿La entrega API/Webhook puede ser automática?

Sí. Eliges el modo: entregar o exponer datos del artículo automáticamente cuando estén listos, o exigir confirmación primero. Tu sitio o backend sigue decidiendo cómo renderizar o almacenar el contenido.

¿Qué endpoints necesito?

La mayoría de sitios usan /articles para listas, /articles?slug=... para páginas de detalle y /sitemap para descubrimiento SEO.

¿Son obligatorios los webhooks?

No. Son opcionales, pero útiles para revalidación de caché y flujos posteriores.

¿Cómo debo verificar los webhooks?

Usa X-Webhook-Signature con tu secret compartido. También se envía X-Webhook-Secret cuando está configurado, para una validación más simple.

¿Dónde están los valores exactos de la API?

El panel muestra la clave API del proyecto, la URL base de la publish API, el campo de URL del webhook, el campo secret y las acciones de prueba.

Relacionado

Controla la entrega de artículos SEO

Empieza gratis, conecta tu endpoint y elige entrega automática o aprobación antes de que los artículos optimizados lleguen a tu backend.