Contacts

Conteos reales por bandeja (total, estado, asignación, canal)

Acepta los mismos filtros que GET /contacts y devuelve conteos facetados: cada bloque se calcula con todos los filtros activos menos el suyo. Con assigned_to=42, los cinco contadores de estado cuentan los chats de esa persona; con status=open, los de asesor cuentan solo los abiertos. El bloque que se aplicara su propio filtro daría 0 en todas las demás opciones y no habría cómo volver.

scopeTotal es aparte: el universo de la carpeta (asesor/grupo/canal) sin estado, búsqueda ni filtro avanzado — el denominador de "viendo N de M".

quick trae los números de los chips rápidos (all, open, unread, human, autopilot), calculados con todos los filtros activos menos el propio quick.

Sin parámetros devuelve los totales del workspace, igual que siempre.

get/contacts/counts

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/contacts/counts
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Query parameters

quick'open' | 'unread' | 'human' | 'autopilot'

Chip rápido de la bandeja. open = no cerrados (estado distinto de finished y archived; sin estado cuenta como abierto, y si mandas status ese manda), unread = con mensajes sin leer, human = human_requested (manda sobre status), autopilot = piloto encendido.

filtersstring

Filtro avanzado: JSON array de condiciones { field, op, value }, combinadas con AND.

autopilotboolean

Piloto automático encendido o apagado.

unansweredboolean

true = conversaciones pendientes de respuesta humana, aunque el bot haya respondido o el chat se haya leído.

unreadboolean

true = solo los que tienen mensajes sin leer.

tagstring

Etiqueta del contacto.

agent_groupstring

Id del grupo de atención, o none para los que no tienen.

assigned_tostring

Id del asesor asignado, o unassigned.

status'open' | 'pending' | 'human_requested' | 'finished' | 'archived'

Estado del chat.

channel_idstring

Canal de origen.

searchstring

Alias de q. Si mandas los dos, gana q.

qstring

Búsqueda por nombre, teléfono, email o identificador.

Response

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "archived": 25,
    "byChannel": {
      "WhatsApp Ventas": 812
    },
    "byGroup": {
      "3": 120
    },
    "byLine": {
      "109384756": 240
    },
    "byUser": {
      "42": 18
    },
    "channels": [
      {
        "id": 5,
        "name": "WhatsApp Ventas",
        "type": "whatsapp"
      }
    ],
    "finished": 900,
    "human_requested": 7,
    "lines": [
      {
        "account_id": "9d0e6f1a-2b3c-4d5e-8f90-1a2b3c4d5e6f",
        "account_name": "Cuenta principal",
        "channel_id": 5,
        "line_id": "109384756",
        "name": "Ventas Bogotá"
      }
    ],
    "mine": 18,
    "open": 312,
    "pending": 40,
    "quick": {
      "all": 128,
      "autopilot": 30,
      "human": 3,
      "open": 42,
      "unread": 7
    },
    "scopeTotal": 164,
    "total": 1284,
    "unassigned": 96
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.