Agregar registro a marcador
Descripción
Todos los datos que esten encerrados por "{{ }}" son valores que serán reemplazado con los datos del propio cliente y/o la instancia correspondiente.
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.
Datos del recurso
| Opcion HTTP | Valor |
| Recurso | /Integra/resources/Dialers/DialerTask |
| Motodo | POST |
Header Request
| Opcion | Valor |
| Content-Type | application/x-www-form-urlencoded |
| Authorization | Basic {{Token}} |
Parametros
| 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 |
HTTP Request
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