User manual / Support and messaging

Automations

Let CoreSync act on its own: text a receipt, open a ticket when a router goes down, or tell a technician about a new job. Plus the billing reminders every subscriber gets.

Owners & admins
All guides
On this page

How automations work#

An automation is a rule: when something happens, do something. Open Automations under System in the menu.

PartWhat it isExample
TriggerThe event that starts the rule.PAYMENT_RECEIVED, DEVICE_DOWN, TICKET_CREATED
ConditionsOptional limits on when it fires.Only New Subscriber tickets. Only payments over KES 500.
ActionsWhat CoreSync does, in order.Send an SMS. Open a ticket. Suspend the subscriber.

The page has three tabs:

  • Rules: your rules. A green dot means on, grey means off.
  • Execution Log: every time a rule ran, or was held back, and why.
  • Library: ready-made rules you can copy and adjust.
The Automations page on the Rules tab, listing seeded rules with their triggers, actions and on/off dots
Permission needed:View Automations

The rules CoreSync gives you#

Every ISP starts with a set of rules named [Seeded] …. They're all switched off, because some of them use SMS credit. Turn on the ones you want.

RuleWhat it doesSends by
[Seeded] Payment ReceiptSends the customer a receipt for every confirmed payment.SMS and email
[Seeded] Renewal ConfirmationConfirms each renewal with the new expiry date.SMS and email
[Seeded] Suspension NoticeTells a suspended customer how to pay and get back online.SMS and email
[Seeded] Ticket Opened — Customer & TechnicianAcknowledges a new ticket to the customer and sends the job to the technician.Email
[Seeded] Ticket Assigned — Technician NotificationTells the technician when a ticket lands in their queue.SMS and email
[Seeded] New Subscriber — Installation Booked (SMS)Texts the new customer their installation booking, and the technician the job. Only New Subscriber tickets.SMS
[Seeded] Ticket Resolved — Customer ClosureEmails the customer when their ticket is resolved.Email
[Seeded] Device Down — Ticket & Ops EmailOpens a HIGH ticket when a router or device goes offline, emails managers, raises it to CRITICAL after an hour, and marks it resolved when the device comes back.Email
  1. On the Rules tab, open the menu at the end of the rule's row.
  2. Press Enable, read what it will do, and press Enable again to confirm.

Press Disable the same way to turn a rule off. It stops firing until you turn it back on.

Permission needed:Manage Automations
Read the message before you turn a rule on. Click the rule to open it, check the wording, and change it to suit your ISP.

Make your own rule#

  1. On the Rules tab, press New Rule. Or start from the Library (below).
  2. Give it a Rule name and a Description. Priority decides the order when several rules fire at once: lower runs first. Leave Active switched on so it runs.
  3. Under Trigger, pick one or more Trigger types. Set a Trigger delay (minutes) to wait before acting, or leave it blank to act at once.
    The rule editor with name, trigger types, conditions, an SMS action and the rate limiting fields
  4. Fill in any Conditions that appear for your trigger, for example Only these ticket categories or Minimum payment amount (KES).
  5. Under Actions, choose an Action type and fill in its fields. Press Add main action for another step. Actions run in the order listed.
  6. Set the limits under Rate Limiting & Dedup (see below), then press Create Rule.

The trigger groups and the actions you can choose:

Trigger groupTriggers
Device / NetworkDEVICE_DOWN, DEVICE_UP, DEVICE_DEGRADED, ONU_LOS, ONU_POWER_FAIL, ONU_RESTORED, NAS_OFFLINE, NAS_ONLINE
Subscriber / RADIUSRADIUS_LOST_CARRIER, RADIUS_AUTH_SUCCESS, RADIUS_AUTH_FAILURE, SUBSCRIBER_CREATED, SUBSCRIBER_SUSPENDED, SUBSCRIBER_REACTIVATED, DATA_CAP_REACHED
BillingPAYMENT_RECEIVED, PAYMENT_UNMATCHED, SUBSCRIPTION_EXPIRING, SUBSCRIPTION_EXPIRED, SUBSCRIPTION_RENEWED, CREDIT_LOW
HotspotHOTSPOT_SESSION_EXPIRED, HOTSPOT_DATA_EXHAUSTED, HOTSPOT_VOUCHER_ISSUED
TicketsTICKET_CREATED, TICKET_UPDATED, TICKET_ASSIGNED, TICKET_OPEN_TOO_LONG, TICKET_ESCALATED, TICKET_RESOLVED, TICKET_CLOSED
SystemSCHEDULED_DAILY, SCHEDULED_HOURLY, MANUAL
ActionWhat it does
SEND NOTIFICATIONSends an SMS or email to the subscriber, the ticket's technician, a manager, or numbers and addresses you type.
CREATE TICKETOpens a ticket, and can assign it to a person or to staff in the device's or subscriber's zone.
CLOSE TICKETMarks every open ticket on that device or subscriber as resolved, with your resolution message. A supervisor still verifies and closes them.
ADD TICKET NOTEAdds a note to the ticket.
SUSPEND SUBSCRIBERCuts the subscriber off.
REACTIVATE SUBSCRIBERLifts a suspension.
REDUCE SPEEDSlows the subscriber to a share of their plan speed, or to a fixed cap.
RESTORE SPEEDPuts their plan speed back.
EXTEND SUBSCRIPTIONAdds (or takes away) hours, days or months.
WEBHOOKSends the event to another system's web address.

In a message, click a variable chip to add details like the customer's name or the amount paid. The chips change with the trigger you picked, so you only see what that event can fill in.

Permission needed:Manage Automations

Start from the Library#

The Library has ready-made rules for common jobs, grouped into Complete Flows, Network Monitoring, Subscription Management, Data Cap & Speed, Billing & Payments, Subscriber Lifecycle, Ticket Management, Hotspot and Provisioning.

  1. Open the Library tab. Search, or pick a group to narrow the list.
    The automation Library with template cards grouped by category
  2. Press Use this on a template. The rule editor opens, already filled in.
  3. Change the wording and limits to suit you, then press Create Rule. Nothing is saved until you do.

Templates you've already used show Used.

Permission needed:Manage Automations

Stop a rule firing too often#

These fields under Rate Limiting & Dedup keep a rule from flooding customers or staff:

FieldWhat it does
Dedup window (min)Skips the rule if it already fired for the same thing (the same subscriber, device or ticket) within this many minutes.
Cooldown (min)The shortest gap between any two runs of this rule, for anyone. Use it for alerts to staff.
Max per dayThe most times the rule runs in a day. Blank means no limit.

A CREATE TICKET action also has a Dedup key. If an open ticket already has the same key, If ticket already open decides what happens: Add a note, Escalate priority or Ignore. That's how a router that keeps dropping gets one ticket, not twenty.

Some rules also have Finalization (finish the job when the opposite event happens, like resolving the outage ticket when the device comes back up) and Escalation (timed steps such as raising the priority after an hour).

Permission needed:Manage Automations

Check what ran: the Execution Log#

Use the Execution Log when you expected a message or ticket and nothing happened.

  1. Open the Execution Log tab.
    The Execution Log listing rule runs with time, rule, trigger, entity, phase, status and error
  2. Narrow it with Filter by rule and Filter by status.
  3. Read the Status and the Error column.
StatusMeaning
COMPLETEDEvery action ran.
COMPLETED WITH ERRORSSome actions ran, some failed. See the Error column.
FAILEDThe rule ran but its actions failed.
PENDING FINALIZATIONRan, and waiting for the opposite event (for example the device coming back).
FINALIZEDThe follow-up has happened.
SKIPPED DEDUPHeld back: it already fired for the same thing within the dedup window.
SKIPPED COOLDOWNHeld back: the cooldown hadn't passed.
SKIPPED RATE LIMITHeld back: it hit Max per day.
SKIPPED STORMHeld back because too many fired at once, for example a whole site going down.
CANCELLEDStopped before it ran.

Run now in a rule's menu runs its actions straight away as a test, ignoring its triggers, conditions and limits. Check the Execution Log for the result.

Permission needed:View Automations
Run now does the real thing. A rule that texts fixed numbers, suspends someone or calls a webhook will do exactly that. Test on a rule that only notifies you.

Billing reminders (Settings → Notifications)#

Expiry reminders aren't automations. They're a fixed ladder CoreSync runs for every subscriber, so nobody is missed or texted twice. Find them in Settings → Notifications, under Billing Reminders.

ReminderWhen it goes outStarts
One week before expiry7 days before expiry. Still sent up to day 4 if it was missed.Off
3 days before expiry3 days before expiry. Still sent at 2 days if it was missed.On
Final dayOn the last day of the subscription.On
On expiryOnce the subscription has expired.On
The Billing Reminders card in Settings, Notifications, with four reminders, their timing, on/off switches and message boxes

CoreSync checks every 3 hours between 08:00 and 20:00. Each subscriber gets each reminder at most once per billing period. They go by SMS to the subscriber's phone, or by email if there's no number on file.

  1. Go to Settings → Notifications. The Billing Reminders card is on the first tab.
  2. Use the switch on a reminder to turn it On or Off. The others still send.
  3. To change the wording, click in the message box. Click a variable chip, such as {{first_name}} or {{expiry_date}}, to add details.
  4. Press Save message. Reset to default puts back the standard wording.

You can change the words and switch a reminder on or off. You can't change when they go out.

Permission needed:View Settings
Don't build your own expiry reminders as well. A rule with the SUBSCRIPTION_EXPIRING trigger still runs, every morning, on top of the billing reminders. Your customers would get two messages.

Common mistakes#

  • Thinking the seeded rules are on. They all start off. Turn on the ones you want.
  • Ticket rules firing on every ticket. Under Only these ticket categories, pick the categories it's for. None selected means all.
  • No dedup or cooldown on alerts. A flapping router can send dozens of SMS. Set a dedup window.
  • Duplicate expiry reminders. Billing reminders already cover expiry. Don't add an expiry automation too.
  • Expecting imports to trigger welcome messages. Customers loaded by an import never fire SUBSCRIBER_CREATED rules, so nobody is texted during a migration.
  • Testing with Run now on a live rule. It really sends, suspends or calls out.
Still stuck? Open the AI assistant in CoreSync and describe what you see, or email hello@coresyncisp.com. Screenshots on this page come from Amani Link, our demo ISP, so the names and numbers are made up.