¿Cómo usar FormCall?
FormCall® permite la utilización de nuestro sistema generador de llamadas sin tener que utilizar directamente el botón/popup, esto puede ser de mucha utilidad a la hora de querer integrar el sistema de ClickFono® con otras plataformas que no sean web, como por ejemplo mobile.
El servicio está implementado como una API HTTP. Para utilizarla se debe invocar al servicio en la URL :
https://clickandtalk.medularis.com/calls/manage/api
Con el header:
content-type: application/json
Y a modo de ejemplo, el siguiente body:
{
"popup_uuid":"e5c98214-d0f6-11e1-8c30-001d09ef4a24",
"phonenumber":"56311283",
"areacode":"9",
"country_code":"56",
"security_token": "dQ9ORUWRe7ayQqMFQVk+PWEv0brY2tQzMOcyDG5DH5w=",
"adicional":
{
"Nombre": "Juan",
"Email": "jperez@mt2015.com"
}
}
IMPORTANTE
Los parametros phonenumber, areacode y country_code forman el teléfono del cliente a llamar.
El popup_uuid es el uuid de un popup común y corriente de nuestra plataforma, al cual le asignaremos el agente/ejecutivo que contestará las llamadas de los clientes.
El
security_token se genera en panel de administración conforme a las instrucciones detalladas en el artículo «
Generación de Security_Token«. En caso que le sea proporcionado uno por parte de Medularis SpA lo puede usar por lo que no tendría que generar uno nuevo.
El parámetro adicional es opcional, y es donde datos adicionales pueden ser ingresados, estos pueden posteriormente ser utilizados por el TTS (Text-To-Speech
Respuestas
Si el resultado es exitoso:
{"success":true,"uuid":"80b5fc503f24d33de4f15f908f42b279"}
Siendo el uuid el identificador único de la llamada en nuestro sistema.
En caso de que el popup esté configurado para dejar pendientes las llamadas fuera de horario, y el resultado es exitoso:
{"success":true,"pending":true}
Si el resultado es fallido:
{«success»:false,»error_code»: 1,»error_msg»:»Invalid phone number»}
Códigos de error y sus respectivos mensajes:
Invalid phone number
Popup not in service hours
Call origination failed
Popup not found
Country not found
Wrong parameters
Security Token Missing
Invalid Security TokenRespuestas
Acerca de los certificados de seguridad
Nuestros certificados de seguridad son actualizados cada dos meses durante días domingo a las 3:30 de la mañana.
Si usted debe hacer una aprobación de sus certificados de seguridad, le recomendamos correr un proceso que alerte y realice la actualización automáticamente. Puede obtener el certificado requerido en un terminal unix con las siguientes instrucciones:
echo -n | openssl s_client -connect clickandtalk.medularis.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > clickandtalk.medularis.com.cert
Otra opción
Pueden utilizar un certificado auto firmado que vence el 13 de mayo de 2027. Haciendo clic
aquí.