Opciones avanzadas de aviso de llamada cobrada

Que son las opciones avanzadas de aviso de llamada cobrada

Usted puede especificar una URL que será invocada cada vez que una llamada haya concluido y haya sido cobrada por el sistema (bajo ciertas condiciones, si lo desea), como un webhook. Puede configurar estas opciones en TELEFONIA > Avisos. Vea el artículo Avisos de llamada.

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.

Resultado de la llamada

El sistema intentará llamar a su URL hasta 5 veces si se produjera algún error. El intervalo entre cada intento será de 1 minuto.

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 virtual que recibe la llamada en el caso de llamadas entrantes, o el acceso en el caso de llamadas salientes.
• $telefono: el número de destino (desvío en el caso de llamadas entrantes).
• $nombre_llamante: el nombre del que realiza la llamada según los contactos.
• $nombre_llamado: el nombre del receptor virtual o acceso de la llamada según los contactos.
• $nombre_teléfono: el nombre del receptor o desvío de la llamada según los contactos.
• $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).
• $tipo: puede ser 'llamada_saliente', 'sms', 'llamada_saliente_voip', 'llamada_entrante_voip', 'buzon_voz', 'centralita', 'fax', 'envio_fax', 'llamada_entrante', 'desvio', 'conferencia', 'conferencia_centralita' y 'callback'.
• $coste: coste de la llamada.
• $duracion: duración de la llamada en formato M:SS.
• $bono: minutos gastados del bono de tarifa plana.
• $referencia: referencia interna de la llamada, única en el día (se puede repetir en días diferentes).
• $abierto: si tiene el valor 51 en $duracion nos dará el tiempo total de la llamada, desde que entró en la centralita. Si tiene el valor 67, nos dará la duración real de la conversación.

Ejemplo opciones avanzadas de aviso de llamada cobrada

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"];
  $telefono = $_GET["telefono"];
  $fecha = $_GET["fecha"];
  $nllamante = $_GET["nllamante"];
  $nllamado = $_GET["nllamado"];
  $ntelefono = $_GET["ntelefono"];
  $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);
     fprintf($fd, "Telefono = %s (%s)\n", $telefono, $ntelefono);
     fclose($fd);
  }
?>