API

POST /tickets

3min

Utiliza este endpoint para crear conversaciones en AsisteClick desde tu propio sistema. Por ejemplo, puedes usar este endpoint si quieres enviar un mensaje de bienvenida a tus clientes luego de que confirmen una compra en tu tienda online. O por ejemplo, enviar una notificación de pago pendiente a través de un proceso cron en tu propio servidor.
El documento ofrece ejemplos de código en tres lenguajes de programación (Curl, Node.js, Python y Ruby) para efectuar una solicitud POST y crear una convesación. 
La respuesta obtenida es un objeto JSON que contiene información el ticket generado.
Crear una nueva conversacion
POST
Params
Header Parameters
token
required
String
Token de acceso
Body Parameters
deptid_assigned
required
Number
El ID del departamento al cual se vincula la conversación.
userid_assigned
required
Number
0 o en caso de querer asignar también la conversación a un usuario en particular colocar acá el ID del usuario.
status
required
String
OPEN / CLOSE
customer_name
required
String
El nombre del cliente.
customer_email
optional
String
NULL o el correo electrónico del cliente.
customer_phone
optional
String
NULL o el teléfono del cliente en formato Whatsapp.
channel
required
String
WHATSAPP / EMAIL
source_id
optional
Number
El número de WhatsApp integrado en AsisteClick por el cual se enviará el mensaje.
subject
required
String
El título de la conversación (solo visible por los usuarios en caso que canal = WHATSAPP).
custom_fields
optional
Object
NULL o vector con valores para campos personalizados {campo: valor}
tags
optional
Array
NULL o vector con etiquetas de la conversación (opcional).
template_id
optional
Number
El ID de la plantilla aprobada por WhatsApp que se enviará al cliente.
template_parameters
optional
Array
En caso que la plantilla tenga parámetros aquí se especifican los valores en un vector de strings.
﻿
Ejemplo de un body
JS
{ 
   "deptid_assigned": 0,
   "userid_assigned": 8,
   "status": "OPEN",
   "customer_name": "Luciano", 
   "customer_email": null,
   "customer_phone": " 5491150173420",
   "channel":  "WHATSAPP",
   "source_id": 5491170052719	,
   "subject": "ahora si!",
   "custom_fields": [{"cliente": "A-123"}],
   "tags": ["PLAN_COMPANY"],
   "template_id": 6358,
   "template_parameters": ["Franco", "Maria"]
}

{ 
   "deptid_assigned": 0,
   "userid_assigned": 8,
   "status": "OPEN",
   "customer_name": "Luciano", 
   "customer_email": null,
   "customer_phone": " 5491150173420",
   "channel":  "WHATSAPP",
   "source_id": 5491170052719	,
   "subject": "ahora si!",
   "custom_fields": [{"cliente": "A-123"}],
   "tags": ["PLAN_COMPANY"],
   "template_id": 6358,
   "template_parameters": ["Franco", "Maria"]
}
﻿
Descripción de los campos
Campo
Descripción
﻿
TOKEN
El token de la cuenta en AsisteClick.
﻿
deptid_assigned
ID del departamento al cual se asigna la conversación. 
﻿
userid_assigned
ID del usuario a quien se le asigna la conversación, además de la asignación del departamento. Colocar 0 si se quiere que la conversación esté en la bandeja Sin Asignar y visible para todos los usuarios con acceso al departamento indicado en deptid_assigned.
﻿
status
OPEN si se quiere que la conversación quede en la bandaje Sin Asignar o Asignado a un usuario en particular. Si el cliente responde su respuesta será anexada a la conversación.
CLOSED si se quiere que la conversación quede archivada. Si el cliente responde el bot responderá iniciando una nueva conversación desde el inicio. 
﻿
customer_name
Nombre del cliente
﻿
customer_email
Correo electrónico del cliente. 
Puede ser null si channel no es EMAIL.
customer_phone
El teléfono del cliente en formato Whatsapp. 
Puede ser null si channel no es WHATSAPP.
channel
WHATSAPP o EMAIL
﻿
source_id
El número de WhatsApp integrado en AsisteClick por el cual se enviará el mensaje. 
Puede ser null si channel no es WHATSAPP.
subject
El título de la conversación (solo visible por los usuarios en caso que canal = WHATSAPP). En caso que channel sea EMAIL este valor será también el título del email.
﻿
custom_fields
Vector con diccionario de campo y valor. El campo y valor aparecerán en la columna derecha de la conversación (columna de metadata) y, en caso de existir en la lógica del bot, serán también procesados por este.
Puede ser null o un vector válido como:
[{"cliente": "A-123"}]
tags
Vector con etiquetas de la conversación (opcional).
["CUSTOMER", "PLAN_COMPANY"]
template_id
El ID de la plantilla aprobada por WhatsApp que se enviará al cliente.
Puede ser null si channel no es WHATSAPP.
template_parameters
En caso que la plantilla tenga parámetros aquí se especifican los valores en un vector de strings. En el vector solo se colocan los valores del mensaje en el mismo orden en que figuran los campos en la plantilla.
Puede ser null si channel no es WHATSAPP o un vector válido como:
["Franco", "Maria"]
﻿

Updated 18 Oct 2023

Did this page help you?

GET /users

Formulario a Conversación

Campo	Descripción
TOKEN	El token de la cuenta en AsisteClick.
deptid_assigned	ID del departamento al cual se asigna la conversación.
userid_assigned	ID del usuario a quien se le asigna la conversación, además de la asignación del departamento. Colocar 0 si se quiere que la conversación esté en la bandeja Sin Asignar y visible para todos los usuarios con acceso al departamento indicado en deptid_assigned.
status	OPEN si se quiere que la conversación quede en la bandaje Sin Asignar o Asignado a un usuario en particular. Si el cliente responde su respuesta será anexada a la conversación. CLOSED si se quiere que la conversación quede archivada. Si el cliente responde el bot responderá iniciando una nueva conversación desde el inicio.
customer_name	Nombre del cliente
customer_email	Correo electrónico del cliente.	Puede ser null si channel no es EMAIL.
customer_phone	El teléfono del cliente en formato Whatsapp.	Puede ser null si channel no es WHATSAPP.
channel	WHATSAPP o EMAIL
source_id	El número de WhatsApp integrado en AsisteClick por el cual se enviará el mensaje.	Puede ser null si channel no es WHATSAPP.
subject	El título de la conversación (solo visible por los usuarios en caso que canal = WHATSAPP). En caso que channel sea EMAIL este valor será también el título del email.
custom_fields	Vector con diccionario de campo y valor. El campo y valor aparecerán en la columna derecha de la conversación (columna de metadata) y, en caso de existir en la lógica del bot, serán también procesados por este.	Puede ser null o un vector válido como: [{"cliente": "A-123"}]
tags	Vector con etiquetas de la conversación (opcional).	["CUSTOMER", "PLAN_COMPANY"]
template_id	El ID de la plantilla aprobada por WhatsApp que se enviará al cliente.	Puede ser null si channel no es WHATSAPP.
template_parameters	En caso que la plantilla tenga parámetros aquí se especifican los valores en un vector de strings. En el vector solo se colocan los valores del mensaje en el mismo orden en que figuran los campos en la plantilla.	Puede ser null si channel no es WHATSAPP o un vector válido como: ["Franco", "Maria"]