Informes de problemas · Documentación de TradeCatalog

Los empleados de proveedores y compradores identificados pueden enviar un error o una sugerencia desde cualquier página de la aplicación. Cada informe se almacena con el estado abierto y se envía por correo electrónico a Happy Webs.

Esta página es para la automatización que recoge estos informes. No es una clave de espacio de trabajo, y no está en el documento OpenAPI.

AutenticarEnlace a esta sección#

La solicitud utiliza un token de portador. El token es el secreto del trabajador FEEDBACK_REPORTS_TOKEN.

Establézcalo una vez, fuera de git:

bash

wrangler secret put FEEDBACK_REPORTS_TOKEN

Para desarrollo local, coloque el mismo nombre en .dev.vars. No confirme el valor.

Envíelo en cada solicitud:

http

GET /api/feedback-reports?since=2026-10-15T00:00:00.000Z HTTP/1.1
Host: tradecatalog.app
Authorization: Bearer <FEEDBACK_REPORTS_TOKEN>

bash

curl "https://tradecatalog.app/api/feedback-reports?since=2026-10-15T00:00:00.000Z" \
  -H "Authorization: Bearer $FEEDBACK_REPORTS_TOKEN"

Si el secreto falta, o el encabezado falta o es incorrecto, la respuesta es 401 con WWW-Authenticate: Bearer realm="feedback-reports". No hay cookie, ninguna clave de API de espacio de trabajo y no hay CORS.

GET/api/feedback-reports

Listar informes abiertosEnlace a esta sección#

since es necesario. Es una hora en formato ISO-8601 o un tiempo Unix en milisegundos. La lista es informes abiertos creados después de ese tiempo, en orden más antiguo primero, hasta 100.

Nombre	Tipo	Requerido	Descripción
`since`	string	sí	Límite inferior exclusivo en `createdAt`.
`after`	string	no	Identificador del informe. Con `since`, también devuelve informes que comparten ese tiempo exacto y se ordenan después de este identificador. Use ambos cuando `hasMore` sea verdadero.

Un informe que se ha cerrado no está en esta lista, incluso si se creó después de since.

json

{
  "reports": [
    {
      "id": "…",
      "kind": "bug",
      "status": "open",
      "message": "The price shows as zero.",
      "pageUrl": "https://tradecatalog.app/s/northgate/products",
      "tenantSlug": "northgate",
      "userId": "…",
      "role": "Owner",
      "email": "owner@example.com",
      "userAgent": "…",
      "viewport": "1440x900",
      "createdAt": "2026-10-15T12:00:00.000Z",
      "hasScreenshot": true,
      "screenshotUrl": "https://tradecatalog.app/api/feedback-reports/…/screenshot",
      "autoReplyText": null,
      "autoReplySentAt": null,
      "resolvedReplyText": null,
      "resolvedReplySentAt": null,
      "adminUrl": "https://tradecatalog.app/admin?section=reports&report=…"
    }
  ],
  "hasMore": false
}

Almacene el createdAt y id del último informe que guardó. La próxima consulta usa ese tiempo como since. Si la página estaba completa (hasMore es verdadero), también pase ese identificador como after y mantenga el mismo since, para que un informe guardado en el mismo milisegundo no se salte.

Captura de pantallaEnlace a esta sección#

GET/api/feedback-reports/{id}/screenshot

El mismo token de portador. La respuesta es la imagen, o 404 cuando ese informe no tiene captura de pantalla. El identificador es el identificador del informe de la lista. No es una clave de objeto.

Los administradores de la plataforma también pueden abrir la captura de pantalla mientras están conectados en /admin/feedback-reports/{id} y resolver un informe en Soporte → Informes.

Respuesta automáticaEnlace a esta sección#

Guardar un informe envía una nota breve al usuario conectado en su propia dirección. Resolverlo envía otra nota más, indicando que se ha solucionado y está en funcionamiento. Cada una se envía como máximo una vez por informe.

autoReplyText y autoReplySentAt son esa primera nota. resolvedReplyText y resolvedReplySentAt son la nota resuelta. Permanecen nulos hasta que se haya enviado el correo.

Establezca la variable Worker FEEDBACK_AUTO_REPLY en off para detener ambos. AUTO_REPLY_BCC es un secreto: la dirección copiada en esos correos. Deje que esté sin configurar y nada se copiará. El texto está redactado con el AI de Workers. Si ese borrador falla en una comprobación, se envía una nota fija en su lugar.

Cada informe también se convierte en un ticket numerado. Resolver ese ticket envía el mismo correo fijo y en funcionamiento una vez. El correo a soporte@ o info@tradecatalog.app se reenvía a SUPPORT_FORWARD_TO antes de que se lea, luego se archiva de la misma manera. Si esa dirección falta, o el reenvío falla, el mensaje se rechaza para que el remitente lo intente de nuevo. Se adjunta a una cuenta existente solo cuando Authentication-Results muestra un paso de DMARC, o ambos DKIM y SPF cuando DMARC esté ausente. De lo contrario, el ticket permanece sin enlazar y no se envía ninguna confirmación.