Skip to main content
Version: 2.0.0

Profi SMS

Profi SMS connects your store to the profisms.cz SMS gateway and sends transactional SMS messages for order status changes and Booking Hub reservation reminders. Every outgoing message is logged so admins can see what was sent and whether it succeeded, and a CP dashboard summarizes send volume and failures.

Admin use cases​

  • Order status SMS — automatically text the customer when their order status changes (e.g. "shipped", "on hold"), with a separate message per status.
  • Booking reminders — send SMS reminders for Booking Hub reservations, with dynamic placeholders for the event name, date, time range, and store address.
  • Admin copy / oversight — configure an admin notification number that receives a copy of every outgoing SMS, so staff can monitor delivery without checking the log directly.
  • Delivery monitoring — the CP Dashboard shows sent/failed counts for the selected period, an all-time total, a success rate, a daily volume chart, and a list of recent failures.
  • Manual testing — send a one-off test SMS, or a test using the real order-status/booking-reminder message text, directly from the Settings page before enabling the feature for real customers.
  • Account balance — the Settings page shows the current credit balance on the profisms.cz account, so admins can top up before it runs out.

How it works​

  1. An order's status changes, or a Booking Hub reservation reminder fires.
  2. If the corresponding setting is enabled and a message is configured for that status/reservation type, Profi SMS builds the message text (replacing {event}, {start_date}, {time_range}, {address} for booking reminders) and sends it through the profisms.cz API.
  3. Recipient numbers are normalized to E.164 with an SK (Slovakia) prefix before sending.
  4. The send attempt is written to the SMS log with the recipient number(s), message text, and success/failure status. Failures also write an activity log entry with the API error code and message.
  5. For order status SMS, a note is also added to the order's comment history ("An SMS was sent to {number}.") so the notification is visible in context.
  6. If an admin notification number is configured, every outgoing message is copied to it as well (in addition to the customer's number).

Example: order status notification​

An admin wants customers to get an SMS the moment their order is marked "shipped":

  1. Open Settings -> Plugins -> Profi SMS, switch to the API Credentials tab and enter the Username, API Password, and API URL received from profisms.cz. Enable the plugin in the details panel on the right.
  2. Switch to the Order Notifications tab on the Profi SMS settings page, enable Send SMS, and enter the message text for the "Shipped" status.
  3. Save. From then on, every order that transitions to "shipped" triggers an SMS to the order's shipping phone number.
  4. To verify before going live, go to Settings -> Plugins -> Profi SMS -> Testing, pick "Shipped" under Order status testing, and send a test SMS to your own number using the exact configured message.
  5. Check the Profi SMS Dashboard to confirm the message shows up under SMS sent and in the volume chart; if it failed, it appears under Recent failures.

Example: booking reminder​

  1. Install and configure Booking Hub, and make sure reservations have a phone number.
  2. Open Booking Hub -> Settings -> Reminders, enable Send SMS under the Profi SMS section, and enter the reminder message text for the "Event" reminder type. You can use {event}, {start_date}, {time_range}, and {address} in the text — they're replaced with the reservation's actual details when the reminder is sent.
  3. When Booking Hub fires its reservation reminder, Profi SMS automatically sends the configured message to the reservation's phone number.

Requirements​

  • A profisms.cz account and API credentials (username, password, API URL) — see the profisms.cz documentation.
  • For order status SMS: the Craft store checkout/orders plugin (yui/craft) must be installed.
  • For booking reminders: the Booking Hub plugin (yui/booking-hub) must be installed.
  • Optional: the yui/mcp plugin, to expose the SMS-sending tool to AI agents.

See Settings for configuration and Developer API for MCP tools, events, and the PHP service API.