Ejemplos Uso FormCall

Ejemplos Uso FormCall

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 ...