logotype
02175424
تماس با ما
logotype
02175424
تماس با ما
logotype

نرم افزار هوشمند ابری CERP

CERP messaging guide
HomeCERP messaging guide

CERP messaging guide

SMS, the Bale messenger, templates, scenario writing and customer-club incentives — which message is sent, when, and under what condition.

Complete customer club guide in 21 topics · Comprehensive enterprise proposal and PDF download
Contents
  1. How is a message sent?
  2. Sending channel: SMS or Bale
  3. Message map
  4. Scenario writing
  5. Scenario engine settings
  6. Incentives
  7. Open tables and live bills
  8. Blacklist
  9. Template text variables
  10. Setup checklist
  11. Why wasn't the message sent?
  12. Referral code status and topics without an event
  13. Messaging in the offline edition (OfflineCerp)

1. How is a message sent?

Every system message is built from a template. Each event has a topic (for example “Sales invoice recorded”), and you choose one template for each topic. There is no free, hand-written text.

Event→Topic→Chosen template→Variables filled in→Sending channel

Conditions for every send

  • A template is chosen for that topic under “Template settings”. If the organisation has not chosen one, the system administrator's default template is used.
  • For SMS, the template is active and carries the text code approved by the SMS provider.
  • The organisation has SMS credit (not needed when sending through Bale).
  • The customer has a mobile number.
If no template is chosen for a topic, automatic messages are silently not sent. In scenarios the same situation appears as a failure in the “Scenario execution log”.

Links never appear in full in the text; the system makes a short code for each link and the template text only takes that code (such as https://3rp.ir/#ReceiptCode#).

2. Sending channel: SMS or Bale

Under Settings → Bale messenger → “Channel for template messages” you decide in one place which channel all automatic messages use:

OptionBehaviourSuited to
SMS onlyAs before; the default for every organisationWhen Bale has not been set up
SMS and Bale togetherBoth are sentImportant messages that must be seen
Bale first, SMS as fallbackIf Bale delivers, no SMS is sent; otherwise SMS is sentSaving SMS credit
Bale onlyNo SMS is sentOrganisations that work only with Bale members

Who receives Bale messages?

  • Always: a customer who has messaged the organisation's Bale account and become a “Bale member”.
  • Other numbers: only when “Send to unknown users” is turned on in the Bale settings.

The Bale text is the template text with its variables filled in. Bale does not need the SMS provider's text code; choosing a template is enough. Every Bale message is logged in the Bale report as a “template message”.

Exceptions: one-time passwords (sign-in and verification) are always sent by SMS. Manual sending from the “SMS management” page is always SMS too. PDF invoices on Bale have their own separate setting (“Send invoices on Bale”).

3. Message map

Automatic sent without a scenario · Manual by a button or campaign · Scenario only from scenario writing

Sales and orders

TopicTypeWhenCondition
Sales invoice recordedAutomaticImmediately after the invoice is recorded“Invoice SMS” is ticked; the invoice has a customer
Order recordedAutomaticWhen an order/quotation is created (not edited)“Order SMS” is ticked
Online invoice linkManualFrom the transaction list—
Table guest welcomeAutomaticAs soon as a customer is added to an open tableSee open tables

Membership and profile

TopicTypeWhenCondition
Membership notificationAutomaticWhen a new customer is created“Membership SMS” is ticked
Invitation to complete profileAutomaticWhen a new customer is created“Automatic profile-completion invitation” is ticked
Profile completion reminderManualProfile-completion invitation campaign—
Survey landing pageManualThe “Send survey” buttonA survey is active

Club incentives

TopicTypeWhenCondition
Points incentiveAutomaticAfter every invoice that earns pointsPoints incentive active and “SMS notification” on
Cashback (days/weeks/months/no expiry)AutomaticWhen cashback is paid into the wallet (instantly or when due)Cashback active
Discount code (24 variants)Automatic ScenarioAt the “SMS send time” for targeted codes, plus remindersCode active and unexpired; has a target segment
Gift credit (with or without expiry)AutomaticWhen the gift is finalised, plus reminders—
Dynamic tier: gold, silver, bronzeAutomaticWhen the customer is promotedDynamic tiers active
Dynamic tier: down to silver, bronze, regularAutomaticWhen the customer is demoted (daily check)Dynamic tiers active

Reservations, sports clubs and buildings

TopicTypeWhen
Table reservation: confirmed / rejectedAutomaticWhen the operator confirms or rejects
Table reservation: reminderAutomaticAbout one hour before the reservation
Club sessions: top-up / useAutomaticBuying a package / each session used
Club sessions: low balance / used up / near expiryAutomaticReaching the threshold / reaching zero / close to the end of validity
Court booking: confirmed / rejected / reminderAutomaticBooking status changes; reminder about two hours before
Building: charge issued / monthly charge / payment receivedAutomaticRecording a debt, monthly issue, recording a receipt
Building: shared-space booking confirmed / rejectedAutomaticBooking status changes
Building: shared-space booking reminderAutomaticThe morning of the booking, for confirmed bookings
Building: unit debt reminderAutomaticOnce a month, ten days after the monthly charge day (or the 15th), only for units in debt
Building: building noticeAutomaticWhen reminders marked “Send SMS” fall due, to every unit in that building

Other

TopicTypeDescription
One-time passwordAutomaticMobile sign-in, customer verification, reservations, the online store, the order kiosk; always SMS
Promotional message (general / offer / event)ManualFrom “SMS management”
Scenario writing: SMS action (16 topics)ScenarioIf no topic is chosen for the “Send SMS” action, the topic for that behaviour is sent automatically (for example birthday → “SMS action for birthday”)
Scenario writing: incentive header (15 topics)ScenarioWhen a scenario grants credit, points or a prize for a behaviour and a template is chosen for that behaviour's “incentive header”, that text is sent
If a scenario has already sent an SMS for the same event, the separate automatic message is not sent, so the customer does not receive two messages. A scenario that sends no SMS (for example one that only assigns a tag) does not suppress the separate message.

4. Scenario writing

Every scenario means: when this behaviour happens, take this action. Path: Customer club → Scenario writing.

Behaviours (what starts a scenario)

BehaviourWhen it happensRepetition
Joining the clubA customer is createdOnce per customer
Completing the profileThe customer's details become completeOnce
First orderThe customer's first order/quotationOnce
Order recorded / sales invoice issuedEvery order or invoice with a customerEvery time
Buying a product / buying from a product groupThe target item or group is on the invoiceEvery time
Birthday / membership anniversaryThe birthday or anniversaryOnce a year
Dynamic tier promotion or demotionA change between gold/silver/bronze/regularEvery change
Commercial class (champion, loyal, regular, needs attention, dormant, lost) and moving up or down a classA class change in the periodic reviewEvery change
Joining a customer segmentThe customer enters the target segmentEvery new membership
Receiving a custom tagA tag is given to the customerEvery time
Survey sent / answer recorded / positive, neutral or negative feedbackA survey is sent or answered (score 4 and above is positive, 2 and below negative, in between neutral)Every time
Webhook receivedA call from an external systemEvery time

Actions

ActionWhat it doesMessage to the customer
Send SMSA message with the topic you chooseYes
Discount codeSends a prepared discount code to the customerYes; the template matching the code type
Gift creditTops up the customer's walletYes; the gift-credit template or the chosen template
Award pointsAdds to the customer's pointsYes; the points-incentive template or the chosen template
Special prizeMakes the customer a prize winnerOptional
Give a custom tagGives the customer a tagNo
Send a webhookNotifies an external systemNo

Settings for each scenario

  • Execution delay: run the action immediately or after a number of minutes, hours or days.
  • Maximum runs per customer: for example at most 3 times.
  • Minimum interval between runs: for example at most once every 30 days per customer.
  • Combined condition: run the scenario only for customers with a given dynamic tier, commercial class and custom tag. All chosen conditions must hold at the same time.
  • Follow-up steps (chain): up to 5 more actions, each with its own delay.
Example: behaviour “Sales invoice issued”, condition “Commercial class: dormant”
Main action: give the tag “Returned” · Step 2 (1 hour later): thank-you SMS · Step 3 (3 days later): discount code
Each step's delay is counted from the moment the behaviour occurred. If the scenario is disabled during the delay or the customer is blacklisted, that step does not run. Each step's result is recorded in the “Scenario execution log”.

5. Scenario engine settings

On the scenario writing page, the “Scenario engine settings” button:

SettingDefaultUse
Blacklist also stops the club's separate messagesOnBlacklisted customers also get no invoice, membership, cashback and similar messages
Suppress the separate message only if the scenario sent an SMSOnPrevents a customer getting no message at all when the scenario has no SMS
Scenario SMS cap per customerUnlimitedFor example at most 2 messages in 7 days
Fire on the first calculationOffThe first commercial class/segment calculation also triggers scenarios
Always scan commercial class and segmentsOffKeeps customers' status up to date even without an active scenario
Turn on “Fire on the first calculation” with care: the first run may send a message to every customer.

6. Incentives

Points incentive

When the points incentive is active, the points for each purchase are added to the customer after every sales invoice. If “SMS notification” is on, a points message is sent too. The “Recalculate” button still recalculates everyone's points from scratch.

Cashback

Cashback is paid into the wallet either immediately or on the set date, and a message is sent at that moment. The message topic depends on how long the cashback can be used: up to 31 days “days”, up to 120 days “weeks”, and longer “months”.

Targeted discount codes

  • Sent at the “SMS send date and time” to members of the target segments.
  • The template topic is derived automatically from the code type: percentage or fixed amount, single or multiple use, with or without expiry, with or without a minimum, with or without a cap.
  • Reminders go only to customers who have not used the code yet.
  • If no template is chosen for that code type, it waits up to 48 hours for one to be chosen and is not sent after that.

Gift credit

When a gift is finalised, the credit is paid into the target customers' wallets and a message is sent. Automatic reminders go only to those who have not used the gift, and continue until the gift expires.

Dynamic tiers

Promotions are sent with a congratulation text for that level, and demotions with a separate “demotion” text. Choose a separate template for each of the six cases.

Birthdays and anniversaries

Birthday and membership-anniversary gifts and messages are configured only through scenario writing: the “Birthday” or “Membership anniversary” behaviour with a gift-credit, discount-code or SMS action. The old birthday-gift settings have been removed from the settings page.

7. Open tables and live bills

As soon as a customer (with a mobile number) is added to an open table, a welcome message with a short link is sent to them.

  • Opening the link shows the table's live bill: items, total, deposit and each person's share (split).
  • The page updates automatically and works while the table is open; once the table is settled, the link stops working.
  • Only one message is sent per open table. If the table's customer changes, the same link is also sent to the new number.
  • Held receipts (other than tables) do not receive this message.
Suggested text: Dear #CustomerFullName#, welcome to #StoreName# and thank you for choosing us. The live bill and each person's share for table #TableNumber#: https://3rp.ir/#LiveBillCode#

To enable it: choose a template for the “Guest welcome + live table bill” topic and make sure the link shortener is active. Without a template this feature is off.

8. Blacklist

  • A blacklisted customer is excluded from every scenario: messages, credit, points and prizes.
  • With the default setting, they also receive none of the club's separate messages (invoice, order, membership, cashback, gift, tier, promotions).
  • Service messages are always sent: one-time passwords, table reservations, open tables and buildings.
  • Scheduled sends and discount-code and gift-credit reminders are not sent to the blacklist either.

9. Template text variables

Variables are written in the template text as #Name#. Each topic accepts only its own variables; the allowed list for each topic is shown on the template creation page.

VariableValueTopics
#CustomerFullName#Customer nameAlmost all
#StoreName#Organisation/store name (filled in automatically if empty)Almost all
#OTP#One-time passwordOne-time password
#InvoiceNumber# #InvoiceDate# #InvoiceTime# #InvoiceAmount#Invoice number, date, time and amountSales invoice recorded
#OrderCode# #OrderDate# #OrderTime#Order code, date and timeOrder recorded
#DiscountCode# #DiscountPercent# #DiscountAmount#Discount code and amountDiscount code
#DiscountRangeFrom# #DiscountRangeEnd# #MinimumReqTotal# #MaximumDiscount#Validity period, minimum purchase, discount capDiscount code (depending on type)
#CreditAmount# #CashbackAmount# #WalletBalance#Gift amount, cashback amount, wallet balanceGift credit, cashback, scenarios
#ExpiryDate# #ExpiryDuration#Expiry date, validity period numberGifts, cashback, club sessions
#Points# #TotalPoints#Points this time, total pointsPoints incentive, dynamic tiers, scenarios
#ReceiptCode# #SurveyCode# #ProfileCode# #LiveBillCode#Short link code for the invoice, survey, profile, live table billEach in its own topic
#TableNumber# #GuestCount# #ReservationDate# #ReservationTime#Table, number of guests, reservation date and timeTable reservations, open tables
#PackageName# #UsedSessions# #ChargedSessions# #RemainingSessions# #CourtName#Package, sessions used/charged/remaining, court nameClub facilities
#ResidentFullName# #BuildingName# #UnitTitle# #ChargeTitle# #ChargeAmount# #ChargeDate# #ReceiptAmount# #ReceiptDate# #AmenityName#Resident, building, unit, charge, receipt, shared spaceBuildings
A variable written in a template that has no value is sent empty. Do not write full links in the text; put only the short code.

10. Setup checklist

  1. Top up the organisation's SMS credit.
  2. Under “Template settings”, choose a template for every topic you want to send. Default templates do not work for SMS until the system administrator records the approved text code and activates the template.
  3. Turn on the automatic sending options: membership SMS, order recorded, invoice recorded, profile-completion invitation.
  4. If you use Bale: set up the Bale connection and choose the “Channel for template messages”.
  5. Configure incentives: points, cashback, dynamic tiers.
  6. Build your scenarios and test them once with a test customer.
  7. Check the “Scenario execution log” and the SMS/Bale reports.

11. Why wasn't the message sent?

SymptomLikely causeFix
No message is sent for an eventNo template is chosen for that topicChoose a template under “Template settings”
There is a template but no SMS is sentThe template is inactive or has no provider text codeAsk the system administrator to approve and activate the template
Credit errorSMS credit has run outTop up credit, or use the “Bale first, SMS as fallback” channel
No invoice/order/membership messageThe automatic sending option is off or the customer has no numberTurn the option on and record the customer's number
Only some customers get nothingThe customer is blacklistedCheck the blacklist or the scenario engine settings
The scenario shows “failed” in the logNo template chosen, no number, or the SMS cap is reachedRead the error text in the execution log
The scenario never runsThe combined condition is not met, the run cap is reached, or a one-time behaviour already ranCheck that scenario's settings
Bale messages are not sentThe customer is not a Bale member and “Send to unknown users” is off, or the Bale connection is downCheck the Bale settings and “Test connection”
The table welcome message is not sentNo template chosen, the customer has no number, or the link shortener is offSee open tables

12. Referral code status and topics without an event

The status of the following topics reflects the current version of the software:

  • Active Referral code: a customer's mobile number is their referral code. When a referrer is recorded and the referred customer reaches the set number of purchases, both receive a gift. The referral invitation is sent with the configured delay and the topic's template. Complete referral code guide
  • No automatic sending “Taking part in refinement” (SMS action and incentive header): there is no matching behaviour in the system.

13. Messaging in the offline edition (OfflineCerp)

In the offline edition (a store running on the local service), the cloud edition's SMS, WhatsApp and Bale pages are not shown. Instead there is one page: Settings → Store messaging.

ChannelHow it worksWhat it needs
SMSSent through the Yasna server; each SMS uses one unit of the store's creditAn active licence, internet access, SMS credit
Bale messengerThe local service connects directly to the Bale gatewayThe store's own API key
WhatsAppThe local service connects directly to the WhatsApp gatewayThe store's own API key

SMS credit

  • The remaining credit and the number of SMS sent are shown at the top of that page.
  • “Request SMS credit” sends the number you need to support; once approved, the credit is topped up.
  • Support tops up credit from the OfflineCerp licence management section (“Store SMS credit”).

Automatic messages

  • A sales invoice message to the customer.
  • A welcome message when a new customer is created.

Each automatic message is sent through every active channel. The message text is the server's approved template and cannot be changed in the store.

“Offline” in OfflineCerp means the store's operations are independent of the SaaS service, not that there is no internet. The current local core includes the club and scenario-writing features; the availability of each feature depends on the version and the active licence. Sending messages and links needs internet access and the configured gateway. A failed message must never stop a sale. To check which features your installation has, compare your service version and licence with support.
CERP messaging guide · Yasna System · October 2026 edition

زمان حرکت
به سمت راه حل های منحصر به فرد

logotype

تماس با ما

میرداماد رودبارشرقی نبش کاظمیان پلاک16 طبقه سوم

info@cerp.ir

 

+982175424

+982174523

 

عضو شوید

همیشه با ما در تماس باشید! 

    تمام حقوق این وبسایت متعلق به شرکت یسنا سیستم پاسارگاد می‌باشد.

    TwitterFacebook-fLinkedin-inInstagram