Mosend
MosendDeveloper

Bot · Agentes

Referencia de 8 endpoints generados desde mosend-wb-backend/src/modules/bot/bot-agents/bot-agents.controller.ts.

Base path: /organizations/:orgId/bot/agents·8 endpoints·Source: mosend-wb-backend/src/modules/bot/bot-agents/bot-agents.controller.ts
GET/organizations/:orgId/bot/agents/capabilities
bearer

Catálogo de capacidades activables por agente (para la UI).

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents/capabilities' \
  -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/bot/agents/modelos
bearer

Proveedores de IA con sus modelos elegibles y si tienen clave configurada.

Path params

  • orgIdstringrequerido

Respuestas

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

Lista los agentes de bot de la organización.

Path params

  • orgIdstringrequerido

Query params

  • phoneNumberIdstringrequerido

Respuestas

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

Crea un agente de bot.

Path params

  • orgIdstringrequerido

Body (JSON)

  • phoneNumberIdsstring[]

    Canales (ids de número, reales o virtuales de web chat / Instagram) en los que atiende el agente. Vacío = todos los canales de la organización.

  • knowledgeDocIdsstring[]

    Documentos de la memoria que este agente consulta (ids). Vacío = toda la biblioteca.

  • phoneNumberIdstring · uuid

    Atajo legado de un solo canal; usa phoneNumberIds.

  • namestringrequerido
  • descriptionstring
  • isDefaultboolean
  • enabledboolean
  • sortOrdernumber
  • providerstring
    anthropicopenaiopenroutergroqmeta
  • modelstring
  • systemPromptstring
  • temperaturenumber
  • maxTokensnumber
  • enabledToolsstring[]
  • interactiveMessagesboolean

    «Botones y listas». Apagado, el agente no manda botones, listas ni botón de enlace: las opciones y los enlaces van en el texto. Por defecto encendido.

  • enabledCapabilitiesstring[]
  • routeTagsstring[]
  • knowledgeTagsstring[]
  • knowledgeTopKnumber
  • knowledgeMinSimilaritynumber

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"phoneNumberIds": [],"knowledgeDocIds": [],"phoneNumberId": "00000000-0000-0000-0000-000000000000","name": "<name>","description": "<description>","isDefault": true,"enabled": true,"sortOrder": 0,"provider": "anthropic","model": "<model>","systemPrompt": "<systemPrompt>","temperature": 0,"maxTokens": 0,"enabledTools": [],"interactiveMessages": true,"enabledCapabilities": [],"routeTags": [],"knowledgeTags": [],"knowledgeTopK": 0,"knowledgeMinSimilarity": 0}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "cliente-vip",
    "color": "#16a34a"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/bot/agents/stats
bearer

Rendimiento por agente (conversaciones, respuestas, traspasos, escalamientos, ventas, citas, fallos, costo) en los últimos N días.

Path params

  • orgIdstringrequerido

Query params

  • diasstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents/stats' \
  -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/bot/agents/:id
bearer

Detalle de un agente.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents/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"
}
PATCH/organizations/:orgId/bot/agents/:id
bearer

Actualiza un agente.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Body (JSON)

  • phoneNumberIdsstring[]

    Canales (ids de número, reales o virtuales de web chat / Instagram) en los que atiende el agente. Vacío = todos los canales de la organización.

  • knowledgeDocIdsstring[]

    Documentos de la memoria que este agente consulta (ids). Vacío = toda la biblioteca.

  • phoneNumberIdstring · uuid

    Atajo legado de un solo canal; usa phoneNumberIds.

  • namestring
  • descriptionstring
  • isDefaultboolean
  • enabledboolean
  • sortOrdernumber
  • providerstring
    anthropicopenaiopenroutergroqmeta
  • modelstring
  • systemPromptstring
  • temperaturenumber
  • maxTokensnumber
  • enabledToolsstring[]
  • interactiveMessagesboolean

    «Botones y listas». Apagado, el agente no manda botones, listas ni botón de enlace: las opciones y los enlaces van en el texto. Por defecto encendido.

  • enabledCapabilitiesstring[]
  • routeTagsstring[]
  • knowledgeTagsstring[]
  • knowledgeTopKnumber
  • knowledgeMinSimilaritynumber

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"phoneNumberIds": [],"knowledgeDocIds": [],"phoneNumberId": "00000000-0000-0000-0000-000000000000","name": "<name>","description": "<description>","isDefault": true,"enabled": true,"sortOrder": 0,"provider": "anthropic","model": "<model>","systemPrompt": "<systemPrompt>","temperature": 0,"maxTokens": 0,"enabledTools": [],"interactiveMessages": true,"enabledCapabilities": [],"routeTags": [],"knowledgeTags": [],"knowledgeTopK": 0,"knowledgeMinSimilarity": 0}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "cliente-vip",
    "color": "#16a34a"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
DELETE/organizations/:orgId/bot/agents/:id
bearer

Elimina un agente.

Path params

  • orgIdstringrequerido
  • idstringrequerido

Respuestas

  • 200
curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/bot/agents/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"
}