Saltar al contenido
TurnitPass
DesarrolladoresAPI v1Obtener una clave API
Explorar documentación

DesarrolladoresNotificaciones

Dirigir avisos de cuenta, facturación y API con un responsable claro

Las notificaciones son una superficie operativa: saldo bajo, actividad de claves, cambios de facturación, fallos de API y actualizaciones de producto deben llegar al titular del espacio de trabajo.

REST API v1

Tu plataforma

Resumen

espacio de trabajo
POSTinternal event
por cuenta
forma del aviso
internal event
{
  "type": "low_word_balance",
  "workspace_id": "user_workspace",
  "words_remaining": 2858,
  "action_url": "/dashboard#workspace-billing"
}

Notas

01

Saldo bajo

Avisar a los equipos antes de que humanizer o detector se queden sin palabras.

02

Eventos de clave

Mostrar creación, revocación y fallos de autenticación sospechosos.

03

Actualizaciones de producto

Los cambios para desarrolladores se resumen en el changelog público.

Modelo de avisos

Las notificaciones deben corresponder a un riesgo real

1

Cambios de saldo

Avisar cuando las palabras restantes puedan bloquear trabajos de producción.

2

Ciclo de vida de la clave

Avisar al crear o revocar una clave, o si aumentan los fallos de autenticación.

3

Eventos de facturación

Enviar mejoras correctas, pagos fallidos, renovaciones y cambios del portal al titular.

4

Compatibilidad de API

Usar entradas del changelog para endpoints nuevos, campos de respuesta y cambios de límite documentados.

Canales de aviso

Qué debe incluir cada mensaje

Pocas palabras
Saldo y planIncluya palabras restantes, plan y un enlace a facturación o precios.
Clave creada
Nombre y horaIncluya la etiqueta y la marca de tiempo, nunca el token en claro.
Problema de pago
Acción de facturaciónEnlace a la facturación del espacio de trabajo y al portal tras iniciar sesión.
Cambio de API
Enlace a docsApunte a la sección exacta de la referencia o del changelog que cambió.
Nota de implementación. Esta página documenta el modelo de notificaciones. El envío de correo se conecta cuando el dominio, el buzón de soporte y las preferencias de cuenta estén listos.
Después, intégralo en tu flujo de trabajo.Seguir leyendo