Desde Configuración Canales, agregar un nuevo canal Webhooks:
\n![\"alt](\"https://ss.wcx.cloud/a/08wc10/2020-12/f392e8bb000644d9a000f10306febcf2.jpg\")
\n Completar los campos requeridos:
\nLa API de Wise CX permite realizar operaciones 'RESTful' como leer, modificar, agregar o eliminar datos.
\nTodas las operaciones necesitan la cabecera Authorization Bearer. Es necesario obtener el Token JWT provisto en el endpoint /authenticate para luego ser usado en esta cabecera.
\n\nImportante: La cabecera
\nx-api-keytambién debe enviarse en todas las llamadas a la API, no solo en el llamado a/authenticate. Omitirla resultará en un error403 Forbidden.
El Token de autenticación tiene una validez de 3600 seg, es necesario volver a ejecutar la autenticación luego de pasado este tiempo para obtener un nuevo Token.
\nEl límite de requests es de 5000 por minuto y un total de 150000 por día, no es posible exceder estos límites.
\n200: Success
\n400: Bad request
\n403: Unauthorized
\n501: Method not implemented
\nEste parámetro indica los campos que se mostraran en la respuesta al ejecutar el endpoint, es utilizado para devolver únicamente los campos más relevantes.
Si se omite este parámetro, solo se mostraran los campos por defecto.
Ejemplo,
/cases?fields=id,subject,status
Este parámetro es utilizado para filtrar y realizar búsquedas más avanzadas sobre el recurso solicitado.
\nEjemplo,
\n/cases?filtering=[{'field':'case.contact_id','operator':'EQUAL','value':'123'},{'field':'case.status','operator':'IN','value':['opened','solved']}]
En Postman, para poder ejecutar un request con filtering, se debe reemplazar usando un encoding especial para las llaves:
\nEs decir que en Postman para aplicar un filtering, quedaría de la siguiente manera:
\nPosibles Operadores:
\nEste parámetro indica el campo y dirección de ordenamiento en el que se devolverán los recursos. El orden por defecto es asc.
Ejemplo,
/cases?sort=desc&sort_field=id
Todas las operaciones de listado son paginadas por defecto. El límite máximo y por defecto es de 100 registros.
\n/cases?limit=20&page=5
La autenticación es necesaria para obtener el Token JWT y luego agregarlo en la cabecera Authorization para acceder a todos los recursos de la API.
Para autenticar, es necesario hacer un GET con la cabecera x-api-key y el parámetro user.
Si la solicitud se ejecuta correctamente, devuelve el Token JWT de autenticación necesario para consumir los recursos de la API.
Para poder autorizar y obtener el Token, es necesario previamente generar una Api Key desde Settings -> Canales -> Api:
\n![](\"https://ss.wcx.cloud/a/08wc10/2022-03/lo4PmSYh8g.png\")
\n\nLuego se debe ingresar un nombre de usuario y finalmente presionar el botón \"Generar\" para obtener el Api Key que deberá enviarse en la llamada /authenticate
\nEl Token de autenticación tiene una validez de 3600 seg, es necesario volver a ejecutar la Autenticación luego de pasado este tiempo para obtener un nuevo Token.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","authenticate"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"b6555651-ca3b-412b-982c-7320898ae064","name":"Authenticate","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/authenticate?user=adminUser","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","authenticate"],"query":[{"key":"user","value":"adminUser"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"637"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 08 Jan 2020 17:58:35 GMT"},{"key":"x-amzn-RequestId","value":"2b0042e9-62c9-4731-b088-df1499856359"},{"key":"x-amz-apigw-id","value":"F_i7zGktoAMF9qQ="},{"key":"X-Amzn-Trace-Id","value":"Root=1-5e16184b-b1ec7f2e61557d1e203f4a36;Sampled=0"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 171d7370ca264be0e555ac6695616d94.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"EZE51-C1"},{"key":"X-Amz-Cf-Id","value":"84lEw9XDIImZq8l0gAs8OsoQIdhE-bDvVCUmacBiYnJbzpvdSLSAJg=="}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"token\": \"\",\n \"message\": \"Authentication success.\"\n}"}],"_postman_id":"1c1d91ef-9e86-48cb-9f31-bbd9e2fb344c"}],"id":"a9abccc0-7650-4c41-b070-0c92fd2be681","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"6a4fd596-6009-4206-8259-2f44f0152774"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"3fc95e9d-b710-4132-a570-bd6f1a8a5115"}}],"_postman_id":"a9abccc0-7650-4c41-b070-0c92fd2be681","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}}},{"name":"Casos","item":[{"name":"Tipos","item":[{"name":"Obtención de Tipos","id":"b9c28b9b-cd5d-4861-842c-30697e0a7aed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/cases/types","description":"Para la obtención del listado de Tipos, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,name,parent_id
El endpoint types permite obtener el listado de Tipos de Wise Cx.
Para la obtención del listado de Etiquetas, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,name
El endpoint tags permite obtener el listado de Etiquetas de Wise CX.
Para la obtención de las opciones de los campos personalizados de tipo lista desplegable, se debe hacer un GET indicando mediante el parámetro field_name el nombre api, el cual se obtiene desde la configuración del campo en power inbox.
La actualización permite modificar el valor de una opción de la lista desplegable, para ello se debe hacer un PUT con el siguiente objeto:
Para la eliminación de una opción de la lista desplegable, se debe hacer un DELETE indicando el field_name del campo y la opción que se quiere eliminar.
Para la creación de una nueva opción de la lista desplegable, se debe hacer un POST con el siguiente objeto:
El endpoint fields permite obtener, crear, modificar y eliminar las opciones de los campos personalizados de tipo lista desplegable.
Para la creación de un nuevo Caso, se debe hacer un POST con el siguiente objeto:
El objeto activity se debe enviar de la siguiente manera:
Objeto contact:
Objeto template:
Objeto template_parameter:
Objeto custom_fields:
Objeto attachments:
En caso de enviar el objeto attachments con el campo content, la suma de los archivos enviados en un mismo request, no debe superar los 5MB.
Cuando se envíe un mensaje o template de whatsapp, solo se tendrá en cuenta al primer contacto dentro del objeto contacts_to.
En el caso de envío de un template de WhatsApp, source_channel debe ser whatsapp y se deberá incluir el objeto template en una actividad del tipo user_reply. El user_id deberá ser de un usuario válido o bien dejar en \"0\" si se desea que la respuesta del cliente ingrese a las colas normalmente.
Para el envío de un mensaje de sesión, la actividad debe user_reply y ya no es necesario incluir el objeto template pero si el content.
La actualización de un caso permite agregar nuevas actividades a un Caso existente y también editar sus campos, para ello se debe hacer un PUT con el siguiente objeto:
El objeto activity se debe enviar de la siguiente manera:
Objeto contact:
Objeto template:
Objeto template_parameter:
Objeto custom_fields:
Objeto attachments:
Cuando se envíe un mensaje o template de whatsapp, solo se tendrá en cuenta al primer contacto dentro del objeto contacts_to.
Al ser un mensaje dentro de una conversación ya existente, se validará que el objeto contact_to sea el mismo que dió inicio a la conversación.
Para la obtención del listado de Casos, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran.asdasd
\n\nIMPORTANTE:
\n
Mediante este endpoint solo es posible obtener los casos de los últimos 3 meses en adelante.
Los posibles campos son:
\nPara ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","cases"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"c320ef2a-a8de-4533-94ca-722e530e4c2b","name":"Obtención de Casos","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/cases?fields=id,subject,group_id,user_id,created_at","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","cases"],"query":[{"key":"fields","value":"id,subject,group_id,user_id,created_at"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1273952,\n \"group_id\": 1234,\n \"user_id\": 0,\n \"subject\": \"Caso desde api 1\",\n \"created_at\": \"2020-01-28 18:48:38\"\n },\n {\n \"id\": 1273951,\n \"group_id\": 1234,\n \"user_id\": 0,\n \"subject\": \"Caso desde api 2\",\n \"created_at\": \"2020-01-28 18:45:43\"\n },\n {\n \"id\": 1273950,\n \"group_id\": 1234,\n \"user_id\": 0,\n \"subject\": \"Caso desde api 3\",\n \"created_at\": \"2020-01-28 18:39:42\"\n }\n]"}],"_postman_id":"3a04b4da-8f86-4372-a21f-b62265155c52"},{"name":"Obtención de Caso por Id","id":"6069f4a7-2db9-4004-b04a-919ef4d71185","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/cases/{{id}}","description":"Para la obtención del detalle de un Caso, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,number,group_id,user_id,contact_id,status,source_channel,tags,type_id,subject,priority,due_at,custom_fields,created_at,solved_at,closed_at,last_update,sla_result,channel_account,bot_resolved,bot_attended,summary
Para la eliminación del detalle de un Caso, se debe hacer un DELETE indicando el Id del caso a eliminar.
Para transferir un Caso a otro grupo de atención o usuario, se debe hacer un PUT indicando el id del caso en la URL y enviando el siguiente objeto:
Para actualizar únicamente el estado de un Caso, se debe hacer un PUT indicando el id del caso en la URL y enviando el siguiente objeto:
Para la obtención del listado de Actividades asociadas a un Caso, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,case_id,type,user_id,channel,content,contact_from,contacts_to,attachments,recordings,created_at,sending_status
Para ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","cases","{{id}}","activities"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"e37a1323-9227-418a-b698-b2628bc2d970","name":"Obtención de Actividad de un Caso","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/cases/1273934/activities?fields=id,type,user_id,content,contact_from,contacts_to,attachments,created_at,sending_status,channel","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","cases","1273934","activities"],"query":[{"key":"fields","value":"id,type,user_id,content,contact_from,contacts_to,attachments,created_at,sending_status,channel"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": 4056876,\r\n \"type\": \"system\",\r\n \"user_id\": 0,\r\n \"channel\": \"web\",\r\n \"content\": \"[added_tag] tag-1, tag-2\",\r\n \"contact_from\": null,\r\n \"contacts_to\": null,\r\n \"attachments\": null,\r\n \"created_at\": \"2020-01-28 10:08:02\",\r\n \"sending_status\": \"ok\"\r\n },\r\n {\r\n \"id\": 4056878,\r\n \"type\": \"contact_message\",\r\n \"user_id\": 0,\r\n \"channel\": \"web\",\r\n \"content\": \"Envio de archivo adjunto\",\r\n \"contact_from\": {\r\n \"id\": 6579207,\r\n \"email\": \"test@gmail.com\",\r\n \"name\": \"\",\r\n \"phone\": \"\",\r\n \"personal_id\": \"\",\r\n \"custom_fields\": []\r\n },\r\n \"contacts_to\": null,\r\n \"attachments\": [\r\n {\r\n \"filename\": \"file.jpg\",\r\n \"attachment_id\": 0,\r\n \"url\": \"/FileAdm/DownloadFile.aspx?file=341010ssdfe8dd44e633ddbd829.jpg&e=16&t=12711\"\r\n }\r\n ],\r\n \"created_at\": \"2020-01-28 10:08:03\",\r\n \"sending_status\": \"ok\"\r\n },\r\n {\r\n \"id\": 4056880,\r\n \"type\": \"system\",\r\n \"user_id\": 6405,\r\n \"channel\": \"web\",\r\n \"content\": \"Ticket leído por el agente Juan\",\r\n \"contact_from\": null,\r\n \"contacts_to\": null,\r\n \"attachments\": null,\r\n \"created_at\": \"2020-01-28 10:08:12\",\r\n \"sending_status\": \"ok\"\r\n },\r\n {\r\n \"id\": 4056881,\r\n \"type\": \"note\",\r\n \"user_id\": 6405,\r\n \"channel\": \"web\",\r\n \"content\": \"Contenido nota interna.\",\r\n \"contact_from\": null,\r\n \"contacts_to\": null,\r\n \"attachments\": null,\r\n \"created_at\": \"2020-01-28 10:16:12\",\r\n \"sending_status\": \"ok\"\r\n },\r\n {\r\n \"id\": 4056882,\r\n \"type\": \"user_reply\",\r\n \"user_id\": 6405,\r\n \"channel\": \"web\",\r\n \"content\": \"Contenido respuesta de usuario.\",\r\n \"contact_from\": null,\r\n \"contacts_to\": [\r\n {\r\n \"id\": 6579207,\r\n \"email\": \"test@gmail.com\",\r\n \"name\": \"Julio Pailler\",\r\n \"phone\": \"\",\r\n \"personal_id\": \"\",\r\n \"custom_fields\": []\r\n }\r\n ],\r\n \"attachments\": null,\r\n \"created_at\": \"2020-01-28 10:16:13\",\r\n \"sending_status\": \"ok\"\r\n },\r\n {\r\n \"id\": 4056883,\r\n \"type\": \"system\",\r\n \"user_id\": 6405,\r\n \"channel\": \"web\",\r\n \"content\": \"Ticket leído por el agente Juan\",\r\n \"contact_from\": null,\r\n \"contacts_to\": null,\r\n \"attachments\": null,\r\n \"created_at\": \"2020-01-28 10:16:29\",\r\n \"sending_status\": \"ok\"\r\n }\r\n]"}],"_postman_id":"fbe89193-02be-4f39-b750-cab015f05cd8"},{"name":"Obtención de Actividad por Id","id":"57308b7d-0464-424a-9870-355448205ada","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/cases/{{id}}/activities/{{activity_id}}","description":"Para la obtención de una Actividad en particular, asociada a un Caso, se debe hacer un GET formando la URL del endpoint con el id de Caso y el id de Actividad.
Se debe indicar mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,case_id,type,user_id,channel,content,contact_from,contacts_to,attachments,recordings,created_at,sending_status
Genera un resumen textual de las actividades del caso utilizando IA.
\nNo requiere body.
\nEl resumen generado queda persistido en el campo summary del caso y puede consultarse luego con:
GET /v1/cases/{id}?fields=summary
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","cases","{{id}}","summarize"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"ff256258-849a-4b32-a918-8b08a7d75acf","name":"Generar Resumen de Caso con IA","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/cases/1273934/summarize"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"summary\": \"El cliente contactó para consultar el estado de su pedido. El agente verificó y confirmó que el envío fue despachado. El caso fue resuelto satisfactoriamente.\"\n }\n}"}],"_postman_id":"e992748f-b0bd-4fea-8871-69b0a1631a30"}],"id":"d6871635-359b-4840-892b-dca76641d11f","description":"El campo
\nsummarytambién está disponible enGET /v1/casesyGET /v1/cases/{id}como campo seleccionable viafields. Retornanullsi el resumen aún no fue generado para ese caso.
El endpoint cases permite crear, actualizar y obtener los Casos de Wise CX.
Para la obtención del listado de Organizaciones, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,custom_id,name,phone,email,web,state,address,executives,custom_fields,assignment_priorities
Ejemplos de filtros:
\n[{'field':'organization.id','operator':'EQUAL','value':'50283'}]\n[{'field':'organization.nombre_campo','operator':'EQUAL','value':'prueba'}]\nPara ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","contacts","organizations"],"host":["api","wcx","cloud"],"query":[{"key":"fields","value":"id,custom_id,name,phone,email"}],"variable":[]}},"response":[{"id":"27ff2cec-b5a9-4be5-a098-0697eb59016f","name":"Obtención de Organizaciones","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/contacts/organizations?filtering=[%7B'field':'organization.id','operator':'EQUAL','value':'50283'%7D]&fields=id,custom_id,name,phone,email,web,state,address,executives,custom_fields","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","contacts","organizations"],"query":[{"key":"filtering","value":"[%7B'field':'organization.id','operator':'EQUAL','value':'50283'%7D]"},{"key":"fields","value":"id,custom_id,name,phone,email,web,state,address,executives,custom_fields"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 50283,\n \"custom_id\": \"id123234\",\n \"name\": \"Santa Fe Coop.\",\n \"phone\": \"0232323255\",\n \"email\": \"company@domain.com\",\n \"address\": \"Juan B. Bustos 150\",\n \"state\": \"Santa Fe\",\n \"executives\": [\n \"executive@company-domain.com\"\n ],\n \"custom_fields\": [\n {\n \"field\": \"observaciones\",\n \"value\": \"new2\"\n },\n {\n \"field\": \"tipo_empresa\",\n \"value\": \"Coop.\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"2f311bfd-4f33-41a2-8636-9072495d3fc4"},{"name":"Creación de Organización","id":"e299ab1c-19c7-45c3-95c4-f50df3dd7d18","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/contacts/organizations/","description":"Para la creación de una nueva Organización, se debe hacer un POST con el siguiente objeto:
Objeto custom_fields:
Para la actualización de una Organización, se debe hacer un PUT con el siguiente objeto:
Objeto custom_fields:
Para la eliminación de una Organización, se debe hacer un DELETE indicando el Id de la Organización a eliminar.
El endpoint organizations permite obtener el listado de Organizaciones de Wise CX.
Para la obtención del listado de Grupos, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,code,name
Para ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","contacts","groups"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"b64b59db-e059-4eaa-a729-966c58fe5eee","name":"Obtención de Grupos","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/contacts/groups?fields=id,code,name","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","contacts","groups"],"query":[{"key":"fields","value":"id,code,name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 389,\n \"code\": \"BKA0389\",\n \"name\": \"Group 01\"\n },\n {\n \"id\": 390,\n \"code\": \"SRI0390\",\n \"name\": \"Group 02\"\n },\n {\n \"id\": 391,\n \"code\": \"OXC0391\",\n \"name\": \"Group 03\"\n }]\n}"}],"_postman_id":"2b6ac4c9-3948-479b-87cd-8c924ec10b43"},{"name":"Creación de Grupo","id":"268e1195-3901-4f49-a923-02c0f830cf11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/contacts/groups/","description":"Para la creación de un nuevo Grupo, se debe hacer un POST con el siguiente objeto:
Para agregar un contacto existente a un grupo, se debe hacer un PUT indicando en la ruta URL el id de contacto y el id del grupo según corresponde.
Para eliminar un contacto de un grupo, se debe hacer un DELETE indicando en la ruta URL el id de contacto y el id del grupo según corresponde.
El endpoint groups permite operar con los Grupos de Contactos de Wise CX.
Paso 1 del flujo de importación masiva. Crea una sesión y retorna un import_id para usarse en los pasos siguientes.
Flujo de uso:
\nPOST /v1/contacts/import — crea la sesión.POST /v1/contacts/import/{importId}/add — envía los contactos (puede repetirse, máx. 50 por request).GET /v1/contacts/import/{importId}/status — consulta el estado de procesamiento./add exitoso).Paso 2 del flujo de importación masiva. Envía un lote de contactos a la sesión creada. Puede llamarse múltiples veces. Cada llamada reinicia el TTL de la sesión.
\nSolo el campo definido como identifier en la sesión se valida. El resto no es obligatorio ni tiene validación de formato.
identifierContactos con el mismo valor de identifier dentro del mismo request son rechazados con duplicate_in_batch.
to_import = contactos válidos encolados · not_valid = rechazados · errors = detalle por contacto (contact_index base-0, error, value)
Paso 3 del flujo de importación masiva. Consulta el estado de procesamiento de la sesión. No modifica el TTL.
\nEndpoints para importación masiva de contactos de forma asíncrona. Flujo: crear sesión → agregar contactos (repetible) → consultar estado.
\n","_postman_id":"d7799151-a76f-464e-886b-53698ca946cf","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}}},{"name":"Creación de Contacto","id":"b374a51e-e1b4-47fc-8760-9458754bfaab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/contacts/","description":"Para la creación de un nuevo Contacto, se debe hacer un POST con el siguiente objeto:
Objeto custom_fields:
Para la actualización de un Contacto, se debe hacer un PUT con el siguiente objeto:
Objeto custom_fields:
Para la obtención del listado de Contactos, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
Ejemplos de filtros:
\n[{'field':'contact.group_id','operator':'EQUAL','value':'123'}]\n[{'field':'contact.group_id','operator':'IN','value':['123','456']}]\n[{'field':'contact.nombre_campo','operator':'EQUAL','value':'prueba'}]\nPara ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","contacts",""],"host":["api","wcx","cloud"],"query":[{"key":"fields","value":"id,email,personal_id,phone,name,custom_fields,last_update"},{"key":"limit","value":"100"},{"key":"page","value":"80"}],"variable":[]}},"response":[{"id":"03fed137-430c-4a15-aec8-82e8a0ae62f7","name":"Obtenención de Contactos","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/contacts/?fields=id,personal_id&sort=desc&sort_field=id&limit=5&page=1","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","contacts",""],"query":[{"key":"fields","value":"id,personal_id"},{"key":"sort","value":"desc"},{"key":"sort_field","value":"id"},{"key":"limit","value":"5"},{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"id\": 6594517,\r\n \"personal_id\": \"\"\r\n },\r\n {\r\n \"id\": 6594516,\r\n \"personal_id\": \"3279964888\"\r\n },\r\n {\r\n \"id\": 6594515,\r\n \"personal_id\": \"812737-7787987987\"\r\n },\r\n {\r\n \"id\": 6594514,\r\n \"personal_id\": \"8127377787987987\"\r\n },\r\n {\r\n \"id\": 6594513,\r\n \"personal_id\": \"7787987987\"\r\n }\r\n ],\r\n \"paging\": {\r\n \"next\": \"https://api.wcx.cloud/core/v1/contacts/v1/contacts/?fields=id,personal_id&limit=5&page=2&sort=desc&sort_field=id\",\r\n \"page\": 2,\r\n \"limit\": 5\r\n }\r\n}"}],"_postman_id":"7e6a9f75-4baa-4b19-8ab4-f51d95fa6f49"},{"name":"Obtención de Contacto por id","id":"f832ce92-f4a8-4806-a642-a1188e2251d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/contacts/{{id}}","description":"Para la obtención del detalle de un Contacto, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,email,personal_id,phone,name,guid,password,custom_fields,last_update,organization_id,address,city,channel_data,groups_ids
Para la eliminación de un Contacto, se debe hacer un DELETE indicando el Id del contacto a eliminar.
El endpoint contacts permite manejar los Contactos de Wise CX.
Para la obtención del listado de Grupos de Atención, se debe hacer un GET. Los campos devueltos por defecto son: id,name,businessHours,users.
Se puede usar el parámetro fields para solicitar un subconjunto de campos (ej: ?fields=id,name,users).
businessHoursusersCrea un nuevo grupo de atención permitiendo asociar usuarios y definir si cada uno tiene asignación automática.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","queues"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"fd6907ed-c36a-498c-9630-e330e159b034","name":"Creación de Grupos de Atención","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Soporte\",\r\n \"users\": [\r\n {\r\n \"id\": 10,\r\n \"auto_assign\": true\r\n },\r\n {\r\n \"id\": 11,\r\n \"auto_assign\": false\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/queues"},"status":"Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": 154\r\n}"}],"_postman_id":"0fad1c5c-21d9-40ee-b235-72ae2e50df9c"},{"name":"Obtención de Grupo de Atención por Id","id":"847df071-3e99-4bcb-bedd-a978e7c99752","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/queues/{{id}}","description":"Para la obtención del detalle de un Grupo de Atención, se debe hacer un GET indicando el id del grupo en la URL.
Los campos devueltos por defecto son: id,name,businessHours,users
Se puede usar el parámetro fields para solicitar un subconjunto de campos (ej: ?fields=id,name,users).
businessHoursusersPara asignar o actualizar usuarios en un Grupo de Atención, se debe hacer un PUT indicando el id del grupo en la URL y enviando una lista de objetos de usuario:
Si la lista está vacía, retorna un resumen con contadores en 0 sin realizar cambios.
\nLa respuesta incluye un resumen con la cantidad de usuarios added, updated y unchanged.
Para eliminar un usuario de un Grupo de Atención, se debe hacer un DELETE indicando el id del grupo y el id del usuario en la URL.
Retorna HTTP 204 No Content si la operación fue exitosa.
Para eliminar múltiples usuarios de un Grupo de Atención en una sola operación, se debe hacer un DELETE indicando el id del grupo en la URL y enviando el siguiente objeto:
Para la obtención de Negocio Abierto, se debe hacer un GET. Se puede enviar como opcional el parámetro queue_id.
El endpoint queues permite obtener el listado de Areas de Wise CX.
Para la obtención del listado de Usuarios, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,user_name,nick,first_name,last_name,is_bot,created_at,last_login,queues
El campo queues devuelve el listado de Grupos de Atención a los que pertenece el usuario. Cada objeto contiene:
Para la obtención del detalle de un Usuario, se debe hacer un GET indicando el id del usuario en la URL.
Los campos devueltos son: id,user_name,nick,first_name,last_name,is_bot,created_at,last_login,queues
Para la creación de un nuevo Usuario, se debe hacer un POST con el siguiente objeto:
Para asignar Grupos de Atención a un Usuario, se debe hacer un PUT indicando el id del usuario en la URL y enviando una lista de objetos de grupo:
Para eliminar Grupos de Atención de un Usuario, se debe hacer un DELETE indicando el id del usuario en la URL y enviando el siguiente objeto:
El endpoint users permite obtener, crear y gestionar los Usuarios de Wise CX, incluyendo la asignación y eliminación de Grupos de Atención.
Para exportar un listado, se debe hacer un \\POST\\ indicando el \\id\\ del reporte a descargar en la URL.
\nNOTA: Solo es posible descargar 3 reportes en simultáneo.
\nEl objeto filter:
Reglas de validación para filter:
date_from y date_to deben enviarse juntos.date_to debe ser mayor o igual a date_from.Usar el \\export_id\\ retornado para consultar el estado de la exportación mediante \\GET /v1/analytics/export/{export_id}/status.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","analytics","export","{{id}}"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"eb933d8d-7e0d-4bf0-8c9a-909d29f21736","name":"Iniciar Descarga de Reporte por id","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\"columns\":\"only_visible\"}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/analytics/export/6541"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"export_id\": \"5a97c4b0582d4076a5c4e2a4455666e9\",\n \"status\": \"processing\",\n \"progress\": 0,\n \"report_url\": null\n}"}],"_postman_id":"2eb7efa6-7603-445c-8f2b-3cfe1b3a9e6c"},{"name":"Obtener estado de Descarga por export_id","id":"9c2487fc-2b8e-4386-92ce-f4f141b9e366","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/analytics/export/{{export_id}}/status","description":"Para consultar el estado de una exportación, se debe hacer un \\GET\\ indicando el \\export_id\\ retornado por el endpoint \\POST /v1/analytics/export/{id}.
\nEl endpoint analytics permite iniciar y chequear el estado de la descarga de un reporte.
Solo se permiten descargar reportes del tipo lista, no está permitida la descarga de Dashboards.
\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"011aeca3-6159-428f-b710-165b44dd1aa4"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"16520c30-144e-4774-b11c-89260059d689"}}],"_postman_id":"d3a137f5-4a0b-4c2b-b882-374a9151c9fe","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}}},{"name":"Encuestas","item":[{"name":"Obtención de Encuestas","id":"aef4427a-db6c-4bb5-82b3-75224275d1b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/surveys","description":"Para obtener un listado de encuestas se debe hacer un GET .
Para obtener un listado de las preguntas de una encuesta se debe hacer un GET proporcionando el id de la encuesta.
Para obtener un listado de respuestas de encuestas, se debe hacer un GET indicando el id de la encuesta. Se puede enviar como opcional el parámetro limit para determinar la cantidad de items por página y el parámetro page para la página posicionada.
Para ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","surveys","{id}","responses"],"host":["api","wcx","cloud"],"query":[{"key":"limit","value":"100"},{"key":"page","value":"80"}],"variable":[]}},"response":[{"id":"311b8443-05f1-4c58-bbe6-891a22f079da","name":"Obtención de Respuestas de Encuestas","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/surveys/{id}/responses?&limit=2&page=20","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","surveys","{id}","responses"],"query":[{"key":null,"value":null},{"key":"limit","value":"2"},{"key":"page","value":"20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": [\n {\n \"response_id\": 525,\n \"survey_id\": 4,\n \"case_id\": 57394656,\n \"status\": \"not_responded\",\n \"answers\": [],\n \"contact_id\": 6541872,\n \"sent_at\": \"2021-11-04T12:30:00Z\",\n \"responded_at\": \"1900-01-01T00:00:00\"\n },\n {\n \"response_id\": 189,\n \"survey_id\": 4,\n \"case_id\": 52534635,\n \"status\": \"responded\",\n \"answers\": [\n { \"question_id\": \"a2cde820cfec11e3b3be7d1907d92b49\", \"question_type\": \"rating\", \"value\": 8 },\n { \"question_id\": \"a2cde820cfec11e8b3be7d1907d92b49\", \"question_type\": \"rating\", \"value\": 3 },\n { \"question_id\": \"a2cf4c7bcfec11e3b38e7d1907d92b49\", \"question_type\": \"boolean\", \"value\": false }\n ],\n \"contact_id\": 6523860,\n \"sent_at\": \"2021-11-04T12:30:00Z\",\n \"responded_at\": \"2021-11-04T12:33:37\"\n }\n ],\n \"paging\": {\n \"next\": \"https://api.wcx.cloud/core/v1/surveys/4/responses?limit=2&page=21\",\n \"page\": 3,\n \"limit\": 2\n }\n}"}],"_postman_id":"1aa92208-4582-4f67-bec5-6700b3011f26"}],"id":"c4e03f53-f980-4915-a105-7479a1ab8646","description":"El endpoint surveys permite obtener listados y resultados de encuestas.
Para ejecutar de manera asíncrona un Nodo de un flujo previamente configurado del asistente se debe hacer un POST indicando el ID del nodo.
En el body, el parametro context es opcional.
Para ejecutar de manera asíncrona un Nodo de un flujo previamente configurado del asistente, se debe hacer un POST indicando el assistantID (es el GUID del asistente que figura en la URL del asistente específico dentro del builder) shortName del nodo (es el nombre corto del nodo).
En el body, el parametro context es opcional.
El endpoint assistants permite ejecutar de manera asíncrona una intención de un flujo previamente configurado del asistente.
Para la creación de un nuevo Orden, se debe hacer un POST con el siguiente objeto:
Objeto customer:
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","orders"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"fd43c7f8-63bd-4a16-a4fb-ee9c907a386f","name":"Creación de Orden","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"ecommerce_store_id\": \"store-08wc10clz4\",\r\n \"ecommerce_platform\": \"custom\",\r\n \"ecommerce_order_id\": \"123a456b\",\r\n \"status\": \"cancelled\",\r\n \"reject_reason\":\"Tarjeta sin fondos\",\r\n \"total_amount\": 466.50,\r\n \"sales_recovery\": true,\r\n \"customer\":{\r\n \"name\": \"test\",\r\n \"email\": \"test@gmail.com\",\r\n \"phone\": \"1234512345\",\r\n \"personal_id\": \"123123\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/orders"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[""],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"id\": 7387492,\n \"message\": \"{\\\"id\\\":7387492}\"\n}"}],"_postman_id":"52a8d35a-ff63-4803-9e10-d3d3503a43ba"},{"name":"Actualización de Orden por id","id":"dd29ca71-f0ff-4bb2-9e77-de52afab8814","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"\r\n{\r\n \"reject_reason\":\"Sin Stock\",\r\n \"sales_recovery\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/orders/{{id}}","description":"Para la actualización de una Orden, se debe hacer un PUT con el siguiente objeto:
Objeto customer:
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","orders","{{id}}"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"db5ce542-6bb6-499a-9a86-3207d4499f8f","name":"Actualización de Orden por id","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"reject_reason\":\"Sin Stock\",\r\n \"sales_recovery\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/orders/{{id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[""],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"id\": 7387474,\n \"message\": \"{\\\"id\\\":7387474}\"\n}"}],"_postman_id":"dd29ca71-f0ff-4bb2-9e77-de52afab8814"},{"name":"Obtención de Ordenes","id":"4c49b34f-c0a4-487d-99f6-b1d620bf554d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/orders","description":"Para la obtencion del listado de ordenes, se debe hacer un GET indicando mediante el parametro fields los campos que se requieran.
Los posibles campos son:
\nid,ecommerce_store_id,ecommerce_platform,ecommerce_order_id,status,reject_reason,total_amount,sales_recovery,customer,created_at,updated_at,order_data
Para ver ejemplos ir a Filtros.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","orders"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"836eaf66-24a1-4db0-976c-13f743460b51","name":"Obtencion de Ordenes","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/orders?fields=id,status,customer,created_at","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","orders"],"query":[{"key":"fields","value":"id,status,customer,created_at"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": 1001,\n \"status\": \"pending\",\n \"customer\": {\n \"name\": \"John Doe\",\n \"email\": \"johndoe@example.com\",\n \"phone\": \"+1234567890\",\n \"personal_id\": \"12345678\"\n },\n \"created_at\": \"2024-03-15 10:30:00\"\n },\n {\n \"id\": 1002,\n \"status\": \"confirmed\",\n \"customer\": {\n \"name\": \"Jane Smith\",\n \"email\": \"janesmith@example.com\",\n \"phone\": \"+0987654321\",\n \"personal_id\": \"87654321\"\n },\n \"created_at\": \"2024-03-14 08:15:00\"\n }\n]"}],"_postman_id":"4c49b34f-c0a4-487d-99f6-b1d620bf554d"}],"id":"e4cf56fc-f499-488e-b12d-495f52b1bda7","description":"El endpoint orders permite crear, actualizar y obtener ordenes de ecommerce como Vtex, Shopify, WooCommerce, Fenicio y Custom (cualquier ecommerce integrado a Wise CX mediante el canal 'Custom e-com').
Para la obtención del detalle de una Orden de Mercado Libre, se debe hacer un GET indicando el id (brindado por WiseCX) de la orden que se desea obtener.
En el JSON de la respuesta se indica en el campo order_data la información brindada por Mercado Libre sobre la orden.
Para la obtención del listado de Templates, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
template_id,content,name,whatsapp_number,whatsapp_description
Retorna el detalle de un template de WhatsApp.
\nCampos por defecto: template_id,name,code,status,language,category,content,whatsapp_number,whatsapp_description.\nSe puede solicitar un subconjunto con el parámetro de query fields.
Crea un template de WhatsApp y lo envía a revisión de Gupshup en una sola llamada. Si Gupshup lo acepta, el\ntemplate queda en status = submitted.
\n\nPara
\nurl_dynamicse usabuttons.example_dynamic_urlcomo valor de ejemplo de la variable.
El template creado se retorna con la misma forma que GET /v1/whatsapp_templates/{id}.
name is required, name must contain only lowercase letters, numbers and underscores, code is required,\nlanguage is required, category is invalid. Valid values: marketing, utility, authentication, text is required,\nnumber_id is required, number_id not found for this account, además de los errores propagados por Gupshup al\nenviar el template a revisión.
Actualiza un template de WhatsApp. Si el template todavía no fue enviado a Gupshup, el PUT también dispara el\nenvío a revisión.
\n\nRestricción: solo se puede modificar un template que no esté activo. Si el template está activo retorna\nHTTP 400
\nTemplate must be inactive to be updated.
\n\nPara
\nurl_dynamicse usabuttons.example_dynamic_urlcomo valor de ejemplo de la variable.
El template actualizado se retorna con la misma forma que GET /v1/whatsapp_templates/{id}.
name is required, name must contain only lowercase letters, numbers and underscores, code is required,\nlanguage is required, category is invalid. Valid values: marketing, utility, authentication, text is required,\nnumber_id is required, number_id not found for this account, además de los errores propagados por Gupshup al\nenviar el template a revisión.
Además: WhatsApp Template not found (el Id no existe para la cuenta) y\nTemplate must be inactive to be updated.
Elimina el template localmente y en Gupshup.
\n\n\nSi Gupshup ya no tiene el template (
\nTemplate Does not exists), la operación se considera exitosa igualmente\n(idempotente).
Retorna { \"data\": { \"message\": <mensaje del backend> } }.
El endpoint whatsapp_templates permite obtener el listado de Templates de WhatsApp cargados en la cuenta de Wise CX.
Un Webhook en Wise CX, es un mensaje o paquete enviado hacia un sistema externo, que contiene información inherente al canal o evento que lo dispara.
\nMediante la suscripción a los Webhooks de Wise CX, los sistemas externos son notificados de eventos que ocurren en tiempo real y permiten reaccionar y realizar alguna tarea en consecuencia.
\nDesde Configuración Canales, agregar un nuevo canal Webhooks:
\n\n Completar los campos requeridos:
\nURL pública para la recepción de eventos
\nGrupos de atención: suscribirse a eventos que sucedan solamente en casos de grupos de atención específicos
\nActivar el selector de Nueva Actividad
\nSolo en caso que tenga un canal de Whatsapp activo y lo desee, también activar el selector de WhatsApp Status
\n![\"alt](\"https://ss.wcx.cloud/a/08wc10/2020-12/a9b2d7242530427cb9c6625e9e34feee.jpg\")
Wise CX notificará a la URL configurada, todos los eventos de casos pertenecientes a los grupos de atención seleccionados. Los eventos pueden ser:
\nCreación de un caso
\nNuevos mensajes dentro de un caso
\nLecturas, cambios de estados, automatizaciones o transferencias de grupos
\nEl webhook enviado por Wise CX es un JSON con la siguiente estructura:
\n{\n \"event\": \"[activity_new | status_update | survey ...]\",\n \"case_id\": 12345,\n \"activity_id\": 6789,\n \"activity_type\":[contact_message | user_reply | note ...]\n}\n\nEn caso de ser un evento del tipo survey la estructura es la siguiente:
\n{\n \"event\": \"survey\",\n \"case_id\": 12345,\n \"url_survey\":\"https://wcentrix.net/pub/survey.html#?survey=87e9r8bfje4w7er4192b4ff548c67c468gh=RMSW016-3512649&c_resp=123\"\n}\n\nEn caso de ser un evento del tipo meli la estructura es la siguiente:
\n{\n \"id\": wcx_order_id,\n \"event\": [\"meli_order_updated\"|\"meli_new_order\"]\n}\n\nIMPORTANTE: El payload recibido solamente incluye información básica del evento. Para acceder a más información sobre el evento en particular, posteriormente a la recepción del webhook, se deberá realizar una llamada adicional al endpoint correspondiente para obtener el contenido e información completa del objeto.
\nDETALLE event
\nDETALLE activity_type
\nWEBHOOKS DE NITRO
\nEn los webhooks por eventos de Nitro, el payload a recibir será similar al siguiente:
\n{\n \"event\": \"nitro_activity\",\n \"case_id\": xxx,\n \"contact_id\": xxx,\n \"activity_type\": \"case_created\",\n \"tracking_id\": \"wa-xxxx\"\n}\n\nPrograma una Campaña bulk para ser enviada en una fecha y hora futura. Se debe hacer un POST indicando el campaign_id en la URL. Opera sobre todos los mensajes activos de la campaña.
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","schedule"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"0ae573de-5e5e-4438-b488-2c2d35232977","name":"Programar Envío de Campaña","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"scheduled_at\": \"2026-04-01 10:00:00\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/schedule"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"scheduled\",\n \"scheduled_at\": \"2026-04-01 13:00:00\"\n}"}],"_postman_id":"5494a301-3e62-4789-adf2-00eb875c749b"},{"name":"Enviar Campaña Inmediatamente","id":"bf73f7fa-ffc6-4b80-93bd-65ed5c5ef8c6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/send","description":"Solo disponible para campañas de tipo
\nsimple(bulk). Para campañas transaccionales usar la acciónactivate.
Envía una Campaña bulk de forma inmediata, sin necesidad de indicar una fecha de envío. Se debe hacer un POST indicando el campaign_id en la URL. Opera sobre todos los mensajes activos de la campaña.
\n\nSolo disponible para campañas de tipo
\nsimple(bulk). Para programar un envío a futuro usar la acciónschedule.
Este endpoint no requiere body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","send"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"e2d5a2a9-f35e-435e-8d9e-f71df6f7d7d4","name":"Enviar Campaña Inmediatamente","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"processing\"\n}"}],"_postman_id":"bf73f7fa-ffc6-4b80-93bd-65ed5c5ef8c6"},{"name":"Activar Campaña Transaccional","id":"854906a5-b3ee-428e-8d50-0de5a35254d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/activate","description":"Activa una Campaña transaccional para que comience a procesar envíos. Se debe hacer un POST indicando el campaign_id en la URL. Opera sobre todos los mensajes activos de la campaña.
\n\nSolo disponible para campañas de tipo
\ntransactional. Requiere que la campaña y todos sus mensajes estén en estadodraftostopped.
Este endpoint no requiere body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","activate"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"0c1a1f06-6d82-4df8-bd6c-f63e06fc6afc","name":"Activar Campaña Transaccional","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/activate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"running\"\n}"}],"_postman_id":"854906a5-b3ee-428e-8d50-0de5a35254d9"},{"name":"Detener Campaña Transaccional","id":"0e145997-85ac-473f-b7c7-4c49d0a6f229","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/stop","description":"Detiene una Campaña transaccional que se encuentra en ejecución. Se debe hacer un POST indicando el campaign_id en la URL. Opera sobre todos los mensajes activos de la campaña.
\n\nSolo disponible para campañas de tipo
\ntransactionalen estadorunning. Para reanudar el envío, utilizar la acciónactivate.
Este endpoint no requiere body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","stop"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"9c673c21-877f-4424-a04e-1bbd62908f7f","name":"Detener Campaña Transaccional","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/stop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"stopped\"\n}"}],"_postman_id":"0e145997-85ac-473f-b7c7-4c49d0a6f229"},{"name":"Eliminar Campaña","id":"05b6016b-f53e-4819-be72-a8bf37e985a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/delete","description":"Elimina una Campaña. Se debe hacer un POST indicando el campaign_id en la URL.
\n\nDisponible para campañas
\nsimple(bulk) en estadodraft, y para campañastransactionalen estadodraftostopped.
Este endpoint no requiere body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","delete"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"3188c4cd-5c35-4929-aad5-a8eaead7dea9","name":"Eliminar Campaña","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"deleted\"\n}"}],"_postman_id":"05b6016b-f53e-4819-be72-a8bf37e985a7"},{"name":"Cancelar Envío en Curso de Campaña","id":"d3039731-93f4-4f25-9e15-052f9f7dcb1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/cancel-send","description":"Cancela el envío en curso de una Campaña bulk. Se debe hacer un POST indicando el campaign_id en la URL. Opera sobre todos los mensajes activos de la campaña.
\n\nSolo disponible para campañas de tipo
\nsimple(bulk). La campaña debe estar en estadorunningoscheduled, y los mensajes en estadopreparing,sendingoscheduled.
Este endpoint no requiere body.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","campaigns","{{campaign_id}}","actions","cancel-send"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"7b239a43-428b-4b76-adf1-8f4b41d19898","name":"Cancelar Envío en Curso de Campaña","originalRequest":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/actions/cancel-send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"campaign_id\": 1321,\n \"status\": \"cancelled\"\n}"}],"_postman_id":"d3039731-93f4-4f25-9e15-052f9f7dcb1a"},{"name":"Enviar Prueba de Campaña","id":"e994b1fa-4173-4438-a23e-5e085ff32500","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"test_channels\": [1, 3],\n \"test_contact\": {\n \"id\": 0,\n \"name\": \"Contacto de prueba\",\n \"phone\": \"5491100000000\",\n \"email\": \"prueba@ejemplo.com\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/nitro/campaigns/{{campaign_id}}/actions/send-test","description":"Envía una prueba de los mensajes de la campaña para los canales indicados. Opera sobre todos los mensajes activos (no eliminados) de la campaña.
\n\n\nSi
\ntest_contactse omite, o se envía sinphonenicontacts_not_found.
El directorio Actions agrupa las acciones disponibles para ejecutar sobre una Campaña Nitro. Todas las acciones se invocan mediante POST a la ruta /v1/nitro/campaigns/{campaign_id}/actions/{accion} y operan sobre todos los mensajes activos de la campaña.
Retorna los templates de email activos de la cuenta.
\nEl listado de templates se retorna dentro de data.
Opcional. 1 = footer, 2 = compliance, 3 = body. Si se omite, retorna todos los tipos.
\n","type":"text/plain"},"key":"type","value":"1"}],"variable":[]}},"response":[],"_postman_id":"cd90f61b-14fd-4793-9234-b37897aac1ca"},{"name":"Obtención de Template de Email por Id","id":"4fadd0c9-6de2-4c2a-9742-6b511d55dc6f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/email-configs/{{config_id}}","description":"Retorna el detalle de un template de email.
\nCrea un nuevo template de email para la cuenta.
\nEl template creado se retorna dentro de data.
Actualiza un template de email existente. Ambos campos del body son opcionales — solo se actualizan los campos enviados.
\nElimina un template de email.
\n\n\nEs un soft-delete: el registro queda marcado como
\ndisabledy deja de retornarse enGET /v1/nitro/email-configs, pero no se elimina físicamente.
Templates HTML reutilizables (campaigns_email_config) que se usan para armar los mensajes de email de una campaña. Tipos: 1 = footer, 2 = compliance, 3 = body.
Retorna todos los remitentes de email activos de la cuenta dentro de data.
Retorna el detalle de un remitente de email.
\nCrea un nuevo remitente de email para la cuenta.
\nEl remitente creado se retorna dentro de data.
Actualiza un remitente de email existente. Todos los campos del body son opcionales — solo se actualizan los campos enviados.
\nElimina un remitente de email.
\n\n\nEs un soft-delete: el registro queda marcado como
\ndisabledy deja de retornarse enGET /v1/nitro/email-senders, pero no se elimina físicamente.
\n\nLa eliminación se rechaza si el remitente es la cuenta de correo actualmente asociada a la cuenta.
\n
Direcciones de correo disponibles como remitentes para los mensajes de email de una campaña.
\n","_postman_id":"4277f14e-d76b-452d-8f3a-4208594b431e","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}}},{"name":"Request Transaccional","id":"da817c33-b426-43d9-9ee0-b65cb0be7951","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/transactional/{{campaign_id}}/send","description":"Para el envío de un mensaje o llamada transaccional (campaña transaccional), se debe hacer un POST con el siguiente objeto:
IMPORTANTE: dentro del dictionary variables la API de META tiene en cuenta el orden/posición en la que se envían las variables como así también el nombre de las mismas.
Por ej, si un template tiene el siguiente texto: \"¡Hola {{1}}, gracias por tu compra! el número de seguimiento es: {{2}}\". Debe envíarse un request a nuestra API que contenga en el dictionary de variables PRIMERO el nombre y SEGUNDO el id de seguimiento.
El objeto contactse debe enviar de la siguiente manera:
Especificaciones de uso:
\n1. Previamente al uso de este endpoint, debe estar creada la campaña transaccional y se debe tener conocimiento el campo identificador (ID) de la campaña.
\n2. Para obtener el ID de la campaña debemos ingresar al modulo de Nitro en el cual podemos optar por dos opciones:
\n3. La campaña debe estar en estado Activa y debe estar correctamente configurada para los canales definidos.
\n4. Para realizar el envío del mensaje a traves de este endpoint, se deben tener en cuenta las siguientes especificaciones:
\nEl campo channels es un listado de los canales disponibles para su uso en el modulo de Nitro \"whatsapp\".
\nEn el objeto contact, id es el campo identificatorio del contacto y si se completa no es requerido completar los campos email, personal_id o phone.
\nEn el objeto contact, si el campo id no es completado, se debe completar por lo menos uno de los tres campos identificatorios.
\nSi el canal especificado es whatsapp, call o sms es obligatorio completar el campo phone del objeto contact.
\nSi el canal especificado es email, es obligatorio completar el campo email del objeto contact.
\nEs posible en un mismo request indicar más de un contacto con sus variables y metadata, incluso diferentes campañas transaccionales, para ello se debe utilizar el endpoint transaccional bulk. En este endpoint se debe hacer un POST con el siguiente objeto del tipo LISTA:
IMPORTANTE: dentro del dictionary variables la API de META tiene en cuenta el orden/posición en la que se envían las variables como así también el nombre de las mismas.
Por ej, si un template tiene el siguiente texto: \"¡Hola {{1}}, gracias por tu compra! el número de seguimiento es: {{2}}\". Debe envíarse un request a nuestra API que contenga en el dictionary de variables PRIMERO el nombre y SEGUNDO el id de seguimiento.
El objeto contactse debe enviar de la siguiente manera:
Especificaciones de uso:
\nIdem a la descripción detallada en el endpoint transaccional.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","nitro","transactional","send"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"7ce1cd22-5589-4980-b4f3-d170c0e523fe","name":"Campaña Transaccional - Enviar Mensaje Bulk","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"[\r\n {\r\n \"channels\": [\r\n \"whatsapp\"\r\n ],\r\n \"campaign_id\": 1321,\r\n \"contact\": {\r\n \"phone\": \"5493517606060\"\r\n },\r\n \"variables\": {\r\n \"{1}\": \"\",\r\n \"{2}\": \"\"\r\n },\r\n \"metadata\": {\r\n \"project\": \"ASD-9843\",\r\n \"project_area\": \"Marketing\"\r\n }\r\n },\r\n {\r\n \"channels\": [\r\n \"whatsapp\"\r\n ],\r\n \"campaign_id\": 1322,\r\n \"contact\": {\r\n \"phone\": \"5493517382938\"\r\n },\r\n \"variables\": {\r\n \"{1}\": \"\",\r\n \"{2}\": \"\"\r\n },\r\n \"metadata\": {\r\n \"project\": \"FDD-3847\",\r\n \"project_area\": \"Finance \"\r\n }\r\n }\r\n]","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/nitro/transactional/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"channel\": \"whatsapp\",\n \"status\": \"queued\",\n \"contact\":{\n \"id\": 89238,\n \"phone\": \"5493517606060\"\n },\n \"description\": \"\",\n \"tracking_id\": \"wa-4987\"\n },\n {\n \"channel\": \"whatsapp\",\n \"status\": \"queued\",\n \"contact\":{\n \"id\": 89239,\n \"phone\": \"5493517382938\"\n },\n \"description\": \"\",\n \"tracking_id\": \"wa-7894\"\n }\n]"}],"_postman_id":"7fa32015-f510-49d0-b459-137852e48d22"},{"name":"Obtención de Campañas","id":"c179a38b-df5c-43ff-84d7-a5e7a46cff5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/nitro/campaigns?page=1&limit=10","description":"Para la obtención del listado de Campañas Nitro, se debe hacer un GET.
Soporta paginación y filtros mediante los parámetros page, limit, sort_by, sort_order y filtering.
Número de página
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Cantidad de resultados por página
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"940f3d24-dd5e-48d7-ba1e-b454d242a6b9","name":"Obtención de Campañas","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/nitro/campaigns?page=1&limit=10","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","nitro","campaigns"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"100\",\n \"name\": \"Campaña Bienvenida Clientes\",\n \"type\": \"simple\",\n \"status\": \"completed\",\n \"created_at\": \"2026-03-10 09:00:00\",\n \"updated_at\": \"2026-03-10 09:15:30\",\n \"scheduled_at\": \"\",\n \"messages\": [\n {\n \"id\": \"200\",\n \"channel\": \"whatsapp\",\n \"status\": \"completed\",\n \"scheduled_at\": \"2026-03-10 09:00:00\",\n \"sent_at\": \"2026-03-10 09:01:12\",\n \"stats\": {\n \"total\": 500,\n \"sent\": 498,\n \"delivered\": 450,\n \"opened\": 120,\n \"clicked\": 30,\n \"replied\": 15,\n \"failed\": 2,\n \"bounced\": 0,\n \"unsubscribed\": 0\n },\n \"channel_config\": {\n \"template_id\": \"40184\",\n \"template_name\": \"bienvenida_clientes\",\n \"language\": \"es\",\n \"variables\": null\n }\n }\n ]\n },\n {\n \"id\": \"101\",\n \"name\": \"Campaña Promo Verano\",\n \"type\": \"simple\",\n \"status\": \"draft\",\n \"created_at\": \"2026-03-12 14:00:00\",\n \"updated_at\": \"2026-03-12 14:00:00\",\n \"scheduled_at\": \"\",\n \"messages\": [\n {\n \"id\": \"201\",\n \"channel\": \"email\",\n \"status\": \"draft\",\n \"scheduled_at\": \"\",\n \"sent_at\": \"\",\n \"stats\": {\n \"total\": 0,\n \"sent\": 0,\n \"delivered\": 0,\n \"opened\": 0,\n \"clicked\": 0,\n \"replied\": 0,\n \"failed\": 0,\n \"bounced\": 0,\n \"unsubscribed\": 0\n },\n \"channel_config\": {\n \"subject\": \"Promo especial de verano\",\n \"from_name\": \"Wise CX\",\n \"from_email\": \"no-reply@wisecx.com\",\n \"template_id\": \"0\",\n \"email_content\": \"Aprovecha nuestra promo de verano\"\n }\n }\n ]\n },\n {\n \"id\": \"102\",\n \"name\": \"Notificaciones Transaccionales\",\n \"type\": \"transactional\",\n \"status\": \"running\",\n \"created_at\": \"2026-03-15 08:00:00\",\n \"updated_at\": \"2026-03-15 08:05:00\",\n \"scheduled_at\": \"\",\n \"messages\": [\n {\n \"id\": \"202\",\n \"channel\": \"whatsapp\",\n \"status\": \"scheduled\",\n \"scheduled_at\": \"2026-03-15 08:05:00\",\n \"sent_at\": \"\",\n \"stats\": {\n \"total\": 1200,\n \"sent\": 1100,\n \"delivered\": 980,\n \"opened\": 0,\n \"clicked\": 0,\n \"replied\": 0,\n \"failed\": 100,\n \"bounced\": 0,\n \"unsubscribed\": 0\n },\n \"channel_config\": {\n \"template_id\": \"40190\",\n \"template_name\": \"notificacion_pago\",\n \"language\": \"es\",\n \"variables\": [\n {\n \"name\": \"{1}\",\n \"value_from\": \"nombre\",\n \"value_default\": \"Cliente\"\n }\n ]\n }\n }\n ]\n }\n]"}],"_postman_id":"c179a38b-df5c-43ff-84d7-a5e7a46cff5d"},{"name":"Creación de Campaña","id":"309e801d-5d55-46a0-b95f-e3af5c673449","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"Campaña Bienvenida\",\r\n \"type\": \"simple\",\r\n \"description\": \"Mensaje de bienvenida a nuevos clientes\",\r\n \"groups_ids\": \"123,456\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/nitro/campaigns","description":"Para la creación de una nueva Campaña Nitro, se debe hacer un POST con el siguiente objeto:
Para la obtención del detalle de una Campaña Nitro, se debe hacer un GET indicando el campaign_id en la URL.
Para la actualización de una Campaña Nitro, se debe hacer un PUT indicando el campaign_id en la URL y enviando el siguiente objeto:
Duplica una campaña existente, incluyendo sus mensajes. No requiere body.
\nRetorna el Id de la campaña recién creada.
\nPara crear un Mensaje dentro de una Campaña Nitro, se debe hacer un POST a /v1/nitro/campaigns/{campaign_id}/messages.
campaign_idchannel, channel_config\n\nRestricción de canal:
\ntransactional.
channel_config)channel_config)channel_config)reply_type{\n \"channel\": \"whatsapp\",\n \"channel_config\": {\n \"template_id\": \"40184\",\n \"variables\": [\n {\n \"name\": \"{1}\",\n \"value_from\": \"nombre\",\n \"value_default\": \"Cliente\"\n }\n ],\n \"reply_type\": \"group\",\n \"reply_id\": 123\n }\n}\n{\n \"channel\": \"email\",\n \"scheduled_at\": \"2026-04-01 10:00:00\",\n \"channel_config\": {\n \"from_email\": \"noreply@tudominio.com\",\n \"subject\": \"Bienvenido a WiseCX\",\n \"email_content\": \"<html><body><h1>Hola {{contact_name}}</h1></body></html>\",\n \"headers\": [\n {\n \"key\": \"X-Custom-Source\",\n \"value\": \"api\"\n }\n ]\n }\n}\nCall
\n{\n \"channel\": \"call\",\n \"channel_config\": {\n \"call_number_id\": 456,\n \"reply_type\": \"ivr\",\n \"reply_id\": 12,\n \"only_when_available\": true,\n \"only_business_hours\": false,\n \"simultaneous_calls\": 3\n }\n}\nPara actualizar un Mensaje de una Campaña Nitro, se debe hacer un PUT a /v1/nitro/campaigns/{campaign_id}/messages/{message_id}.
campaign_id, message_id\n\n\n
channeles inmutable después de crear el mensaje. No enviarchannelen payloads de update.Restricción de canal:
\ntransactional.
channel_config)channel_config)channel_config)reply_type{\n \"channel_config\": {\n \"template_id\": \"40200\",\n \"variables\": [\n {\n \"name\": \"{1}\",\n \"value_from\": \"customer_name\",\n \"value_default\": \"Cliente\"\n }\n ],\n \"reply_type\": \"assistant\",\n \"reply_id\": 38,\n \"reply_node\": \"inicio\"\n }\n}\n{\n \"scheduled_at\": \"2026-04-02 11:30:00\",\n \"channel_config\": {\n \"from_email\": \"noreply@tudominio.com\",\n \"subject\": \"Promoción actualizada\",\n \"email_content\": \"<html><body><p>Hola {{contact_name}}, esta es una actualización.</p></body></html>\",\n \"headers\": [\n {\n \"key\": \"X-Campaign-Version\",\n \"value\": \"v2\"\n }\n ]\n }\n}\nCall
\n{\n \"channel_config\": {\n \"call_number_id\": 456,\n \"reply_type\": \"group\",\n \"reply_id\": 45,\n \"only_when_available\": false,\n \"only_business_hours\": true,\n \"simultaneous_calls\": 2\n }\n}\nPara obtener el listado de Contactos asociados a un Mensaje de Campaña, se debe hacer un GET indicando el campaign_id y el message_id en la URL.
Soporta paginación y filtros mediante los parámetros page, limit, sort_by, sort_order y filtering.
Número de página
\n","type":"text/plain"},"key":"page","value":"1"},{"description":{"content":"Cantidad de resultados por página
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[]}},"response":[{"id":"022b66a0-128e-4eb7-a1c9-7bcdbf9e7d0c","name":"Obtención de Contactos de Mensaje de Campaña","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/nitro/campaigns/1321/messages/12/contacts?page=1&limit=10","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","nitro","campaigns","1321","messages","12","contacts"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"tracking_id\": \"wa-5001\",\n \"contact_id\": \"10000001\",\n \"phone\": \"5491123456789\",\n \"channel\": \"whatsapp\",\n \"status\": \"sent\",\n \"created_at\": \"2026-03-10 09:01:00\",\n \"case_id\": 0,\n \"channel_detail\": {\n \"whatsapp_id\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\n \"sent_at\": \"2026-03-10 09:01:05\",\n \"delivered_at\": \"2026-03-10 09:01:10\",\n \"last_open_date\": \"\",\n \"last_click_date\": \"\"\n }\n },\n {\n \"tracking_id\": \"wa-5002\",\n \"contact_id\": \"10000002\",\n \"phone\": \"5491187654321\",\n \"channel\": \"whatsapp\",\n \"status\": \"delivered\",\n \"created_at\": \"2026-03-10 09:01:00\",\n \"case_id\": 0,\n \"channel_detail\": {\n \"whatsapp_id\": \"b2c3d4e5-f6a7-8901-bcde-f12345678901\",\n \"sent_at\": \"2026-03-10 09:01:06\",\n \"delivered_at\": \"2026-03-10 09:01:12\",\n \"last_open_date\": \"2026-03-10 09:05:00\",\n \"last_click_date\": \"\"\n }\n },\n {\n \"tracking_id\": \"wa-5003\",\n \"contact_id\": \"10000003\",\n \"phone\": \"5491199887766\",\n \"channel\": \"whatsapp\",\n \"status\": \"error\",\n \"created_at\": \"2026-03-10 09:01:00\",\n \"case_id\": 0,\n \"channel_detail\": {\n \"whatsapp_id\": \"\",\n \"sent_at\": \"\",\n \"delivered_at\": \"\",\n \"last_open_date\": \"\",\n \"last_click_date\": \"\"\n }\n }\n]"}],"_postman_id":"2fa053e8-23da-4f6f-8cd8-e29c599e45f1"},{"name":"Preprocesamiento de HTML de Email","id":"b5edcb9a-9728-44a5-a82e-e8dbfd46f113","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"html\": \"Tu pedido está en camino.
\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.wcx.cloud/core/v1/nitro/html-preview","description":"Envía un bloque de HTML de email para que sea preprocesado por la plataforma y retorna el HTML resultante dentro de data.
Útil para validar y previsualizar el HTML de un email con las sustituciones y transformaciones que aplica la plataforma (tracking, links de desuscripción, estilos inline, etc.).
\nEl endpoint nitro permite la gestión y envío de campañas transaccionales y masivas del módulo Nitro de WiseCX.
A través de este endpoint es posible ejecutar envío de mensajes de WhatsApp, llamadas telefónicas como así también correos electrónicos, dependiendo de la configuración asociada a la campaña que se quiere ejecutar dentro de WiseCX.
\n","_postman_id":"6f85e018-e38c-43c6-8603-ae0d5f3061b5","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}}},{"name":"Tipos","item":[{"name":"Obtención de Tipos","id":"60a3c116-e36c-4e22-b240-4b35ab25441a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.wcx.cloud/core/v1/types","description":"Para la obtención del listado de Tipos desde el endpoint independiente /v1/types, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,name,parent_id
Soporta paginación y filtros mediante los parámetros page, limit, sort_by, sort_order y filtering.
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{jwt}}"}]},"isInherited":true,"source":{"_postman_id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","id":"aca20f24-fd5b-4dc0-926d-2c8bcdca2947","name":"Wise CX API · v1 (Español)","type":"collection"}},"urlObject":{"protocol":"https","path":["core","v1","types"],"host":["api","wcx","cloud"],"query":[],"variable":[]}},"response":[{"id":"ccd89f6b-f933-4893-96bc-7159adc14595","name":"Obtención de Tipos","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.wcx.cloud/core/v1/types?fields=id,name,parent_id","protocol":"https","host":["api","wcx","cloud"],"path":["core","v1","types"],"query":[{"key":"fields","value":"id,name,parent_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 10,\n \"name\": \"Consulta\",\n \"parent_id\": 1\n },\n {\n \"id\": 5,\n \"name\": \"Prensa\",\n \"parent_id\": 0\n },\n {\n \"id\": 6,\n \"name\": \"Comercial\",\n \"parent_id\": 5\n }\n ]\n}"}],"_postman_id":"60a3c116-e36c-4e22-b240-4b35ab25441a"}],"id":"c5f00da8-6865-46ba-ac12-c90ed603b40c","description":"Nota: Este endpoint es equivalente a
\nGET /v1/cases/typesy retorna el mismo recurso.
El endpoint /v1/types permite obtener el listado de Tipos de Wise CX de forma independiente. Soporta paginación y filtrado mediante los parámetros estándar fields, page, limit y filtering.
Para la obtención del listado de Canales integrados, se debe hacer un GET indicando mediante el parámetro fields los campos que se requieran. Los posibles campos son:
id,name,source
El endpoint channels permite obtener el listado de Canales integrados a Wise CX.