Mosend
MosendDeveloper

Reportes

Reportes agregados (volumen, tiempos, agentes, etiquetas).

Base path: /organizations/:orgId/reports·13 endpoints·Source: mosend-wb-backend/src/modules/reports/reports.controller.ts
GET/organizations/:orgId/reports/summary
bearer

Resumen general del dashboard de la organización.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/summary' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/portada
bearer

Portada del panel: qué espera ahora y cómo va la atención por día, con totales del período y del anterior.

Path params

  • orgIdstringrequerido

Query params

  • diasnumber
  • desdestring
  • hastastring

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/portada' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/ventas
bearer

Reporte de ventas de licencias: ingresos por día/semana/mes contra el período anterior, por medio de pago, por agente del bot y por asesor (vendió y cerró), productos, marcas, canales, anuncios de Click-to-WhatsApp (cada venta al último anuncio por el que llegó el cliente, dentro de 30 días), tiempos, horas pico, clientes nuevos y lo pendiente. Solo propietarios y administradores.

Path params

  • orgIdstringrequerido

Query params

  • desdestring

    Primer día (YYYY-MM-DD, en la zona horaria de la organización).

  • hastastring

    Último día, incluido.

  • agruparstring
    diasemanames
  • monedastring
  • perfilIdstring
  • phoneNumberIdstring
  • agentIdstring
  • userIdstring
  • productIdstring
  • anuncioIdstring

    Solo las ventas que llegaron por este anuncio (id de Anuncios).

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/ventas' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/channels-summary
bearer

Señal unificada de canales conectados (WhatsApp, Instagram, Web Chat) para onboarding y empty-states.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/channels-summary' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/messaging
bearer

Métricas de mensajería agregadas desde una fecha.

Path params

  • orgIdstringrequerido

Query params

  • sincestringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/messaging' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/billing
bearer

Resumen de facturación y consumo de la organización.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/billing' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/customers
bearer

Lista contactos con métricas agregadas de conversaciones (paginado).

Path params

  • orgIdstringrequerido

Query params

  • sincestringrequerido
  • untilstringrequerido
  • categorystringrequerido
  • resolutionOutcomestringrequerido
  • qstringrequerido
  • limitstringrequerido
  • cursorstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/customers' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/customers/:contactId
bearer

Detalle de un contacto con métricas históricas y timeline.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/customers/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/team/weekly
bearer

Métricas semanales del equipo (default últimas 12 semanas).

Path params

  • orgIdstringrequerido

Query params

  • weeksstringrequerido
  • comparestringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/team/weekly' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/team/series
bearer

Serie del equipo por día/semana/mes en un rango, con comparación, canal/etiqueta y SLA.

Path params

  • orgIdstringrequerido

Query params

  • fromstringrequerido
  • tostringrequerido
  • granularitystringrequerido
  • comparestringrequerido
  • channelstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/team/series' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/team/by-agent
bearer

Métricas por agente para un período (default últimas 4 semanas).

Path params

  • orgIdstringrequerido

Query params

  • sincestringrequerido
  • untilstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/team/by-agent' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/reports/team/goals
bearer

Metas semanales del equipo (volúmenes y tasas).

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/team/goals' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/reports/team/goals
bearer

Actualiza metas semanales del equipo (parcial).

Path params

  • orgIdstringrequerido

Body (JSON)

  • weeklyConversationsCreatednumber
  • weeklyConversationsClosednumber
  • weeklyMessagesOutnumber
  • closureRateTargetnumber
  • resolutionRateTargetnumber

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/reports/team/goals' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"weeklyConversationsCreated": 0,"weeklyConversationsClosed": 0,"weeklyMessagesOut": 0,"closureRateTarget": 0,"resolutionRateTarget": 0}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}