SMS

Credit balance

—

Not available in "log" mode

Sent today

Sent this month

0 SMS parts charged

Failed (30 days)

Safe mode — nothing is actually being sent.

Messages are written to storage/logs/laravel.log instead. To go live set SMS_ENABLED=true and SMS_DRIVER=bulksmsbd in .env.

SMS gateway

Everything here can be set from this screen rather than a config file, so the shop can be handed over without touching the code. Log writes messages to the application log and sends nothing — use it while setting up so you never spend credits by accident.

Send SMS Off means nothing is sent, whatever the templates say.

Gateway Pick Custom for Alpha SMS, MIM, SSL Wireless, Reve or any other provider — they all take the same four values under different names. Sender ID The approved masking or non-masking id from your provider. API key Leave blank to keep the saved one. Send URL Balance URL (optional)

Field names

Only needed for a custom gateway. Every provider sends the same four things but calls them different names — check their API document and copy the parameter names in here. The defaults match bulksmsbd.

API key field Sender id field Number field Message field

Request method

Currently sending through

Gateway: log
API key: Set
Sender ID: 8809617614424
Sends as: POST api_key, senderid, number, message

Each event below can be switched on separately. Only turn on the ones worth paying for — Order placed and Order shipped are the two customers care about most. A message containing any Bangla character becomes Unicode, which cuts one SMS part from 160 to 70 characters.

Order placed Dear {name}, we received your order {order} ({total}). We will call you shortly to confirm... 1 part(s) Off

Sent the moment a customer completes checkout.

Send this message

Order confirmed Dear {name}, your order {order} is confirmed and is being prepared. Total {total}. - {bran... 1 part(s) Off

Sent when you confirm the order after the verification call.

Send this message

Order processing Dear {name}, we are packing your order {order} now. You will get the courier details soon.... 1 part(s) Off

Sent when you start packing the parcel.

Send this message

Order shipped Dear {name}, your order {order} has been shipped via {courier}. Tracking: {tracking}. Plea... 1 part(s) Off

Sent when the parcel is handed to the courier.

Send this message

Order delivered Dear {name}, your order {order} has been delivered. Thank you for shopping with {brand}! A... 1 part(s) Off

Sent when the parcel reaches the customer.

Send this message

Order cancelled Dear {name}, your order {order} has been cancelled. For any question please call {phone}.... 1 part(s) Off

Sent when an order is cancelled.

Send this message

OTP / verification code Your {brand} OTP is {otp}. It is valid for 5 minutes. Do not share this code with anyone. 1 part(s) On

Must contain {otp}. Keep the "Your {brand} OTP is XXXX" wording the gateway expects.

Send this message

New order alert (to you) New order {order} from {name} ({phone}) worth {total}, {items} item(s). - {brand} 1 part(s) Off

Sent to the shop owner’s number whenever an order comes in.

Send this message

Preferences

Text me when an order comes in Uses the “New order alert” template.

Your alert number

Leave empty to use the shop contact number.

Currency word in messages

Printed after the amount, as in “1,890 Tk”. Avoid the ৳ sign — it forces the whole message into Unicode and cuts 160 characters to 70, so every text costs more than double.

Let customers sign in with an OTP Adds a “Sign in with mobile number” option. A new number creates an account automatically.

OTP rules

Code length: 4 digits
Valid for: 5 minutes
Resend cool-down: 60 seconds
Wrong attempts allowed: 5
Codes per number per hour: 5

Change these with the SMS_OTP_* keys in .env.

Endpoints in use

Send: http://bulksmsbd.net/api/smsapi
Balance: http://bulksmsbd.net/api/getBalanceApi
Sender ID: 8809617614424
API key: Baxv••••••••••••hvRG

Numbers are sent as 8801XXXXXXXXX; the app converts whatever format you or the customer typed.

Gateway response codes

202	SMS submitted successfully
1001	Invalid number
1002	Sender ID is not correct or is disabled
1003	Required fields missing — contact your system administrator
1005	Internal error at the gateway
1006	Balance validity not available
1007	Insufficient balance — please top up
1011	User ID not found
1012	Masking SMS must be sent in Bengali
1013	Sender ID has no gateway for this API key
1014	Sender type name not found for this sender ID
1015	Sender ID has no valid gateway for this API key
1016	Active price info not found for this sender ID
1017	Price info not found for this sender ID
1018	The owner of this account is disabled
1019	The price of this account is disabled
1020	The parent of this account was not found
1021	The parent active price of this account was not found
1031	Your account is not verified — contact the administrator
1032	IP not whitelisted

SMS gateway

Field names

Currently sending through

Preferences

Send a test message

OTP rules

Last 8 messages

Nothing sent yet

Endpoints in use

Gateway response codes