diff --git a/integrations/alerts/phone-calls.mdx b/integrations/alerts/phone-calls.mdx index 28d8381b..56852e45 100644 --- a/integrations/alerts/phone-calls.mdx +++ b/integrations/alerts/phone-calls.mdx @@ -17,7 +17,9 @@ The phone numbers used for phone call alerting need to be in [E.164 format](http ![send monitoring alerts with phone calls](/images/docs/images/alerting/phone-call.png) -You can add as many phone number channels as you like. Phone call channels aren't available on the Hobby and Starter plans, and some countries are only available on paid plans, not during a trial. +You can add as many phone number channels as you like. Phone call alerts are included on the Team plan and above. On the Hobby plan, you can't create phone call channels. On the Starter plan, you can create and test a phone call channel, but Starter includes no phone calls, so its alerts aren't sent. See [Monthly phone call quota](#monthly-phone-call-quota). + +Some countries are only available on paid plans, not during a trial. They're the same countries as for SMS alerts, and numbers are checked the same way: see [SMS supported countries and regions](/integrations/alerts/sms#supported-countries-and-regions) for the list and the error messages. For a paid-only country, the phone call form shows `Calls to this country require a paid plan. Upgrade your plan to use this number.` ## Supported countries and regions @@ -83,4 +85,22 @@ If your country is not supported feel free to reach out to our [support team](ma Phone call alerts always use the following number: +18142508623. You can save the number as a contact to allow alerts bypassing any do-not-disturb settings. +## Monthly phone call quota + +Each phone call alert that Checkly sends to a channel counts against your account's monthly phone call quota. All phone call channels in your account share the quota, and it starts again at the beginning of each calendar month. See the [Pricing page](https://www.checklyhq.com/pricing/#features) for the quota of each plan. Test calls don't count against the quota. + +When your account has used its quota, or your plan includes no phone calls, Checkly doesn't send the call. The alert appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly CALL limit`. + +Accounts on a trial can send only a few test calls a day. The limit resets after 24 hours. When you reach that limit, the **Test alert channel** button shows how many seconds to wait. On every plan, you can send at most two tests a minute, counted across all alert channel types. A third test within the minute fails with **Test rate limit exceeded**. + +Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). + +## Troubleshooting a missing phone call alert + +Open the [alert notification log](/communicate/alerts/notification-log), select your phone call channel and check **Show failures only**. Select a failed notification to see its notification result: + +- `Account hit the monthly CALL limit`: your account used its monthly phone call quota, or your plan includes no phone calls. See [Monthly phone call quota](#monthly-phone-call-quota). +- `Incomplete alert channel config`: the channel has no phone number. Edit the channel and add one. +- `Failed to send the Call`: the call couldn't be started through our phone call provider. Check that the number is correct, then select **Test alert channel** to place a test call. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). + For limits and other phone call related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features). diff --git a/integrations/alerts/sms.mdx b/integrations/alerts/sms.mdx index 5eaf16e2..5994113e 100644 --- a/integrations/alerts/sms.mdx +++ b/integrations/alerts/sms.mdx @@ -77,8 +77,42 @@ SMS alerts can only be sent to phone numbers in the following countries. Numbers | Uruguay (+598) | Paid plans only, not on trials | | Vietnam (+84) | Paid plans only, not on trials | +When a number is rejected, the channel form or the API tells you why: + +| Message | What to do | +| ------ | ------ | +| `The number field must be a valid phone number` (web app) or `phoneNumber is not a valid phone number` (API) | Enter the number in E.164 format: a `+`, the country code and the number, without spaces or dashes. | +| `Invalid country code. Please see our documentation for a full list of supported countries` | Start the number with `+` and the country code, and use a country from the table above. | +| `SMS to this country requires a paid plan. Upgrade your plan to use this number.` (web app) or `SMS and phone call alerts to this country are only available on a paid plan. Upgrade your plan to use this number.` (API) | The country is available on paid plans only, not on trials. | +| `Adding or changing SMS and phone call alert channels requires the Starter plan or above.` (API) | Your account is on the Hobby plan, which doesn't include SMS alerts. | + ## SMS alert number and sender ID SMS alerts will be sent with a sender ID and phone number. The Checkly sender ID is 'Checkly'. If your carrier does not support sender ID, you will instead see the Checkly SMS alert phone number, +1(814) 250 8623. +## Monthly SMS quota + +Each SMS alert that Checkly sends to a channel counts against your account's monthly SMS quota. All SMS channels in your account share the quota, and it starts again at the beginning of each calendar month. See the [Pricing page](https://www.checklyhq.com/pricing/#features) for the quota of each plan. Test messages don't count against the quota. + +When your account has used its quota, Checkly doesn't send SMS alerts for the rest of the month. Each alert that isn't sent appears in the [alert notification log](/communicate/alerts/notification-log) with the delivery status **Failed** and the notification result `Account hit the monthly SMS limit`. SMS alerts are sent again from the next calendar month. + +Need more SMS or phone calls? Contact [support](mailto:support@checklyhq.com). + +## Test messages + +Click **Test alert channel** in the channel form to send a test SMS to the number before you save the channel. Accounts on a trial or the Hobby plan can send only a few test messages a day. The limit resets after 24 hours. When you reach that limit, the button shows how many seconds to wait, and the API responds with `429 Too Many Requests` and `Alert channel test rate limit exceeded`. On every plan, you can send at most two tests a minute, counted across all alert channel types. A third test within the minute fails with **Test rate limit exceeded**. + +## Troubleshooting a missing SMS alert + +Open the [alert notification log](/communicate/alerts/notification-log), select your SMS channel and check **Show failures only**. Select a failed notification to see its notification result: + +- `Account hit the monthly SMS limit`: your account used its monthly SMS quota. See [Monthly SMS quota](#monthly-sms-quota). +- `Invalid phone number`: our SMS provider doesn't accept the number. Check the number and its country code, then send a test message. +- `Phone number doesn't support SMS`: the number can't receive SMS, for example because it's a landline. Use a mobile number. +- `Region not enabled`: SMS to the number's country or region can't be sent. Contact [support](mailto:support@checklyhq.com). +- `Attempt to send to unsubscribed recipient`: the number opted out of messages from Checkly, for example by replying `STOP`. To opt back in, reply `START` from that phone to the Checkly SMS number, see [SMS alert number and sender ID](#sms-alert-number-and-sender-id). +- `Incomplete alert channel config`: the channel has no phone number. Edit the channel and add one. +- `FROM number not associated with Twilio account`: a problem with the number Checkly sends from. Contact [support](mailto:support@checklyhq.com). +- `Failed to send the SMS`: the message didn't reach the number through our SMS provider. Check that the number is correct and can receive SMS, then send a test message. If alerts to a correct number keep failing, contact [support](mailto:support@checklyhq.com). + For limits and other SMS-related questions, please refer to our [Pricing page](https://www.checklyhq.com/pricing/#features).