API de Soporte

Recepción JSON anónima del mismo origen para el formulario de contacto del sitio. Requiere el encabezado Origin del sitio y una Idempotency-Key de 20 a 128 letras, dígitos, guiones o guiones bajos. No crea cuentas ni sesiones. Guarda el mensaje y el correo de respuesta antes de confirmar la recepción; el proceso de soporte los envía al canal de soporte de Slack configurado.

El correo proporcionado por el visitante es un dato de contacto, nunca una prueba de identidad. Los reintentos idénticos reciben la misma confirmación sin otra entrega; cambiar el cuerpo con la misma clave produce idempotency_mismatch.

Como máximo 10 mensajes nuevos por IP de cliente por hora (IPv6 agrupadas por /64), 3 por correo al día y 200 en total por hora; todas las solicitudes comparten un límite de 120 por IP por minuto. Retry-After es vinculante. Los mensajes permanecen en cola si falla la entrega; los registros entregados caducan después de 30 días.

Disponibilidad y horarios para cualquier proyecto activo. chat_allowed es verdadero para cada proyecto activo, incluido Standard. human_available es verdadero cuando una persona puede unirse al chat si se solicita (Education, Premium y Enterprise); Standard y Plus tienen documentación y soporte por IA. staffed indica si el personal está en su horario ahora. Luna responde de inmediato en todos los planes.

Conversaciones del proyecto, las más recientes primero, máximo 100. Los conteos de no leídos del personal son por persona o agente autenticado.

Disponible en todos los planes; Luna responde primero, de inmediato. Donde una persona puede unirse (human_available en el estado del soporte), solicitarla pausa a Luna para el personal; en Standard y Plus se ignora y Luna responde. Se revisa antes del almacenamiento o Slack.

Un mensaje inicial con menos de 8 caracteres o 3 palabras devuelve submission_too_short; uno que no sea pregunta o problema devuelve submission_unclear; spam, texto con muchos enlaces, inyección de indicaciones y texto inseguro devuelven submission_rejected. El texto rechazado no se conserva ni se envía a Luna, y el detalle del problema nunca lo repite.

El texto con forma de credencial distinto a las credenciales de ScreenRig (tokens bearer, claves cloud y API, claves privadas) se reemplaza por [redactado] antes de almacenarlo; el material de credenciales de ScreenRig devuelve invalid_request. Una nueva conversación inicia un hilo en Slack; los seguimientos permanecen en él. Las solicitudes con la misma clave se repiten durante 24 horas, incluida una negativa.

Mensajes en la conversación del proyecto, secuencia ascendente, máximo 100. Continúe después de la última secuencia de mensajes para paginación de conversaciones anteriores. La lectura no reconoce el estado de no leído del personal.

Agrega un mensaje de cliente a una conversación abierta. Un seguimiento no tiene longitud mínima y nunca se rechaza por ser poco claro por sí solo ("gracias", "sí"); se revisa para seguridad, inyección de indicaciones y spam de enlaces, se rechaza con submission_rejected, y el texto con forma de credencial se maneja como para una nueva conversación.

El texto rechazado no se conserva, y una negativa se reproduce bajo la misma clave durante 24 horas.

Reconozca los mensajes monótonamente a través de la secuencia para este lector. No se puede reconocer más allá de la conversación last_sequence.

Finalizar esta conversación del proyecto y cancelar respuestas pendientes de IA. Repetible; conserva el historial. El personal puede reabrirla en Slack.

Mensajes de soporte del proyecto en todos los planes como SSE reanudables. event es support.message; id es la secuencia de soporte del proyecto, data es SupportMessage. after tiene prioridad sobre Last-Event-ID. Cursor 0 reproduce el historial. Los mensajes de personal, cliente y IA se distinguen por rol. Los flujos revalidan credenciales y acceso activo al proyecto.

No se envían capturas de pantalla ni datos de credenciales.