COLOMBIA Medellín +57 (4) 322 98 80 Bogotá +57 (1) 381 90 40 Cali +57 (2) 891 28 46 Barranquilla +57 (5) 316 10 34 ARGENTINA Buenos Aires +54 (11) 5217 5933 ESPAÑA Madrid +34 (910) 601 691 MÉXICO Ciudad de México +52 (55) 8526 36 34 BRASIL Brasilia +55 (61) 9836 4127 São Paulo +55 (12) 9811 155 83 ESTADOS UNIDOS New York +1 (914) 373 71 36 REPÚBLICA DOMINICANA Santo Domingo +1 (829) 249 69 68 CHILE Santiago de Chile +56 (2) 240 533 89 GUATEMALA Ciudad de Guatemala +502 (2) 314 1344 PERÚ Lima +51 (1) 644 91 39

Actualizar casos

< / >

Cases Update

Actualizar casos

URL:

https://{{wolkvox_server}}/server/API/v2/cases/update.php

Descripción:

El API de actualizar casos nos permite mediante el envío de parámetros actualizar registros exclusivamente en dicho módulo ya configurado.

¿Cómo funciona?:

Esta API funciona a través de un cuerpo de tipo “form-data” y una petición en POST la cual requiere para su correcto funcionamiento los siguientes campos:

– En las cabeceras de la petición se requiere:

Wolkvox-Token

– En el cuerpo de la petición se requiere:

operation
wolkvox-id
case-type
responsible
status
priority
form
file

REQUEST

KEY	DESCRIPCIÓN	EJEMPLO
Wolkvox-Token	Es el token configurado por el cliente en la página de CRM.	A8K3J7F2
wolkvox-id	Es el id o identificación del registro en el módulo.	6074xxx0801374xxxxx781025xxx7d3
operation	Es el nombre de la operación del CRM.	modulodeprueba
case-type	Es el tipo de caso.	Request
responsible	Es el responsable del caso.	user@operation
status	Es el estado del caso.	open
priority	Es la prioridad del caso.	low
solution	Fin o resultado del proceso ejercido. Aquí va la solución al caso si el estado del caso tiene la condición “cerrado”. Por lo tanto llenar este campo no es requisito cuando el estado del caso es establecido con una condición de “abierto”.	Esto es un ejemplo de solución a un caso.
form	Son los campos personalizados que tenemos parametrizados en nuestro CRM. Primero va el nombre del campo (name_field) y luego el valor que se va a ingresar en el campo (value_field). Los campos personalizados se van separando con una coma.	{“name_field”:”value_field”, “name_field”:”value_field”}
file	Son los archivos adjuntos. Los formatos compatibles son los siguientes: .xlsx, .csv .pdf .jpg .png .docx .mp4 .mp3 .wmv .wma .wap .doc .jpeg .avi .bmp .bpm .avi .mov .tiff .docx .zip .7z .rar

REQUEST

				
					<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://{{wolkvox_server}}/server/API/v2/cases/update.php',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('operation' => '{operation}','wolkvox-id' => '{wolkvox-id}','responsible' => '{responsible}','status' => '{status}','solution' => '{solution}','form' => '{}','files'=> new CURLFILE('/path/to/file')),
  CURLOPT_HTTPHEADER => array(
    'Wolkvox-Token: {Wolkvox-Token}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
					curl --location --request POST 'https://{{wolkvox_server}}/server/API/v2/cases/update.php' \
--header 'Wolkvox-Token: {Wolkvox-Token}' \
--form 'operation="{operation}"' \
--form 'wolkvox-id="{wolkvox-id}"' \
--form 'responsible="{responsible}"' \
--form 'status="{status}"' \
--form 'solution="{solution}"' \
--form 'form="{}"' \
--form 'files=@"/path/to/file"'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("operation","{operation}")
  .addFormDataPart("case-type","{case-type}")
  .addFormDataPart("responsible","{responsible}")
  .addFormDataPart("owner","{owner}")
  .addFormDataPart("contact","{contact}")
  .addFormDataPart("description","{description}")
  .addFormDataPart("status","{status}")
  .addFormDataPart("priority","{priority}")
  .addFormDataPart("form","{}")
  .build();
Request request = new Request.Builder()
  .url("https://{{wolkvox_server}}/server/API/v2/cases/update.php")
  .method("POST", body)
  .addHeader("Wolkvox-Token", "{Wolk_Token}")
  .build();
Response response = client.newCall(request).execute();

				
					import requests

url = "https://{{wolkvox_server}}/server/API/v2/cases/update.php"

payload={'operation': '{operation}',
'wolkvox-id': '{wolkvox-id}',
'responsible': '{responsible}',
'status': '{status}',
'solution': '{solution}',
'form': '{}'}
files=[
  ('files',('file',open('/path/to/file','rb'),'application/octet-stream'))
]
headers = {
  'Wolkvox-Token': '{Wolkvox-Token}'

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

RESPONSE

KEY	DESCRIPCIÓN	EJEMPLO
code	Indica el código de estado de la respuesta.	“code”: 200
error	Proporciona detalles sobre el error que ocurrió durante la solicitud.	“error”: “null”
msg	Muestra un mensaje descriptivo sobre el resultado de la solicitud.	“msg”: “Succesfully update record”
data	Es el conjunto de información obtenido como resultado de haber hecho la solicitud.	“data”: { “wolkvox_id”: “64cb” }
wolkvox_id	Es la identificación del registro en el módulo.	“wolkvox_id”: “64cb”

				
					{
    "code":200,"error":"null","msg":"Succesfully update record","data":{"wolkvox_id":""}
}

Posibles códigos de error