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 segun documentacion
    // https://help.clickfono.com/article/6-uso-api-clickfono
    // 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", // https://help.clickfono.com/article/25-generacion-de-securitytoken
        "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  https://help.clickfono.com/article/6-uso-api-clickfono
    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
    // https://help.clickfono.com/article/24-estados-de-las-llamadas-api
    $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
# https://help.clickfono.com/article/6-uso-api-clickfono
# 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", # https://help.clickfono.com/article/25-generacion-de-securitytoken
  "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
# https://help.clickfono.com/article/24-estados-de-las-llamadas-api
result = response.read_body

JavaScript + JQuery

/*
   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
 * https://help.clickfono.com/article/6-uso-api-clickfono
 * 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",  // https://help.clickfono.com/article/25-generacion-de-securitytoken
  "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
        // https://help.clickfono.com/article/24-estados-de-las-llamadas-api
        console.log(result); 
     },
    dataType: 'json'
});

Node.js

/*
   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
 * https://help.clickfono.com/article/6-uso-api-clickfono
 * 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",  // https://help.clickfono.com/article/25-generacion-de-securitytoken
  "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
        // https://help.clickfono.com/article/24-estados-de-las-llamadas-api
        console.log(result); 
    });

Python

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
 https://help.clickfono.com/article/6-uso-api-clickfono 
 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",  # https://help.clickfono.com/article/25-generacion-de-securitytoken 
  "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 
# https://help.clickfono.com/article/24-estados-de-las-llamadas-api 
result = r.text