Conversaciones de Uso

Devuelve métricas de conversaciones y autonomía, con desglose por plataforma, agente, canal o etiqueta.

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

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	—
`breakdown`	enum	Dimensión del desglose: `platform` (default), `agent`, `channel` o `tag`	—

Respuesta

{
  "workspaces": [
    {
      "id": "g6yCA16pkWl5eXo7KszB",
      "name": "Mi empresa",
      "billingPeriod": {
        "startDate": "2026-06-01T00:00:00.000Z",
        "endDate": "2026-06-30T23:59:59.999Z"
      },
      "conversations": {
        "range": {
          "startDate": "2026-06-01T00:00:00.000Z",
          "endDate": "2026-06-30T23:59:59.999Z"
        },
        "freshness": {
          "source": "daily_aggregations",
          "lastUpdated": "2026-06-29T18:00:05.000Z",
          "expectedLagMinutes": 60
        },
        "summary": {
          "conversationCount": 340,
          "assistedConversationCount": 28,
          "assistanceRequestCount": 35,
          "autonomyRate": 91.76
        },
        "breakdown": {
          "dimension": "platform",
          "totals": [
            { "key": "whatsapp", "label": "WhatsApp", "value": 300 }
          ],
          "series": [
            { "date": "2026-06-29T12:00:00.000Z", "key": "whatsapp", "label": "WhatsApp", "value": 40 }
          ]
        }
      }
    }
  ],
  "workspacesCount": 1
}

Campos de la respuesta

Campo	Descripción
`id`	ID del workspace
`name`	Nombre del workspace
`billingPeriod`	Periodo de facturación activo del workspace
`conversations.range`	Rango efectivo de fechas evaluado
`conversations.summary.conversationCount`	Total de conversaciones
`conversations.summary.assistedConversationCount`	Conversaciones que requirieron asistencia humana
`conversations.summary.assistanceRequestCount`	Solicitudes de asistencia registradas
`conversations.summary.autonomyRate`	Porcentaje de conversaciones resueltas sin asistencia humana
`conversations.breakdown.dimension`	Dimensión del desglose aplicada
`conversations.breakdown.totals`	Totales por clave con `key`, `label` y `value`
`conversations.breakdown.series`	Serie diaria por clave del desglose
`conversations.freshness`	Última actualización y desfase esperado

Nota

Estas métricas se calculan desde agregados horarios, por lo que pueden tener hasta ~60 minutos de desfase. Revisa conversations.freshness para conocer la última actualización.

Anterior Mensajes de Uso Siguiente Actores de Uso