API Webhook + AymarTech

Envía cada artículo generado por IA desde AymarTech a tu endpoint con entregas webhook firmadas.

AymarTech publica artículos terminados como borradores estructurados en tu flujo de API Webhook, para que el equipo revise antes de publicar.

Para quién es

Esta integración es para equipos que usan API Webhook y necesitan un flujo confiable para publicar SEO de forma continua.

Qué se publica

Carga útil AymarTech envía una carga JSON con article ID, title, slug, excerpt, HTML body, plain text body, cover image URL, locale, tags, publish intent y timestamps.

Configuración

  1. Crea la integración API Webhook en AymarTech y pega tu URL endpoint.
  2. Genera un secreto de firma y guárdalo en tu servicio receptor.
  3. Define cómo mapear campos del artículo en tu backend.
  4. Envía un payload de prueba y valida firma y código de respuesta.

Cómo funciona por dentro

  • Las solicitudes salen por HTTPS con firma HMAC.
  • Los reintentos usan backoff exponencial para errores temporales.
  • El esquema de payload está versionado.
  • Los logs incluyen status code y número de reintentos.

Solución de problemas

  • 401 o firma inválida: verifica secreto y lógica de validación.
  • Timeouts: procesa de forma asíncrona y responde rápido.
  • Errores 4xx: corrige el mapeo en el receptor.
  • Entregas duplicadas: aplica idempotencia con IDs de artículo.

Preguntas frecuentes

¿El webhook incluye HTML completo?

Sí, incluye cuerpo, metadatos y URLs de medios.

¿Cómo verifico autenticidad?

Valida la firma HMAC con tu secreto compartido.

¿Puedo usar endpoints de staging y producción?

Sí, con integraciones separadas.

¿Cuál es la política de reintentos?

Backoff exponencial acotado para fallos temporales.

¿Sirve para flujos no CMS?

Sí, puedes enviarlo a colas, APIs internas o workflows.

Relacionado