# Missed Call Telegram Notifications

## Dialplan-Based Example

{% hint style="success" %}
[Helpful article](https://gist.github.com/dideler/85de4d64f66c1966788c1b2304b9caf1) on working with a Telegram bot using **curl**.
{% endhint %}

1. Go to the **"System File Customization"** section:

<figure><img src="/files/DHv0ttNdah5HdRRKcv6U" alt=""><figcaption><p>System file customization section</p></figcaption></figure>

2. Open the **"extensions.conf"** file for editing. Set the mode to **"Append to the end of the file"** and insert the following context:

```php
[add-trim-prefix-clid-custom]
exten => _[0-9*#+a-zA-Z][0-9*#+a-zA-Z]!,1,NoOp(start check blacklist)
	same => n,Set(CHANNEL(hangup_handler_push)=hangup-ext-queues,h,1);
	same => n,Return()

[hangup-ext-queues]
exten => h,1,ExecIf($["${M_DIALSTATUS}" = "ANSWER"]?return)
    same => n,Set(TOKEN=5118292900:AAEWCOAXkay5fXb8AJptZmDyqkNk8QbP200)
    same => n,Set(CHAT_ID=939950800)
    same => n,Set(URL=https://api.telegram.org/bot${TOKEN}/sendMessage)
    same => n,Set(TEXT=MISSED CALL from: ${CALLERID(name)}, did: ${FROM_DID}, callid: ${CHANNEL(callid)})
    same => n,SHELL(curl -s -X POST '${URL}' -d chat_id='${CHAT_ID}' -d text='${TEXT}')
    same => n,Set(MISSED=${SHELL(curl -s -X POST '${URL}' -d chat_id='${CHAT_ID}' -d text='${TEXT}')})
    same => n,return
```

In this context, replace:

* **TOKEN** with your Telegram bot’s token.
* **CHAT\_ID** with the chat ID where messages should be sent.

Save your changes.

<figure><img src="/files/kH50Ml3TOKvz5co3ymDm" alt=""><figcaption><p>Editing file "extensions.conf"</p></figcaption></figure>

3. Go to **"modules.conf"** for editing. Set the mode to **"Append to the end of the file"** and insert the following line:

```
load => func_shell.so
```

Save your changes.

<figure><img src="/files/xwGQHo60fhBKfISytqSf" alt=""><figcaption><p>Editing file "modules.conf"</p></figcaption></figure>

{% hint style="success" %}
With **curl**, you can send requests to any website. For example, you could send notifications to **Slack**:

{% code overflow="wrap" %}

```php
same => n,Set(MISSED=${SHELL(curl -X POST --data-urlencode "payload={\"channel\": \"#cannel_name\", \"username\": \"bot_name\", \"text\": \"Missed call from ${CALLERID(name)} using external line: ${FROM_DID} в ${STRFTIME(${EPOCH},,%H:%M:%S %d-%m-%Y)}\", \"icon_emoji\": \":sos:\"}" https://hooks.slack.com/services/T76G7L0/B01R/VMPQUeAN)})
```

{% endcode %}
{% endhint %}

## PHP-AGI Example

1. Go to **"Dialplan Applications"** and create a new application by clicking **"Add a new"**:

<figure><img src="/files/kpintrAo9W0L7I8pf3Qt" alt=""><figcaption><p>Creating new dialplan app</p></figcaption></figure>

2. Provide the following parameters for the dialplan:

* **Name** – any name
* **Number to Call the Application** – any number
* **Code Type** – "*PHP-AGI script*"

<figure><img src="/files/hJUkogBLXw7jeIiixylE" alt=""><figcaption><p>Dialplan parameters</p></figcaption></figure>

3. Go to the **"Program Code"** tab and insert the following PHP-AGI script:

{% code overflow="wrap" %}

```php
<?php
require_once 'Globals.php';
use \GuzzleHttp\Client;

const API_KEY = '';
const CHAT_ID = '';

$agi = new MikoPBX\Core\Asterisk\AGI();

$name = $agi->get_variable('CALLERID(name)', true);
$num  = $agi->get_variable('CALLERID(num)', true);
$did  = $agi->get_variable('$FROM_DID', true);
$id   = $agi->get_variable('CHANNEL(linkedid)', true);
$date = date('Y.d.m H:i:s', str_replace('mikopbx-', '', $id));

$TEXT = "Missed call: $name, did: $did, callid: $num, id: $id, date: $date";
$apiURL = 'https://api.telegram.org/bot' . API_KEY . '/';
$client = new Client([
    'base_uri' => $apiURL,
    'timeout' => 1,
    'http_errors' => false,
]);
try {
    $client->post( 'sendMessage', ['query' => ['chat_id' => CHAT_ID, 'text' => $TEXT]] );
}catch (Throwable $e){
}
```

{% endcode %}

In this context, replace:

* **API\_KEY** with your Telegram bot token.
* **CHAT\_ID** with the chat ID where you want to send the message.

You can modify the notification text in the **$TEXT** variable.

4. After saving the script, copy its identifier from the browser’s address bar, which looks like **"DIALPLAN-APP-1B2B846E"**:

<figure><img src="/files/nujvEsj67YYrG41Tf1HP" alt=""><figcaption><p>Dialplan application identifier</p></figcaption></figure>

5. Go to **"System file customization"**:

<figure><img src="/files/DHv0ttNdah5HdRRKcv6U" alt=""><figcaption><p>"System file customization" section</p></figcaption></figure>

6. Open **"extensions.conf"** for editing. Set the mode to **"Append to the end of the file"** and insert the following context:

```php
[add-trim-prefix-clid-custom]
exten => _.X!,1,Set(CHANNEL(hangup_handler_push)=hangup-ext-queues,h,1);
	same => n,return

[hangup-ext-queues]
exten => h,1,ExecIf($["${M_DIALSTATUS}" = "ANSWER"]?return)
    same => n,AGI(DIALPLAN-APP-1B2B846E.php)
    same => n,return
```

{% hint style="info" %}
Replace **"DIALPLAN-APP-1B2B846E"** with your dialplan application ID.
{% endhint %}

Save your changes.

<figure><img src="/files/kQL9J0idpfK9jrHkJCQk" alt=""><figcaption><p>Editing file "extensions.conf"</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/english/faq/cases/notification-in-telegram.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.