Usuarios Y Empleados

Gestión de empleados y usuarios de herramienta

Copy for LLM View as Markdown

Obtener Usuarios de Herramienta

POST /toolusers/get

Agregar Empleado

POST /employee/add

Deshabilitar Empleado

POST /employee/disable

The Usuarios Y Empleado object

Returned by the usuarios y empleados endpoints.

Attributes

successboolean

—

messagestring

Mensaje de estado

collaboratorIdinteger

ID del nuevo colaborador

statusinteger

—

codestring

Código de respuesta

Copy for LLM

The Usuarios Y Empleado object

{
  "success": true,
  "message": "partner_created_successfully",
  "collaboratorId": 101,
  "status": 200,
  "code": "toolusers_01"
}

Obtener Usuarios de Herramienta

POST https://api.smsmasivos.com.mx/toolusers/get

Lista todos los usuarios de herramienta/empleados de la cuenta

Copy for LLM View as Markdown

curl https://api.smsmasivos.com.mx/toolusers/get

const Usuarios y Empleado = await sms.usuariosyempleados.create()

Usuarios y Empleado = sms.usuariosyempleados.create()

Usuarios y Empleado, err := client.Usuariosyempleados.Create(ctx, nil)

Response

{
  "success": true,
  "result": [
    {
      "usertool_id": 0,
      "usertool_name": "<string>",
      "usertool_number": "<string>",
      "usertool_branch": "<string>",
      "usertool_type": "<string>",
      "usertool_status": "<string>"
    }
  ],
  "code": "tool_users_01"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "<string>"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "auth_05"
}

{
  "success": false,
  "message": "La dirección IP no está autorizada para acceder.",
  "status": 403,
  "code": "auth_04"
}

{
  "success": false,
  "message": "Demasiadas solicitudes. Límite: 100 mensajes/segundo (producción) o 100/día (sandbox).",
  "status": 429,
  "code": "rate_01"
}

{
  "success": false,
  "message": "Error interno del servidor. Contacta a soporte con el request_id.",
  "status": 500,
  "code": "server_01",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Agregar Empleado

POST https://api.smsmasivos.com.mx/employee/add

Registra un nuevo usuario de herramienta/empleado. Valida contraseña única, nombre de usuario y teléfono

Parameters

typestringrequired

Rol: 'cajero' o 'gerente'

employee_namestringrequired

Nombre del empleado

business_namestringrequired

Nombre del negocio/sucursal

numberstringrequired

Número de teléfono (exactamente 10 dígitos)

passwordstringrequired

Contraseña (máx. 50 caracteres)

Copy for LLM View as Markdown

curl https://api.smsmasivos.com.mx/employee/add \
  -d type=value \
  -d employee_name=value \
  -d business_name=value \
  -d number=value

const Usuarios y Empleado = await sms.usuariosyempleados.create({
  type: 'value',
  employee_name: 'value',
  business_name: 'value',
  number: 'value',
})

Usuarios y Empleado = sms.usuariosyempleados.create(
    type="value",
    employee_name="value",
    business_name="value",
    number="value",
)

Usuarios y Empleado, err := client.Usuariosyempleados.Create(ctx, &sms.UsuariosYEmpleadoParams{
    Type: sms.String("value"),
    EmployeeName: sms.String("value"),
    BusinessName: sms.String("value"),
    Number: sms.String("value"),
})

Response

{
  "success": true,
  "message": "partner_created_successfully",
  "collaboratorId": 101,
  "status": 200,
  "code": "toolusers_01"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "<string>"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "auth_05"
}

{
  "success": false,
  "message": "La dirección IP no está autorizada para acceder.",
  "status": 403,
  "code": "auth_04"
}

{
  "success": false,
  "message": "Demasiadas solicitudes. Límite: 100 mensajes/segundo (producción) o 100/día (sandbox).",
  "status": 429,
  "code": "rate_01"
}

{
  "success": false,
  "message": "Error interno del servidor. Contacta a soporte con el request_id.",
  "status": 500,
  "code": "server_01",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Deshabilitar Empleado

POST https://api.smsmasivos.com.mx/employee/disable

Deshabilita un usuario de herramienta/empleado por número de teléfono

Parameters

numberstringrequired

Número de teléfono del empleado

Copy for LLM View as Markdown

curl https://api.smsmasivos.com.mx/employee/disable \
  -d number=value

const Usuarios y Empleado = await sms.usuariosyempleados.create({
  number: 'value',
})

Usuarios y Empleado = sms.usuariosyempleados.create(
    number="value",
)

Usuarios y Empleado, err := client.Usuariosyempleados.Create(ctx, &sms.UsuariosYEmpleadoParams{
    Number: sms.String("value"),
})

Response

{
  "success": true,
  "message": "partner_disabled",
  "status": 200,
  "code": "toolusers_01"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "<string>"
}

{
  "success": false,
  "message": "API Key inválida o no existe.",
  "status": 401,
  "code": "auth_05"
}

{
  "success": false,
  "message": "La dirección IP no está autorizada para acceder.",
  "status": 403,
  "code": "auth_04"
}

{
  "success": false,
  "message": "Demasiadas solicitudes. Límite: 100 mensajes/segundo (producción) o 100/día (sandbox).",
  "status": 429,
  "code": "rate_01"
}

{
  "success": false,
  "message": "Error interno del servidor. Contacta a soporte con el request_id.",
  "status": 500,
  "code": "server_01",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}