Diferencia entre revisiones de «Opciones avanzadas de aviso de llamada cobrada»
| Línea 2: | Línea 2: | ||
|title= Avisos {{PROD_TILDE}}. | |title= Avisos {{PROD_TILDE}}. | ||
|titlemode=append | |titlemode=append | ||
| − | |keywords=coste, precio, llamada saliente, URL, llamada entrante, opciones de aviso, aviso de llamada, lanzar url, avisos de llamada cobrada | + | |keywords=coste, precio, llamada saliente, URL, llamada entrante, opciones de aviso, aviso de llamada, lanzar url, avisos de llamada cobrada, webhook |
|description=Con las opciones avanzadas de aviso, usted puede lanzar una determinada URL cada vez que la llamada ha finalizado y haya sido cobrada por el sistema. | |description=Con las opciones avanzadas de aviso, usted puede lanzar una determinada URL cada vez que la llamada ha finalizado y haya sido cobrada por el sistema. | ||
}} | }} | ||
| Línea 8: | Línea 8: | ||
==Que son las 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). Puede configurar estas opciones en TELEFONIA > Avisos. Vea el artículo [[Avisos de llamada]]. | + | 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: | Los protocolos soportados son: | ||
Revisión del 12:14 6 abr 2018
Sumario
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).
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);
}
?>