Panel SMS

Usuarios Y Empleados

Gestión de empleados y usuarios de herramienta
Copiar para LLMVer como Markdown
Obtener Usuarios de Herramienta
POST /toolusers/get
Agregar Empleado
POST /employee/add
Deshabilitar Empleado
POST /employee/disable

Obtener Usuarios de Herramienta

POST https://api.smsmasivos.com.mx/toolusers/get
Lista todos los usuarios de herramienta/empleados de la cuenta
Copiar para LLMVer como 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": "Parámetros inválidos.",
  "status": 400,
  "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
typestringrequerido
Rol: cajero o gerente
employee_namestringrequerido
Nombre del empleado
business_namestringrequerido
Nombre del negocio/sucursal
numberstringrequerido
Número de teléfono (exactamente 10 dígitos)
passwordstringrequerido
Contraseña (máx. 50 caracteres)
Copiar para LLMVer como 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": "Parámetros inválidos.",
  "status": 400,
  "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
numberstringrequerido
Número de teléfono del empleado
Copiar para LLMVer como 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": "Parámetros inválidos.",
  "status": 400,
  "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"
}

Objeto de respuesta

Estructura de la respuesta que devuelven estos endpoints.

Atributos
successboolean
—
messagestring
Mensaje de estado
collaboratorIdinteger
ID del nuevo colaborador
statusinteger
—
codestring
Código de respuesta
Copiar para LLM
Objeto de respuesta
{
  "success": true,
  "message": "partner_created_successfully",
  "collaboratorId": 101,
  "status": 200,
  "code": "toolusers_01"
}