Agregar registro a marcador
Agrega un registro a un marcador para lanzar la llamada en cuanto se tenga algún agente disponible, este registro serrá agregado a la cola, es decir se marcarán primero los registros que ya estaban en la cola independientemente, esta cola solo tomará encuenta los registros que no pertenecena una lista de marcación.
Usted puede verificar la Colección de Postman para ver un ejemplo y probar con su instancia.
Todos los datos que esten encerrados por "{{ }}" son valores que serán reemplazado con los datos del propio cliente y/o la instancia correspondiente
HTTP Request
Metodo | Recurso |
POST | /Integra/resources/Dialers/DialerTask |
Request Header
Clave | Valor |
Content-Type | application/x-www-form-urlencoded |
Authorization | Basic {{Token}} |
Request Body
Parametro | Tipo | Requerido | Descripción |
call |
JSON String (String) | Si | Objeto Json convertido a texto en donde se agreguen los datos agregados en el siguient ejemplo |
Ejemplo JSON
Los datos agregados en el siguiente ejemplo son meramente demostrativos, tendrá que reemplazar los datos con los correspondiente a su instancia.
{
"calldate" : null, // En caso de requerir se llame a una hora en especifico, ejemplo: '1900-01-01 00:00:00'
"campaign" : "POWER<-", // Nombre de la campaña a agregar el registro
"destination": "0123456789", // Numero de teléfono al cual se realizará la marcación
"alternatives": "", // Numero alternativo al cual realizarle la llamada en caso de no contactar con el primer teléfono
"agent" : "", // Telefono/Extensión del agente en caso de querer que un agente en especifico tome la llamada
"data": "idcustomer=7", // Datos para mostrar en el formulario de la instancia o para utilizarlos para algo en especifico
"source": "source", // Pendiente
"bulk": false, // Pendiente
"automatic": true // Pendiente
}
Descripción de Objeto JSON
En el JSON todos las Key deben estar agregadas, si el campo menciona que no es oblicatorio puede ser agregado con un valor vacio.
Parametro | Tipo | Requerido | Descripción |
calldate | Texto (String) | No | Define la hora en la cual se realizará la marcación, puede ser 'null' o fecha en formato '1900-01-01 00:00:00'. |
campaign | Texto (String) | Si | Nombre de la campaña a la cual se agregará el registro |
destination | Texto (String) | Si | Numero de teléfono al cual se marcará |
alternatives | Texto (String) | No | Numero alternativos a contactar en caso no se logre contacto con el primer numero, puede ser vacio. |
agent | Texto (String) | No | Numero del teléfono/extensión del agente en caso de requerir que un agente en especifico tome la llamada |
data | Texto (String) | No | Datos a agregar para mostrarse en formularios, encuestas o para algún otro propocito dentro de la plataforma. |
source | Texto (String) | Si | |
bulk | Booleano (Boolean) | Si | |
automatic | Booleano (Boolean) | Si |
Ejemplos de codigo
Puede copiar los siguientes ejemplos de codigo y reemplazar las variables "{{variable}}" con los datos correctos.
HTTP
POST /Integra/resources/Dialers/DialerTask HTTP/1.1
Host: {{Instance}}.ucontactcloud.com
Authorization: Basic {{Token}}
Content-Type: application/x-www-form-urlencoded
Content-Length: 310
call={{Objeto Json}}
cURL
curl --location --request POST 'https://testclever.ucontactcloud.com/Integra/resources/Dialers/DialerTask' \
--header 'Authorization: Basic VmNpc25lcm9zOjY3NDdjODIzLWY5ZmItNDY0My05NTc0LWNjMjJhOTlhZDRlMQ==' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'call={"calldate" : null,"campaign" : "POWER<-","destination": "1234567890","alternatives": "","agent" : "","data": "idcustomer=7","source": "source","bulk": false,"automatic": true }'
JavaScript
var myHeaders = new Headers();
myHeaders.append("Authorization", "Basic {{Token}}");
myHeaders.append("Content-Type", "application/x-www-form-urlencoded");
var urlencoded = new URLSearchParams();
urlencoded.append("call", "{\"calldate\" : null,\"campaign\" : \"POWER<-\",\"destination\": \"0123456789\",\"alternatives\": \"\",\"agent\" : \"\",\"data\": \"idcustomer=7\",\"source\": \"source\",\"bulk\": false,\"automatic\": true }");
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: urlencoded,
redirect: 'follow'
};
fetch("https://{{Instance}}.ucontactcloud.com/Integra/resources/Dialers/DialerTask", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
JQuery
var settings = {
"url": "https://{{Instance}}.ucontactcloud.com/Integra/resources/Dialers/DialerTask",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Basic {{Token}}",
"Content-Type": "application/x-www-form-urlencoded"
},
"data": {
"call": "{\"calldate\" : null,\"campaign\" : \"POWER<-\",\"destination\": \"0123456789\",\"alternatives\": \"\",\"agent\" : \"\",\"data\": \"idcustomer=7\",\"source\": \"source\",\"bulk\": false,\"automatic\": true }"
}
};
$.ajax(settings).done(function (response) {
console.log(response);
});
C#
var client = new RestClient("https://{{Instance}}.ucontactcloud.com/Integra/resources/Dialers/DialerTask");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Basic {{Token}}");
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddParameter("call", "{\"calldate\" : null,\"campaign\" : \"POWER<-\",\"destination\": \"0123456789\",\"alternatives\": \"\",\"agent\" : \"\",\"data\": \"idcustomer=7\",\"source\": \"source\",\"bulk\": false,\"automatic\": true }");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "call={\"calldate\" : null,\"campaign\" : \"POWER<-\",\"destination\": \"0123456789\",\"alternatives\": \"\",\"agent\" : \"\",\"data\": \"idcustomer=7\",\"source\": \"source\",\"bulk\": false,\"automatic\": true }");
Request request = new Request.Builder()
.url("https://{{Instance}}.ucontactcloud.com/Integra/resources/Dialers/DialerTask")
.method("POST", body)
.addHeader("Authorization", "Basic {{Token}}")
.addHeader("Content-Type", "application/x-www-form-urlencoded")
.build();
Response response = client.newCall(request).execute();
Python
import http.client
conn = http.client.HTTPSConnection("{{Instance}}.ucontactcloud.com")
payload = 'call={{Objeto Json}}'
headers = {
'Authorization': 'Basic {{Token}}',
'Content-Type': 'application/x-www-form-urlencoded'
}
conn.request("POST", "/Integra/resources/Dialers/DialerTask", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
HTTP Response
Respuesta Exitosa
1
Respuesta de error
0