Using Placeholders for Event Handlers
Placeholders can automatically replace specific information (such as customer address, order details, subscription status etc.). Each type of notification has its own set of placeholders that aren't available to other notification types.
Placeholders allow to extract information from the database and put into a notification message.
Event | Placeholder | Description | Type | Example |
---|---|---|---|---|
For all events | owner.status | A status of the user with Owner access rights. | string | owner.status = "active" |
owner.country | An owner address: a two-letter ISO code ISO 3166-1 alpha-2 of the country. | string | owner.country = "BY" | |
owner.city | An owner address: a city. | string | owner.city = "Minsk" | |
current_date | A current date. | date | current_date | |
Account changed Low balance Create instance Reset instance password | account.type_id | An ID of the account type. | integer | account.type_id = 1 |
account.type_key | A key that is used to refer to the account. | string | account.type_key = "business" | |
account.class_id | An ID of the account class (see Account Classes). | integer | account.class_id = 1 | |
account.class_key | A key that is used to refer to the account class (see Account Classes). | string | account.class_key = "manual" | |
account.billing_day | The billing day is set in the Plan Class (see Managing Plan Classes). The billing day can be set from 1 to 31 that specifies the day of the month. If the month does not include the specified number, the Invoice will be created on the last day of that month. | integer | account.billing_day = 30 | |
account.credit_limit | A maximum amount of the credit that a customer can use for ordering services without topping up. The credit limit can be set manually or by default (see Account Classes). | integer | account.credit_limit = 100 | |
account.balance | A current value of the Account Balance (see Viewing the List of Charges). | integer | account.balance = 1000 | |
account.balance.was | A previous value of the Account Balance (see Viewing the List of Charges). | integer | account.balance.was = 100 | |
account.status | A current account status: active, inactive, deleted. | string | account.status = "inactive" | |
account.status.was | A previous account status: active, inactive, deleted. | string | account.status.was = "inactive" | |
account.country | An account's address: a two-letter ISO code ISO 3166-1 alpha-2 of the country. | string | account.country = "BY" | |
account.city | An account address: a city. | string | account.city = "Minsk" | |
Low balance | account.regular_sending | A threshold for notification sending about a low account balance:
SMS notification about low account balance is sent only if Account has at least one not-trial IaaS subscription that is billed using Pay-as-you-go model. | boolean | "account.regular_sending = true" |
Invoice closed | invoice.status | An invoice status. | string | invoice.status = "open" |
Manual Operation | operation.id | An ID of manual operation (see Manual Operations). | integer | operation.id = 1 |
operation.status | A status of the manual operation:
| string | operation.status = "approval_required" | |
User invitation | - | - | - | - |
Payment has been received | account.type_key | A key that is used to refer to the account type (see Account Types). | string | account.type_key = "business" |
account.class_key | A key that is used to refer to the account class (see Account Classes). | string | account.class_key = "manual" | |
account.billing_day | The billing day is set in the Plan Class (see Managing Plan Classes). The billing day can be set from 1 to 31 that specifies the day of the month. If the month does not include the specified number, the Invoice will be created on the last day of that month. | integer | account.billing_day = 30 | |
account.credit_limit | integer | account.credit_limit = 100 | ||
account.balance | A current value of the Account Balance (see Viewing the List of Charges). | integer | account.balance = 1000 | |
account.balance.was | A previous value of the Account Balance (see Viewing the List of Charges). | integer | account.balance.was = 100 | |
account.status | A current account status: active, inactive, deleted. | string | account.status = "inactive" | |
account.status.was | A previous account status: active, inactive, deleted. | string | account.status.was = "inactive" | |
account.country | An account's address: a two-letter ISO code ISO 3166-1 alpha-2 of the country | string | account.country = "Belarus" | |
account.city | An account address: a city. | string | account.city = "Minsk" | |
payment.total | An amount of the payment. | integer | payment.total = 100 | |
payment.status | One of the following statuses of the payment:
| string | payment.status = "completed" | |
Password reset request Verify email | user.id | A unique identification number of the user. | integer | user.id = 1 |
Before subscription expiration After subscription expiration After subscription switched from trial to non-trial Subscription changed | account.type_key | A key that is used to refer to the account type (see Account Types). | string | account.type_key = "business" |
account.class_key | A key that is used to refer to the account class (see Account Classes). | string | account.class_key = "manual" | |
account.billing_day | The billing day is set in the Plan Class (see Managing Plan Classes). The billing day can be set from 1 to 31 that specifies the day of the month. If the month does not include the specified number, the Invoice will be created on the last day of that month. | integer | account.billing_day = 30 | |
account.credit_limit | A maximum amount of the credit that a customer can use for ordering services without topping up. The credit limit can be set manually or by default (see Account Classes). | integer | account.credit_limit = 100 | |
account.balance | A current value of the Account Balance (see Viewing the List of Charges). | integer | account.balance = 1000 | |
account.balance.was | A previous value of the Account Balance (see Viewing the List of Charges). | integer | account.balance.was = 100 | |
account.status | A current account status: active, inactive, deleted. | string | account.status = "inactive" | |
account.status.was | A previous account status: active, inactive, deleted. | string | account.status.was = "inactive" | |
account.country | An account's address: a two-letter ISO code ISO 3166-1 alpha-2 of the country. | string | account.country = "Belarus" | |
account.city | An account address: a city. | string | account.city = "Minsk" | |
plan.id | A plan ID. | integer | plan.id = 1 | |
plan.status | One of the following plan statuses:
| string | plan.status = "completed" | |
plan_category.key | A key that is used to refer to the plan category (see Managing Plan Categories). | string | plan_category.key = "streaming" | |
plan_period.duration_value | A duraton of the subscription for the plan. | integer | plan_period.duration_value = 30 | |
plan_period.duration_type | A type of the duration (year, month, day). | string | plan_period.duration_type = "months" | |
plan_period.trial | Plan perioad is trial: yes or no. | boolean | plan_period.trial = "false" | |
plan_period.setup_fee | A price of the resource installation. It is used for one-time payment. | integer | plan_period.setup_fee = 100 | |
plan_period.recurring_fee | A value of monthly fee for the resource. This type of fee is used if the customer has to pay for the resource each month to renew the subscription. | integer | plan_period.recurring_fee = 100 | |
plan_period.renewal_fee | A value of fee, which the subscriber has to pay to renew the resource. | integer | plan_period.renewal_fee = 100 | |
subscription.id | An subscription ID . | integer | subscription.id = 1 | |
subscription.status | A current subscription status:
| string | subscription.status = "active" | |
subscription.status.was | A previous subscription status. | string | subscription.status.was="installing" | |
subscription.auto_renewal | If the auto renewal option is active: true or false. | boolean | subscription.auto_renewal = "true" | |
subscription.days_left | A number of days before expiration day of the subscription. | integer | subscription.days_left = 7 | |
subscription.days_passed | A number of days after creation day of the subscription. | integer | subscription.days_passed = 15 | |
subscription.plan_class | An plan class ID (see Managing Plan Classes). | integer | subscription.plan_class = 1 | |
subscription.trial.status | A placeholder (boolean) for tracking the status (trial / no-trial) of the plan period, which is used for the "Subscription is changed" event. You can add this placeholder to the event handler for the "Subscription is changed" event (for example, «subscription.trial = false»). In this case, if the plan period is changed from trial to no-trial, the notifications will be sent. | string | subscription.trial.status = "trial" subscription.trial.status = "no-trial" | |
Order changed Order created | order.id | An ID of the order. | integer | order.id = 1 |
order.plans_ids | ID of ordered plans. | integer | order.type = "SalesOrder" and (order.plans_ids include? 2000030) | |
order.status | A current status of the order:
| string | order.status = "waiting for payment" | |
order.status.was | A previous status of the order. | string | order.status.was = "provisioning" | |
order.total | A total amount of order. | integer | order.total = 100 | |
order.type | One of the following types of order:
| string | order.type = "RenewalOrder" | |
order.renewal_point | If the value in the "Renew point (days)" field is set on the subscription's details page (see Viewing and updating Subscription's details): true or false. | boolean | order.renewal_point = "true" | |
Guaranteed payment created Guaranteed payment changed | account.type_id | An ID of the account type (see Account Types). | integer | account.type_id = 1 |
account.type_key | A key that is used to refer to the account type (see Account Types). | string | account.type_key = "business" | |
account.class_id | An ID of the account class (see Account Classes). | integer | account.class_id = 1 | |
account.class_key | A key that is used to refer to the account class (see Account Classes). | string | account.class_key = "manual" | |
guaranteed_payment.status.was | A previous status of the guaranteed payment (see Managing Guaranteed Payments). | string | guaranteed_payment.status.was = "provided" | |
guaranteed_payment.status | A current status of the guaranteed payment (see Managing Guaranteed Payments). | string | guaranteed_payment.status = "revoked" |