Opciones avanzadas de aviso de llamada

Definición opciones avanzadas de aviso de llamada

Usted puede especificar una URL que será invocada cada vez que le entre una llamada a su Número Virtual, número de Centralita, extensión de Centralita, Siptrunk o Botón Web. Esta utilidad o webhook se encuentra en la pestaña Avisos de su Número Virtual, número de Centralita, extensión de Centralita, Siptrunk o Botón Web.

En el caso de Números Virtuales y extensiones de Centralitas, la URL puede ser invocada en estos 3 casos (no excluyentes):

• Nada más llegar la llamada entrante a nuestro sistema. 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, etc.).
• Cuando se empiece a llamar a los teléfonos de desvío.
• Cuando la llamada entrante se descuelga y comienza la comunicación.
• Cuando la llamada entrante se cuelga y finaliza la comunicación.

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.

Tenga en cuenta que:

• 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.
• En el caso en que sus desvíos tengan un coste no gratuito, deberá tener suficiente saldo en la cuenta. Si no hay saldo suficiente para realizar el desvío, no se disparará la invocación de su URL.
• Si en las opciones de desvío tiene especificado que se cambie el número llamante que le llegue al receptor, en los casos "Comienza el desvío", "La llamada entrante se descuelga" y "La llamada entrante se cuelga" se enviará a su URL el número cambiado; mientras que en el caso "La llamada entrante llega" le llegará el número teléfono llamante original.

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 que recibe la llamada. Sería su Número Virtual, número de Centralita, 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).
• $tipo: puede ser 'llamada_entra', 'desvío', 'llamada_perdida', 'descuelga' o 'cuelga'.
• $referencia: referencia interna de la llamada, única en el día (se puede repetir en días diferentes).

En el caso de que la invocación a la URL sea en el descuelgue o cuelgue de la llamada, también tiene disponibles las siguientes variables:

• $desvio: teléfono final de desvío que coge la llamada entrante.
• $duracion (solo en $tipo=='cuelga'): duración en segundos de la llamada.

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);
  }
?>