Ejemplos en distintos lenguajes para el Uso de 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.
A continuación detallamos ejemplos en distintos lenguajes:
- PHP
/*
Ejemplo para el utilizar FormCall usando PHP
*/
// URL endpoint
$url_api = 'https://clickandtalk.medularis.com/calls/manage/api';
// init curl
// Necesitas tener activado php-curl en tu sistema
// generalmente en sistemas Linux el paquete se llamada php-curl
$ch = curl_init($url_api);
// Data para pasarle al API según documentación: Uso de FormCall
// En el siguiente ejemplo usamos para llamar a un celular en Chile
// +56974766123
$jsonData = array(
"popup_uuid" => "MIPOPUP-UUID",
"phonenumber" => "74766123",
"areacode" => "9",
"country_code" => "56",
"security_token" => "MI_TOKEN", // Generación de security token
"adicional" => array(
"Nombre" => "Mi Nombre",
"Rut" => "11.111.111-1",
)
);
// Encodeamos los datos del Array como JSON
$jsonDataEncoded = json_encode($jsonData);
// Indica que los datos se van a enviar en POST·
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonDataEncoded);
// Seteo de headre como JSON
// content-type: application/json
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
// en $result obtienes la respuesta del API
// podrias obtener un resultado como
// {"success":true,"uuid":"uuid-de-la-llamada"}
// Con este uuid puedes obtener en tiempo real su estado
// Estados de las llamadas FormCall
$result = curl_exec($ch);
- Ruby
require 'uri'
require 'openssl'
require 'net/http'
require 'json'
# Ejemplo para el utilizar el API Clickfono usando Ruby 2
# URL endpoint
url = URI('https://clickandtalk.medularis.com/calls/manage/api')
# Crea un agente cliente HTTP
http = Net::HTTP.new(url.host, url.port)
# Indicar usar SSL para HTTPS
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_PEER
# Enviaremos los datos en POST y seteamos el Content-Type
request = Net::HTTP::Post.new(url, 'Content-Type' => 'application/json')
# Data para usar al API segun documentacion: Uso de FormCall
# En el siguiente ejemplo usamos para llamar a un celular en Chile
# +56974766123
parameters = {
"popup_uuid" => "MIPOPUP-UUID",
"phonenumber" => "74766123",
"areacode" => "9",
"country_code" => "56",
"security_token" => "MI_TOKEN", # Generación de security token
"adicional" => {
"Nombre" => "Mi Nombre",
"Rut" => "11.111.111-1",
}
}
request.body = parameters.to_json
response = http.request(request)
# en result obtienes la respuesta del API
# podrias obtener un resultado como
# {"success":true,"uuid":"uuid-de-la-llamada"}
# Sobre la respuesta del API esta documentada en
# https://help.clickfono.com/article/6-uso-api-clickfono
#
# Con este uuid puedes obtener en tiempo real su estado
# Estados de las llamadas FormCall
result = response.read_body
/*
Ejemplo para el utilizar FormCall usando Javascript + JQuery
*/
urlAPI = 'https://clickandtalk.medularis.com/calls/manage/api';
/*
* Data para enviar mediante POST al API segun documentacion: Uso de FormCall
* En el siguiente ejemplo usamos para llamar a un celular en Chile
* +56974766123
*/
var parameters = {
"popup_uuid": "MIPOPUP-UUID",
"phonenumber": "74766123",
"areacode": "9",
"country_code": "56",
"security_token": "MI_TOKEN", // Generación de security token
"adicional": {
"Nombre": "MI Nombre",
"Email": "11.111.111-1"
},
};
// Tambien podrias usar jQuery.post() -> https://api.jquery.com/jQuery.post/
jQuery.ajax({
url: urlAPI,
data: parameters,
type: 'POST', // Usando Post
success: function(result) {
// en result obtienes la respuesta del API
// podrias obtener un resultado como
// {"success":true,"uuid":"uuid-de-la-llamada"}
// Con este uuid puedes obtener en tiempo real su estado
// Estados de las llamadas FormCall
console.log(result);
},
dataType: 'json'
});
/*
Ejemplo para el utilizar FormCall usando Node.js
*/
var request = require('request');
urlAPI = 'https://clickandtalk.medularis.com/calls/manage/api';
/*
* Data para enviar mediante POST al API segun documentacion: Uso de FormCall
* En el siguiente ejemplo usamos para llamar a un celular en Chile
* +56974766123
*/
var parameters = {
"popup_uuid": "MIPOPUP-UUID",
"phonenumber": "74766123",
"areacode": "9",
"country_code": "56",
"security_token": "MI_TOKEN", // Generación de security token
"adicional": {
"Nombre": "MI Nombre",
"Email": "11.111.111-1"
},
};
request({
url: urlAPI,
json: parameters,
method: 'POST', // Usando Post
}, function(error, response, result) {
// en result obtienes la respuesta del API
// podrias obtener un resultado como
// {"success":true,"uuid":"uuid-de-la-llamada"}
// Con este uuid puedes obtener en tiempo real su estado
// Estados de las llamadas FormCall
console.log(result);
});
import requests # http://docs.python-requests.org/
"""
Ejemplo para el utilizar el API Clickfono usando Python
"""
# URL endpoint
url_api = 'https://clickandtalk.medularis.com/calls/manage/api'
"""
Data para enviar mediante POST al API segun documentacion: Uso de FormCall
En el siguiente ejemplo usamos para llamar a un celular en Chile
+56974766123
"""
parameters = {
"popup_uuid": "MIPOPUP-UUID",
"phonenumber": "74766123",
"areacode": "9",
"country_code": "56",
"security_token": "MI_TOKEN", # Generación de security token
"adicional": {
"Nombre": "MI Nombre",
"Email": "11.111.111-1"
},
}
r = requests.post(url_api, data=parameters)
# en result obtienes la respuesta del API
# podrias obtener un resultado como
# {"success":true,"uuid":"uuid-de-la-llamada"}
# Con este uuid puedes obtener en tiempo real su estado
# Estados de las llamadas FormCall
result = r.text
Related Articles
Uso FormCall
¿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 ...
Estados de las Llamadas FormCall
API de estados para clientes de FormCall Trasfondo Para el uso de FormCall en aplicaciones que requieren, o se benefician, de feedback continuo sobre el estado de la llamada a los usuarios es necesario de un endpoint que pueda entregar el estado ...
Reglas de SPAM en FormCall – API
Debido a que el flujo de las llamadas son separadas para FormCall y los Pop-Up ClickFono, también así son las reglas de spam: FormCall – API Hay dos filtros de spam para FormCall, cuando la llamada es encolada (call_session_validator.php) Las ...
Glosario de Términos
Términos básicos utilizados. Término Definición Llamada Exitosa Llamada con duración cliente igual o mayor a 25 segundos. Personalización de Pop-up «Al presionar el botón de acción para solicitar el llamado instantáneo, al usuario se le pide su ...
Funciones avanzadas
- Conexión Exitosa Una conexión o llamada exitosa es aquella comunicación efectiva entre el solicitante web y el ejecutivo que contesta la llamada, cuya duración sea mayor a 25 segundos. - Conexión o Minuto Extra Estas tarifas sólo se cobrarán si ...