# Monitoring Providers on MikoPBX

When working with telecom service providers, issues may occasionally arise. For example, the provider's server might become unresponsive or unavailable. This article provides a mechanism for notifying the system administrator via email.

{% hint style="success" %}
To enable notifications, you will need to configure the SMTP client. See instructions in the section "Mail and Notifications".
{% endhint %}

1. Create a new "Dialplan Application".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FBZ0La4Bdy8tejMP34xZF%2FnewDialplan.png?alt=media&#x26;token=23fc4a3c-d6a5-4141-a294-e22f7b1ca57a" alt=""><figcaption><p>Creating a new dialplan application</p></figcaption></figure>

2. Enter a name (e.g., Blacklist), a short number for the application (e.g., 99), and select "**Code Type**" - "**PHP AGI Script**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FMyQO8xhhvhORW8Y4ySA6%2Fnew1.png?alt=media&#x26;token=2a9d8366-f109-4ba7-b388-038df63560eb" alt=""><figcaption><p>Parameters of dialplan</p></figcaption></figure>

3. Go to the "Program Code" tab:

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fb8JvvdSFX9ZlhEGeyWk4%2Fnew2.png?alt=media&#x26;token=11a3c227-3fe7-49b3-94b0-9a0db0f163a5" alt=""><figcaption></figcaption></figure>

4. Insert the following code:

```php
<?php
use MikoPBX\Common\Models\PbxSettings;
use MikoPBX\Common\Models\LanInterfaces;
use MikoPBX\Core\System\Notifications;
use MikoPBX\PBXCoreREST\Lib\SIPStackProcessor;

require_once 'Globals.php';

$result = SIPStackProcessor::callBack(['action' => 'getRegistry']);
$adminMail = null;
$localIP = '';
$message = '';
foreach ($result->data as $provider) {
    if ($provider['state'] !== 'OFF' && $provider['state'] !== 'REGISTERED') {
        if ($adminMail === null) {
            $adminMail = PbxSettings::getValueByKey('SystemNotificationsEmail');
            $interfaces = LanInterfaces::find("disabled='0'");
            foreach ($interfaces as $interface) {
                if (!empty($interface->ipaddr)) {
                    $localIP = $interface->ipaddr;
                    break;
                }
            }
        }
        $message .= "Provider state: {$provider['state']}<br>" . "Url (local): ']} <br><br>";
    }
}

if (!empty($message) && !empty($adminMail)) {
    $notify = new Notifications();
    try {
        $notify->sendMail($adminMail, 'Provider invalid state...', $message);
    } catch (\Throwable $e) {
    }
}
```

5. Save the changes and copy the dialplan application identifier from the browser's address bar. It will look like "**DIALPLAN-APP-CF967EE0**".

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FocvRpmNTbG0AzklhBiX9%2FdialplanNumber.png?alt=media&#x26;token=f0b63004-b937-4856-bb28-6d27f8b7ebbe" alt=""><figcaption><p>Identificator of dialplan application</p></figcaption></figure>

6. Go to **System** → **Customizing System Files** and open the file **/var/spool/cron/crontabs/root** for editing.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2Fc534pq1YOhTiXaPYsQr3%2FcrontabsFile.png?alt=media&#x26;token=9f8773d5-3169-4484-a88c-ae67f4174dec" alt=""><figcaption><p>File for editing</p></figcaption></figure>

7. Select the mode "**Append to the end of the file**", and in the black editing field at the bottom, insert the following code:

{% hint style="info" %}
Adjust the file name according to your dialplan application identifier "**DIALPLAN-APP-CF967EE0**
{% endhint %}

```php
*/5 * * * * /usr/bin/php -f /var/lib/asterisk/agi-bin/DIALPLAN-APP-9С060381.php start > /dev/null 2> /dev/null 
```

Save the changes.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FO4DDASHGlKVx9SXGECo0%2FcodeInFile.png?alt=media&#x26;token=7e3690b5-1a6d-4740-8f45-81f6a5e1b28b" alt=""><figcaption></figcaption></figure>

You're done!