Mosend
MosendDeveloper

Conectores

Referencia de 10 endpoints generados desde mosend-wb-backend/src/modules/conectores/conectores.controller.ts.

Base path: /organizations/:orgId/conectores·10 endpoints·Source: mosend-wb-backend/src/modules/conectores/conectores.controller.ts
GET/organizations/:orgId/conectores/aprobaciones
bearer

Solicitudes de acciones sensibles esperando aprobación de una persona.

Path params

  • orgIdstringrequerido

Respuestas

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

Aprueba y EJECUTA una acción sensible; el cliente recibe aviso en su chat.

Path params

  • orgIdstringrequerido
  • accionIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores/aprobaciones/00000000-0000-0000-0000-000000000000/aprobar' \
  -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/conectores/aprobaciones/:accionId/rechazar
bearer

Rechaza una acción sensible; el cliente recibe aviso y espera a un asesor.

Path params

  • orgIdstringrequerido
  • accionIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores/aprobaciones/00000000-0000-0000-0000-000000000000/rechazar' \
  -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/conectores
bearer

Lista los conectores de la organización.

Path params

  • orgIdstringrequerido

Respuestas

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

Crea un conector (credenciales cifradas).

Path params

  • orgIdstringrequerido

Body (JSON)

  • typestringrequerido
    WHMCSPLESKCPANELWORDPRESSWOOCOMMERCEHTTP
  • namestringrequerido
  • baseUrlstringrequerido
  • authIdstring

    Identifier de la API Credential de WHMCS (permisos mínimos de lectura).

  • authSecretstring
  • enabledboolean
  • enabledActionsstring[]
  • paymentInstructionsstring

    Cómo pagar una factura de este sistema; el bot lo manda con la factura pendiente.

  • paymentGatewaystring

    WHMCS: método de pago (nombre de sistema, p. ej. banktransfer) con el que el bot registra transferencias.

  • customActionsobject[]

    Solo type HTTP: acciones curadas por el dueño (el servicio las valida).

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"type": "WHMCS","name": "<name>","baseUrl": "https://tu-app.com/endpoint","authId": "00000000-0000-0000-0000-000000000000","authSecret": "<authSecret>","enabled": true,"enabledActions": [],"paymentInstructions": "<paymentInstructions>","paymentGateway": "<paymentGateway>","customActions": []}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
PATCH/organizations/:orgId/conectores/:conectorId
bearer

Actualiza un conector.

Path params

  • orgIdstringrequerido
  • conectorIdstringrequerido

Body (JSON)

  • namestring
  • baseUrlstring
  • authIdstring

    Cadena vacía = borrar la credencial guardada.

  • authSecretstring
  • enabledboolean
  • enabledActionsstring[]
  • paymentInstructionsstring

    Cómo pagar una factura de este sistema; el bot lo manda con la factura pendiente.

  • paymentGatewaystring

    WHMCS: método de pago (nombre de sistema, p. ej. banktransfer) con el que el bot registra transferencias.

  • customActionsobject[]

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "<name>","baseUrl": "https://tu-app.com/endpoint","authId": "00000000-0000-0000-0000-000000000000","authSecret": "<authSecret>","enabled": true,"enabledActions": [],"paymentInstructions": "<paymentInstructions>","paymentGateway": "<paymentGateway>","customActions": []}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
DELETE/organizations/:orgId/conectores/:conectorId
bearer

Elimina un conector y sus credenciales.

Path params

  • orgIdstringrequerido
  • conectorIdstringrequerido

Respuestas

  • 200
curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores/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/conectores/:conectorId/probar
bearer

Prueba la conexión con una llamada de lectura inocua.

Path params

  • orgIdstringrequerido
  • conectorIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/conectores/00000000-0000-0000-0000-000000000000/probar' \
  -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/conectores/:conectorId/ejecutar
bearer

Ejecuta una acción de LECTURA del catálogo (fase 1: solo lectura).

Path params

  • orgIdstringrequerido
  • conectorIdstringrequerido

Body (JSON)

  • actionKeystringrequerido
  • paramsobject

    Parámetros de la acción; el servidor valida contra el catálogo.

Respuestas

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