ARGENTINA
Buenos Aires +54 (11) 5217 5933
BRASIL
Goiânia +55 (62) 99328 6605
CHILE
Santiago de Chile +56 (2) 240 533 89
https://{{crm_server}}/server/API/v2/custom/reports.php
El API de búsqueda de reportes nos permite mediante el envío de parámetros buscar registros de reportes en los módulos parametrizados de nuestro CRM. Los reportes ya deben estar generados para poder usar la API.
Esta API funciona a través de un cuerpo de tipo “raw” 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:
– En el cuerpo de la petición se requiere:
La URL de las APIs contiene un marcador de posición {{crm_server}} que debe ser sustituido por el servidor específico donde se encuentra la operación del cliente.
Servidores disponibles
Actualmente, los servidores disponibles son:
¿Cómo determinar el servidor del CRM?
Aviso importante: Actualización de rutas de acceso
A partir del 1 de septiembre de 2024, se implementarán nuevas URLs para acceder a la plataforma de wolkvox CRM. Las URLs actuales coexistirán con las nuevas hasta el 30 de noviembre de 2024, fecha en la cual serán deshabilitadas.
Nuevas URLs:
De “https://sv0001.crmvox.com” a “https://crm0001.wolkvox.com“
De “https://sv0000.crmvox.com” a “https://crm0000.wolkvox.com“
Por favor, asegúrate de actualizar tus integraciones y automatizaciones antes del 30 de noviembre de 2024 para evitar interrupciones en el servicio.
Puedes usar los siguientes campos en el cuerpo del request para paginar los resultados con un límite máximo de 250 registros por página:
“limit”: “”
“page”: “”
KEY | DESCRIPCIÓN | EJEMPLO |
---|---|---|
Wolkvox-Token | Es el token configurado por el cliente en la página de CRM. | A8K3J7F2 |
operation | Es el nombre de la operación del CRM. | “operation”:”modulodeprueba” |
name | Es el nombre del reporte, se debe poner exactamente igual al nombre que se parametrizo en el CRM. | “name”:”Reporte de empresas 20230817 versión 1″ |
dateStart | Es el rango inicial para generar la consulta. | “dateStart”:”2023-01-01 00:00:00″ |
dateEnd |
Es el rango final para generar la consulta. | “dateEnd”:”2023-12-31 00:00:00″ |
'https://{{wolkvox_server}}/server/API/v2/custom/reports.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}}",
"name":"{{name}}",
"dateStart":"{{yyyymmddhis}}",
"dateEnd":"{{yyyymmddhis}}"
}',
CURLOPT_HTTPHEADER => array(
'Wolkvox-Token: {{Wolkvox-Token}}',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
curl --location --request POST 'https://{{wolkvox_server}}/server/API/v2/custom/reports.php' \
--header 'Wolkvox-Token: {{Wolkvox-Token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"operation":"{{Wolkvox-Token}}",
"name":"{{name}}",
"dateStart":"{{yyyymmddhis}}",
"dateEnd":"{{yyyymmddhis}}"
}'
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"operation\":\"{{operation}}\",\r\n \"name\":\"{{name}}\",\r\n \"dateStart\":\"{{yyyymmddhis}}\",\r\n \"dateEnd\":\"{{yyyymmddhis}}\"\r\n}");
Request request = new Request.Builder()
.url("https://{{wolkvox_server}}/server/API/v2/custom/reports.php")
.method("POST", body)
.addHeader("Wolkvox-Token", "{{Wolkvox-Token}}")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
import requests
import json
url = "https://{{wolkvox_server}}/server/API/v2/custom/reports.php"
payload = json.dumps({
"operation": "{{operation}}",
"name": "{{name}}",
"dateStart": "{{yyyymmddhis}}",
"dateEnd": "{{yyyymmddhis}}"
})
headers = {
'Wolkvox-Token': '{{Wolkvox-Token}}',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
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 edit record” |
data | Es el conjunto de información obtenido como resultado de haber hecho la solicitud. | {
“code”: “200”,
“error”: “null”,
“msg”: “2 records were are found”,
“data”: [
{
“Company ID”: 12345,
“Company name”: “Tech Solutions Inc.”,
“Email”: “[email protected]”,
“wolkvox_id”: “64dc”
},
{
“Company ID”: 1001,
“Company name”: “GreenTech Innovations Ltd.”,
“Email”: “[email protected]”,
“wolkvox_id”: “64dcf”
}
]
} |
{
"code": "200",
"error": "null",
"msg": "X records were are found",
"data": []
}
Medellín +57 (604) 322 98 80
Bogotá +57 (601) 381 90 40
Cali +57 (602) 891 28 46
Barranquilla +57 (605) 316 10 34
Goiânia +55 (62) 99328 6605
Santiago de Chile +56 (2) 240 533 89
Atlanta +1 (678) 496 7474
Ciudad de Guatemala +502 (2) 314 1344
Ciudad de México +52 (55) 8526 36 34
Copyright © 2022 MICROSYSLABS S.A.S. Todos los derechos reservados. Cra 30 # 4A-45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia
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
Copyright © 2022 MICROSYSLABS S.A.S.
Todos los derechos reservados.
Cra 30 # 4A – 45 Of. 205 Ed. FOREVER W&L, Medellín, Colombia
Usamos cookies, se continuar a navegar assumimos que concorda. Pode ler mais sobre a utilização de cookies nas nossas políticas de privacidade e tratamento de dados pessoais
Hacemos uso de cookies, si continúas navegando asumiremos que estás de acuerdo. Puede leer más sobre el uso de cookies en nuestras políticas de privacidad y tratamiento de datos personales