Uso FormCall

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 ClickFono® con otras plataformas, por ejemplo CRM's, formularios en Wix, WordPress, aplicaciones mobile.

El servicio se invoca mediante una solicitud HTTP, utilizando el endpoint:
https://clickandtalk.medularis.com/calls/manage/api


En el header:
content-type: application/json


Y a modo de ejemplo, el siguiente body:
{ 	
  "popup_uuid":"uuid_del_popup",
  "country_code":"56",
  "area_code":"9",
  "phonenumber":"12345678",
  "security_token": "api_token_clickfono",
  "adicional": 
    {
      "Nombre": "Juan",
      "Email": "jperez@mt2015.com"
    }
}

IMPORTANTE
  • Los parámetros phonenumber, areacode, country_code forman el teléfono a llamar.
    • country_code: Es el prefijo según código del país. Ejemplo: Chile "56"
    • areacode: Es el prefijo según código de área. Ejemplo: teléfonos fijos en Santiago "2". Teléfonos móviles todo territorio nacional "9"
    • phonenumber: Es el número sin el código de área (areacode) ni código de país (country_code)
  • El popup_uuid es el identificador único del popup.
  • El security_token se genera en panel de administración conforme a las instrucciones detalladas en este artículo Generación de Security_Token. En caso de que ya se tenga uno proporcionado por el Equipo de ClickFono, lo puede usar por lo que no será necesario 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) y la API Información de llamada.

Respuestas

Si el resultado es exitoso:
{"success":true, "uuid":"80b5fc503f24d33de4f15f908f42b279"}
El uuid el identificador único de la llamada en nuestro sistema.

En caso de que el popup esté configurado para guardar las solicitudes de llamadas en 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:
1. "Invalid phone number" (número a llamar inválido)
2. "Popup not in service hours" (el popup está fuera de horario)
3. "Call origination failed" (problemas de conexión)
4. "Popup not found" (el popup_uuid no existe)
5. "Country not found" (el código de país no existe)
6. "Wrong parameters" (error en los parámetros)
7. "Security Token Missing" (el security_token no está ingresado)
8. "Invalid Security Token" (el security_token no existe)

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

    • Related Articles

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

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

    • Uso del discador online

      La Plataforma ClickFono cuenta con la posibilidad de realizar llamadas salientes de forma manual, es decir, para hacer solicitudes de conexiones de manera individual (Por agente). Esta función es útil para realizar llamadas personalizadas a contactos ...

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