Resumen de Uso

Obtiene el resumen principal de monitoreo para el workspace: consumo de mensajes, créditos usados, conversaciones y tasa de autonomía.

GET https://api.platica.mx/v1/usage/summary

Parámetros de consulta

Parámetro	Tipo	Descripción	Requerido
`workspace`	string	Filtra la respuesta a un workspace específico. Si se omite, devuelve todos los workspaces accesibles	—
`startDate`	string	Fecha inicial en formato ISO 8601. Si se omite, usa el inicio del periodo de facturación	—
`endDate`	string	Fecha final en formato ISO 8601. Si se omite, usa el fin del periodo de facturación	—

Respuesta

{
  "workspaces": [
    {
      "id": "g6yCA16pkWl5eXo7KszB",
      "name": "Mi empresa",
      "usageSummary": {
        "billingType": "subscription",
        "plan": {
          "name": "Growth",
          "credits": 6500
        },
        "billingPeriod": {
          "startDate": "2026-06-01T00:00:00.000Z",
          "endDate": "2026-06-30T23:59:59.999Z"
        },
        "range": {
          "startDate": "2026-06-01T00:00:00.000Z",
          "endDate": "2026-06-30T23:59:59.999Z"
        },
        "dataSince": "2026-05-21T06:00:00.000Z",
        "messages": {
          "totalMessages": 1200,
          "serviceCount": 950,
          "campaignCount": 250,
          "creditsUsed": 1320,
          "credits": 6500,
          "totalChangePct": -8.8,
          "serviceChangePct": -11.2,
          "campaignChangePct": 0
        },
        "conversations": {
          "conversationCount": 340,
          "assistedConversationCount": 28,
          "assistanceRequestCount": 35,
          "autonomyRate": 91.76
        },
        "freshness": {
          "usage": {
            "source": "daily_aggregations",
            "lastUpdated": "2026-06-29T18:31:10.000Z",
            "expectedLagSeconds": 30
          },
          "conversations": {
            "source": "daily_aggregations",
            "lastUpdated": "2026-06-29T18:00:05.000Z",
            "expectedLagMinutes": 60
          }
        }
      }
    }
  ],
  "workspacesCount": 1
}

Campos de la respuesta

Campo	Descripción
`id`	ID del workspace
`name`	Nombre del workspace
`usageSummary.billingType`	Tipo de facturación del workspace
`usageSummary.plan`	Plan y créditos incluidos del workspace
`usageSummary.range`	Rango efectivo de fechas evaluado
`usageSummary.messages.totalMessages`	Total de mensajes usados
`usageSummary.messages.serviceCount`	Mensajes de servicio
`usageSummary.messages.campaignCount`	Mensajes de campaña o plantilla
`usageSummary.messages.credits`	Créditos incluidos del workspace
`usageSummary.messages.creditsUsed`	Créditos consumidos estimados (no se incluye en workspaces enterprise)
`usageSummary.messages.totalChangePct`	Variación porcentual contra el periodo anterior
`usageSummary.conversations.conversationCount`	Total de conversaciones
`usageSummary.conversations.assistedConversationCount`	Conversaciones que requirieron asistencia humana
`usageSummary.conversations.assistanceRequestCount`	Solicitudes de asistencia registradas
`usageSummary.conversations.autonomyRate`	Porcentaje de conversaciones resueltas sin asistencia humana
`usageSummary.freshness`	Última actualización y desfase esperado por fuente

Nota

En workspaces enterprise, messages incluye credits (los del workspace) pero no creditsUsed, porque la facturación enterprise usa tarifas personalizadas por cliente.

Consejo

Para desglose diario o por dimensión, usa Mensajes de Uso o Conversaciones de Uso .

Anterior Periodo de Facturación Siguiente Mensajes de Uso