Actores de Uso

Devuelve el consumo de mensajes agrupado por actor: agentes automáticos, usuarios del workspace, contactos u otros buckets capturados por Platica.

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

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",
      "billingPeriod": {
        "startDate": "2026-06-01T00:00:00.000Z",
        "endDate": "2026-06-30T23:59:59.999Z"
      },
      "actors": {
        "range": {
          "startDate": "2026-06-01T00:00:00.000Z",
          "endDate": "2026-06-30T23:59:59.999Z"
        },
        "freshness": {
          "source": "daily_aggregations",
          "lastUpdated": "2026-06-29T18:31:10.000Z",
          "expectedLagSeconds": 30
        },
        "actorTypes": [
          { "actorType": "Agente IA / automático", "messages": 870 },
          { "actorType": "Usuarios del workspace", "messages": 80 }
        ],
        "workspaceUsers": [
          { "userId": "user_123", "email": "ana@example.com", "messages": 45 }
        ],
        "summary": {
          "totalMessages": 1200
        }
      }
    }
  ],
  "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
`actors.range`	Rango efectivo de fechas evaluado
`actors.actorTypes`	Mensajes por tipo de actor con `actorType` y `messages`
`actors.workspaceUsers`	Mensajes por usuario del workspace con `userId`, `email` y `messages`
`actors.summary.totalMessages`	Total de mensajes usados en el rango
`actors.freshness`	Última actualización y desfase esperado

Consejo

Usa este endpoint para detectar si el consumo viene principalmente de automatizaciones, usuarios humanos o campañas operadas manualmente.

Anterior Conversaciones de Uso Siguiente Introducción