Opciones avanzadas de aviso de llamada

Definición

Usted puede especificar una URL que será invocada cada vez que le entre una llamada a su número virtual, extensión de centralita, fax, siptrunk o botón web. Esta utilidad se encuentra en la pestaña Avisos de su número virtual, extensión, fax, siptrunk o botón web.

Tenga en cuenta que su URL se invocará cuando la llamada empiece, independientemente de que finalmente se establezca la comunicación (en un desvío, o que finalmente se reciba el fax, etc.).

Los protocolos soportados son:

• HTTP (GET)
• HTTPS (GET)

Opcionalmente, puede establecer un usuario y una contraseña en el caso de que la URL lo requiera.

Nota: tanto para números virtuales como para extensiones y botones web, debe haber desvíos definidos. Si no los hay, la llamada se irá directa al buzón de voz y no se disparará la invocación de su URL.

Variables

En la URL se pueden poner ciertas variables que serán sustituidas por sus valores reales en el momento de la llamada. Estas variables son:

• $llamante: el número de teléfono que realiza la llamada.
• $llamado: el número de teléfono que recibe la llamada. Sería su número virtual, número de centralita, número de fax, número de siptrunk o número de botón web contratado. Si es un botón web, vendrá en la forma bwN, siendo N el número de botón web (para el botón web 1, sería bw1).
• $nombre_llamante: el nombre del que realiza la llamada según los contactos.
• $nombre_llamado: el nombre del receptor de la llamada según los contactos.
• $extension: sólo en el caso de centralita, el número de extensión que se ha marcado.
• $fecha: fecha y hora de la llamada en formato YYYYMMDDHHMMSS. (Si es un cliente de Canarias, tenga en cuenta que la hora viene en horario peninsular).

Ejemplo

Supongamos que ponemos esta URL:

https://www.miweb.com/ejemplo.php?llamante=$llamante&receptor=$llamado&fecha=$fecha&nllamante=$nombre_llamante&nreceptor=$nombre_llamado

Si el número 912345678 (llamante), apuntado como "Pepe Perez" en los contactos (nombre_llamante), nos llama a nuestro número virtual 902009955 (llamado), apuntado como "Mi numero" en los contactos (nombre_llamado) a las 12:30:34 del 27/11/2013, la URL anterior se convertiría en:

https://www.miweb.com/ejemplo.php?llamante=912345678&receptor=902009955&fecha=20131127123034&nllamante=Pepe+Perez&nreceptor=Mi+numero

El código de ejemplo.php podría ser el siguiente:

<?php
  $llamante = $_GET["llamante"];
  $llamado = $_GET["llamado"];
  $fecha = $_GET["fecha"];
  $nllamante = $_GET["nllamante"];
  $nllamado = $_GET["nllamado"];
  $fd = fopen("/tmp/miregistro.txt", "a");
  if ($fd == true) {
     fprintf($fd, "-----------------------\n");
     fprintf($fd, "Fecha local = %s\n", date("d/m/Y H:i:s"));
     fprintf($fd, "Fecha = %s\n", $fecha);
     fprintf($fd, "Llamante = %s (%s)\n", $llamante, $nllamante);
     fprintf($fd, "Llamado = %s (%s)\n", $llamado, $nllamado);
     fclose($fd);
  }
?>