> ## Documentation Index
> Fetch the complete documentation index at: https://checklyhq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PhoneCallAlertChannel Construct

> Learn how to configure phone call alert channels with the Checkly CLI.

<Tip>
  For general information about alerting, see our docs on [phone call alerts](/integrations/alerts/phone-calls) and [alerting with Checkly](/communicate/alerts/overview/).
</Tip>

Sends phone calls to the specified phone number.

<CodeGroup>
  ```ts Basic Example theme={null}
  import { PhoneCallAlertChannel } from 'checkly/constructs'

  const callChannel = new PhoneCallAlertChannel('call-channel-1', {
    phoneNumber: '+31061234567890',
  })
  ```

  ```ts Advanced Example theme={null}
  import { PhoneCallAlertChannel } from 'checkly/constructs'

  const callChannel = new PhoneCallAlertChannel('call-channel-1', {
    phoneNumber: '+31061234567890',
    name: 'Ops on-call',
    sendRecovery: false,
    sendFailure: true,
    sendDegraded: false,
    sslExpiry: true,
    sslExpiryThreshold: 3,
  })
  ```
</CodeGroup>

<Note>
  If you need to reference existing alert channels that were created outside of your CLI project, use [`fromId()`](/constructs/alert-channel#using-fromid-to-reference-an-existing-channel).
</Note>

## Configuration

### Phone Call Alert Channel Options

<ResponseField name="phoneNumber" type="string" required>
  Phone number to call.

  Each `PhoneCallAlertChannel` supports only one phone number. Phone numbers need to be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).

  We only support phone numbers from certain [countries and regions](/integrations/alerts/phone-calls/#supported-countries-and-regions).

  ```ts highlight={2} theme={null}
  new PhoneCallAlertChannel('call-channel-1', {
    phoneNumber: '+31061234567890',
  })
  ```
</ResponseField>

<ResponseField name="name" type="string">
  Friendly name for the phone call alert channel.
</ResponseField>

### General Alert Channel Options

These options are valid for all alert channels types.

<ResponseField name="sendRecovery" type="boolean">
  Whether to send notifications when checks recover from a [failed or degraded state](/communicate/alerts/overview/#alert-channels). Default value is `true`.
</ResponseField>

<ResponseField name="sendFailure" type="boolean">
  Whether to send notifications when checks [fail](/communicate/alerts/overview/#alert-channels). Default value is `true`.
</ResponseField>

<ResponseField name="sendDegraded" type="boolean">
  Whether to send notifications when checks [become degraded](/communicate/alerts/overview/#alert-channels). Default value is `false`.
</ResponseField>

<ResponseField name="sslExpiry" type="boolean">
  Whether to send notifications when a SSL/TLS certificate is about to expire. Default value is `false`.

  ```ts highlight={3} theme={null}
  new EmailAlertChannel("email-channel-1", {
    address: "alerts@acme.com",
    sslExpiry: true,
    sslExpiryThreshold: 30, // Alert 30 days before expiry
  })
  ```

  [Learn more about SSL alerts.](/communicate/alerts/ssl-expiration/)
</ResponseField>

<ResponseField name="sslExpiryThreshold" type="number">
  Number of days before the SSL/TLS certificate expiry date to send notifications. Only relevant when `sslExpiry` is enabled. Default value is `30`.

  ```ts highlight={4} theme={null}
  new EmailAlertChannel("email-channel-1", {
    address: "alerts@acme.com",
    sslExpiry: true,
    sslExpiryThreshold: 30, // Alert 30 days before expiry
  })
  ```

  [Learn more about SSL alerts.](/communicate/alerts/ssl-expiration/)
</ResponseField>
