smsctl 1.0.0

smsctl is a CLI for streamlined SMS management. It provides commands for managing projects, devices, tasks, groups, and chat records, letting you send, receive, and track SMS from one place. Designed for flexible workflows, it handles everything from bulk tasks to conversation monitoring.

smsctl

smsctl is a command-line tool designed for managing and automating SMS tasks, devices, projects, groups, chat/conversation records, and more. The CLI is flexible, allowing for quick integration into your workflows.

Features

• Management For Device: List and allocate devices to projects or groups, register new devices, etc.
• Management For Project & Group: Create, list, update, or delete projects and groups.
• Management For Task: Create, list, upload/download task files, and manage SMS record history.
• Management For Conversation: View, list, and reply to chat logs across different projects.

Installation

Install smsctl from PyPI using:

pip install smsctl

Below is a revised Installation section with the function reference but without showing its full implementation details:

However, before using the CLI for the first time, you should configure the base URL endpoint by running:

smsctl config --url "https://your-custom-endpoint.com/api/v1/"

This command will store the service endpoint URL in a local JSON configuration file, ensuring smsctl knows where to send requests.

Configuration saved with URL: https://your-custom-endpoint.com/api/v1/

Now you’re all set to use smsctl. To see the list of available commands and options:

smsctl --help This will provide the smsctl command-line interface.

Usage: smscli [OPTIONS] COMMAND [ARGS]...

  sms_cli

Options:
  --help  Show this message and exit.

Commands:
  allocate-device-to-group    Allocates a device to a specific group.
  allocate-device-to-project  Allocates a device to a specific project.
   config                     Configures the SMS CLI by storing the...
  create-group                Creates a new group for a specific sub-user...
  create-project              Creates a new project.
  create-task                 Creates a new task for a sub-user.
  delete-group                delete-group
  delete-project              delete-project
  delete-task                 delete-task
  download-task               Downloads the file associated with a...
  fetch-device-task           fetch-device-task
  list-chats                  Retrieves and displays a list of...
  list-device                 Lists all devices associated with the main...
  list-groups                 Lists all groups associated with the main...
  list-project                Lists all projects associated with the main...
  list-task-record            Lists SMS records for the main user.
  list-tasks                  Lists all tasks associated with the main user.
  register-device             register-device
  reply-chat                  Sends a reply to a specific chat log.
  report-receive-content      report-receive-content
  report-task-result          report-task-result
  sub-list-chats              Retrieves and displays a list of...
  sub-list-device             Lists all devices associated with a...
  sub-list-task-record        Lists SMS records for a specific sub-user.
  sub-list-tasks              Lists all tasks associated with a specific...
  update-group                update-group
  update-projec               update-project
  view-chat                   Retrieves and displays the details of a...

Quick Usage

After installation, run:

smsctl --help

This displays available commands and options. You can also check individual commands:

smsctl <command> --help

For example:

smsctl list-device --help

Command Overview (Tables)

Below are summary tables of the smsctl commands grouped by functionality.

Refer to Commands in Detail for a more comprehensive breakdown.

Device Commands

Command	Description	Key Options
list-device	Lists all devices (main user)	--page (default 1)
sub-list-device	Lists devices for a sub-user	--sub-user-id, --page
register-device	Registers a new device	(No parameters yet.)
fetch-device-task	Fetches tasks assigned to a device	(No parameters yet.)
report-task-result	Reports results of a device task	(No parameters yet.)
report-receive-content	Reports received content (e.g., incoming SMS)	(No parameters yet.)

Project Commands

Command	Description	Key Options
list-project	Lists all projects	--page (default 1)
create-project	Creates a new project	--project-name, --note
delete-project	Deletes a project	(No parameters yet.)
update-project	Updates a project	(No parameters yet.)
allocate-device-to-project	Allocates a device to a project	--device-id, --project-id

Task Commands

Command	Description	Key Options
create-task	Creates a new task (sub-user context)	--sub-user-id, --file, --task-name, --group-id, --interval-time, --timing-start-time
delete-task	Deletes a task	(No parameters yet.)
list-tasks	Lists tasks for the main user	--page (default 1)
sub-list-tasks	Lists tasks for a specific sub-user	--sub-user-id, --page
download-task	Downloads a task’s file by filename	--file-name
list-task-record	Lists SMS records for the main user	--page (default 1)
sub-list-task-record	Lists SMS records for a specific sub-user	--sub-user-id, --page

Group Commands

Command	Description	Key Options
list-groups	Lists all groups for a sub-user	--sub-user-id
create-group	Creates a new group in a specific project (sub-user context)	--sub-user-id, --project-id, --group-name
allocate-device-to-group	Allocates a device to a group (sub-user context)	--sub-user-id, --group-id, --device-id
update-group	Updates an existing group	(No parameters yet.)
delete-group	Deletes an existing group	(No parameters yet.)

Chat Commands

Command	Description	Key Options
list-chats	Lists conversation records for a project	--project-id, --page (default 1)
sub-list-chats	Lists conversation records for a sub-user in a project	--project-id, --sub-user-id, --page (default 1)
view-chat	Views a specific chat log	--chat-log-id
reply-chat	Replies to a specific chat log	--chat-log-id, --text

Commands in Detail

Below, you’ll find more detailed usage information for each command. Use the --help option to see all parameters and their defaults.

Device Commands

list-device

smsctl list-device [OPTIONS]

Options:  
•   -p, --page: Page number for the listing. Defaults to 1.

list-device

smsctl sub-list-device --sub-user-id <SUB_USER_ID> [OPTIONS]

Options:
•	-p, --page: Page number (default: 1).
•	-sub-user-id, --sub-user-id: Required. ID of the sub-user.

register-device

smsctl register-device

•	(Placeholder - no options yet.)

fetch-device-task

smsctl fetch-device-task

•	(Placeholder - no options yet.)

report-task-result

smsctl report-task-result

•	(Placeholder - no options yet.)

report-receive-content

smsctl report-receive-content

•	(Placeholder - no options yet.)

Project Commands

list-project

smsctl list-project [OPTIONS]

Options:
•	-p, --page: Page number (default: 1).

create-project

smsctl create-project --project-name <NAME> [OPTIONS]

Options:
•	-project-name, --project-name: Required. Name of the project.
•	-note, --note: Optional note (default: Create By (sms cli)).

delete-project

smsctl delete-project

•	(Placeholder - no options yet.)

update-project

smsctl update-project

•	(Placeholder - no options yet.)

allocate-device-to-project

smsctl allocate-device-to-project --device-id <DEVICE_ID> --project-id <PROJECT_ID>

Options:
•	-device-id, --device-id: Required. The device ID.
•	-project-id, --project-id: Required. The project ID.

Task Commands

create-task

smsctl create-task \
  --sub-user-id <SUB_USER_ID> \
  --file <FILE_PATH> \
  --task-name <TASK_NAME> \
  --group-id <GROUP_ID> \
  [OPTIONS]

Options:
•	-sub-user-id, --sub-user-id: Required. Sub-user ID.
•	-f, --file: Required. Path to the file for the task.
•	-task-name, --task-name: Required. Name of the task.
•	-group-id, --group-id: Required. Group ID for the task.
•	-interval-time, --interval-time: Interval in seconds (default: 1).
•	-timing-start-time, --timing-start-time: Start time (default: current time).

delete-task

smsctl delete-task

•	(Placeholder - no options yet.)

list-tasks

smsctl list-tasks [OPTIONS]

Options:
•	-p, --page: Page number (default: 1).

sub-list-tasks

smsctl sub-list-tasks --sub-user-id <SUB_USER_ID> [OPTIONS]

Options:
•	-p, --page: Page number (default: 1).
•	-sub-user-id, --sub-user-id: Required.

download-task

smsctl download-task --file-name <FILE_NAME>

Options:
•	-file-name, --file-name: Required. The name of the task file to download.

list-task-record

smsctl list-task-record [OPTIONS]

•	Options:
•	-p, --page: Page number (default: 1).

sub-list-task-record

smsctl sub-list-task-record --sub-user-id <SUB_USER_ID> [OPTIONS]

Options:
•	-p, --page: Page number (default: 1).
•	-sub-user-id, --sub-user-id: Required.

Group Commands

list-groups

smsctl list-groups --sub-user-id <SUB_USER_ID>

Options:
•	-sub-user-id, --sub-user-id: Required.

create-group

smsctl create-group \
  --sub-user-id <SUB_USER_ID> \
  --project-id <PROJECT_ID> \
  --group-name <GROUP_NAME>

Options:
•	-sub-user-id, --sub-user-id: Required.
•	-project-id, --project-id: Required.
•	-group-name, --group-name: Required.

allocate-device-to-group

smsctl allocate-device-to-group \
  --sub-user-id <SUB_USER_ID> \
  --group-id <GROUP_ID> \
  --device-id <DEVICE_ID>

Options:
•	-sub-user-id, --sub-user-id: Required.
•	-group-id, --group-id: Required.
•	-device-id, --device-id: Required.

update-group

smsctl update-group

•	(Placeholder - no options yet.)

delete-group

smsctl delete-group

•	(Placeholder - no options yet.)

Chat Commands

list-chats

smsctl list-chats --project-id <PROJECT_ID> [OPTIONS]

Options:
•	-project-id, --project-id: Required.
•	-p, --page: Page number (default: 1).

sub-list-chats

smsctl sub-list-chats --project-id <PROJECT_ID> --sub-user-id <SUB_USER_ID> [OPTIONS]

Options:
•	-project-id, --project-id: Required.
•	-sub-user-id, --sub-user-id: Required.
•	-p, --page: Page number (default: 1).

view-chat

smsctl view-chat --chat-log-id <CHAT_LOG_ID>

Options:
•	-chat-log-id, --chat-log-id: Required.

reply-chat

smsctl reply-chat --chat-log-id <CHAT_LOG_ID> --text <REPLY_TEXT>

Options:
•	-chat-log-id, --chat-log-id: Required.
•	-text, --text: Required.

Examples

List all devices on page 2:

smsctl list-device --page 2

Create a new project:

smsctl create-project --project-name "MyNewProject"

Allocate device 101 to project 10:

smsctl allocate-device-to-project --device-id 101 --project-id 10

Create a new task:

smsctl create-task \
  --sub-user-id 5 \
  --file /path/to/tasks/data.json \
  --task-name "BulkSMS" \
  --group-id 42 \
  --interval-time 5 \
  --timing-start-time 1672531200

Reply to chat log #200:

smsctl reply-chat --chat-log-id 200 --text "Thanks for your message!"

Contributing

• Fork the repository.
• Create a feature branch:

git checkout -b feature/awesome-feature

• Commit your changes:

git commit -am "Add new feature"

• Push to your branch:

git push origin feature/awesome-feature

• Create a Pull Request.

All contributions (issues, PRs, feature requests) are welcome!

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact
• GitHub Issues: Open an Issue
• Email: [e-mail]

Thank you for using smsctl!