Mosend
MosendDeveloper

CRM

Referencia de 9 endpoints generados desde mosend-wb-backend/src/modules/crm/ia/crm-ia.controller.ts.

Base path: /organizations/:orgId/crm/ia·9 endpoints·Source: mosend-wb-backend/src/modules/crm/ia/crm-ia.controller.ts
POST/organizations/:orgId/crm/ia/segmentos/desde-texto
bearer

Convierte una descripción en palabras en el filtro de un segmento (lista inteligente) y dice cuántos contactos tiene. No lo guarda: para eso, POST …/contact-lists con smartFilter.

Path params

  • orgIdstringrequerido

Body (JSON)

  • textostringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/segmentos/desde-texto' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"texto": "<texto>"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/crm/ia/segmentos/sugeridos
bearer

Segmentos sugeridos listos para crear (con cuántos contactos tienen hoy) y los intereses más pedidos.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/segmentos/sugeridos' \
  -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/crm/ia/clientes/:contactId
bearer

Lo que la IA sabe del cliente: intención, intereses, objeción, sentimiento, resumen, próximo paso y sus últimas lecturas.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/clientes/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"
}
POST/organizations/:orgId/crm/ia/clientes/:contactId/analizar
bearer

Lee ya la conversación más reciente del cliente con la IA (sin esperar al analista) y aplica lo que corresponda.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/clientes/00000000-0000-0000-0000-000000000000/analizar' \
  -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"
}
POST/organizations/:orgId/crm/ia/clientes/:contactId/copiloto
bearer

Copiloto: resumen del cliente, siguiente paso, borrador del mensaje y, con la ventana de 24 h cerrada, la plantilla sugerida.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/clientes/00000000-0000-0000-0000-000000000000/copiloto' \
  -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"
}
POST/organizations/:orgId/crm/ia/oportunidades/:id/sugerencia/aplicar
bearer

Aplica lo que la IA sugirió para esta oportunidad (modo «sugerir»).

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/oportunidades/00000000-0000-0000-0000-000000000000/sugerencia/aplicar' \
  -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"
}
POST/organizations/:orgId/crm/ia/oportunidades/:id/sugerencia/descartar
bearer

Descarta la sugerencia de la IA para esta oportunidad.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/oportunidades/00000000-0000-0000-0000-000000000000/sugerencia/descartar' \
  -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/crm/ia/objeciones
bearer

«Por qué no compran»: objeciones, intereses con más freno, por asesor, intención y cuántos interesados terminaron comprando, en los últimos N días (7-365, 90 por defecto).

Path params

  • orgIdstringrequerido

Query params

  • diasstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/objeciones' \
  -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/crm/ia/pronostico
bearer

Pronóstico del embudo por defecto: oportunidades abiertas por mes de cierre esperado, con su valor y el ponderado por la probabilidad de la etapa.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/crm/ia/pronostico' \
  -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"
}