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

Insertar casos con adjuntos

< / >

Insert

Insertar casos con adjuntos

URL:

https://{{wolkvox_server}}/server/API/v2/custom/insert.php

Descripción:

La siguiente configuración de la API nos permite agregar casos con archivos adjuntos.

¿Cómo funciona?:

Esta API funciona a través de 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: {{token}}
Content-Type: application/json

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

operation
case-type
responsible
owner
contact
description
form
status
priority
attachments

REQUEST

KEY	DESCRIPCIÓN	EJEMPLO
Wolkvox-Server	Nomenclatura del servidor de la operación.	‘https://wolkvox_server.crmvox.com/server/API/v2/cases/insertAttach.php’
Wolkvox-Token	Token generado en el módulo de CRM en donde vas a consumir la API.	‘Wolkvox-Token: token’
operation	Nombre de la operación.	“operation”: “TheOperationName”
case-type	Tipo de caso.	“case-type”: “Request”
responsible	Responsable del caso.	“responsible”: “ADMIN_@mymodule”
owner	Dueño del caso.	“owner”: “ADMIN_@mymodule”
contact	Contacto relacionado con el caso.	“contact”: “[email protected]”
description	Descripción del caso.	“description”: “Esta es la descripción del caso”
form	Este campo se utiliza para especificar detalles adicionales del caso.	“form”:{ “Subject”: “Este es un campo adicional creado en el CRM” }
status	Indica el estado actual del caso.	“status”: “abierto”
priority	Establece la prioridad del caso.	“priority”: “baja”
attachments	Aquí puedes agregar archivos adjuntos al caso.	“attachments”: [ ]

REQUEST

				
					$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://{{wolkvox_server}}/server/API/v2/cases/insertAttach.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 =>'{
    "operation":"{{operation}}",
    "case-type":"{{case type}}",
    "responsible":"{{responsible}}",
    "owner":"{{owner}}",
    "contact":"{{contact}}",
    "description":"{{description}}",
    "form":{
      "Subject": "{{subject}}"
    },
    "status": "{{status}}",
    "priority":"{{priority}}",
    "attachments": [  ]
}',
  CURLOPT_HTTPHEADER => array(
    'Wolkvox-Token: {{token}}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

				
					curl --location 'https://{{wolkvox_server}}/server/API/v2/cases/insertAttach.php' \
--header 'Wolkvox-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operation":"{{operation}}",
    "case-type":"{{case-type}}",
    "responsible":"{{responsible}}",
    "owner":"{{owner}}",
    "contact":"{{contact}}",
    "description":"{{description}}",
    "form":{
      "Subject": "{{subject}}"
    },
    "status": "{{status}}",
    "priority":"{{priority}}",
    "attachments": [  ]
}'

				
					OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"operation\":\"{{operation}}\",\r\n    \"case-type\":\"{{case-type}}\",\r\n    \"responsible\":\"{{responsible}}\",\r\n    \"owner\":\"{{owner}}\",\r\n    \"contact\":\"{{contact}}\",\r\n    \"description\":\"{{description}}\",\r\n    \"form\":{\r\n      \"Subject\": \"{{subject}}\"\r\n    },\r\n    \"status\": \"{{status}}\",\r\n    \"priority\":\"{{priority}}\",\r\n    \"attachments\": [  ]\r\n}");
Request request = new Request.Builder()
  .url("https://{{wolkvox_server}}/server/API/v2/cases/insertAttach.php")
  .method("POST", body)
  .addHeader("Wolkvox-Token", "{{token}}")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

				
					import requests
import json

url = "https://{{Wolkvox_Server}}/server/API/v2/cases/insertAttach.php"

payload = json.dumps({
  "operation": "{{operation}}",
  "case-type": "{{case-type}}",
  "responsible": "{{responsible}}",
  "owner": "{{owner}}",
  "contact": "{{contact}}",
  "description": "{{description}}",
  "form": {
    "{{campo-adicional}}": "{{valor-del-campo-adicional}}"
  },
  "status": "{{status}}",
  "priority": "{{priority}}",
  "attachments": []
})
headers = {
  'Wolkvox-Token': '{{token}}',
  'Content-Type': 'application/json'
}

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

print(response.text)

RESPONSE

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

Posibles códigos de error