curl --request POST \
--url https://clientapi.woku.app/v1/ticket-destinations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Zendesk Soporte Chile",
"kind": "zendesk",
"config": {
"connectionId": "665f1a2b3c4d5e6f7a8b9c0d",
"groupId": 360000123456
},
"credentials": {},
"routingConditions": [
{
"trackerId": "507f1f77bcf86cd799439011",
"operator": "equals",
"value": "reclamo"
}
]
}
'{
"_id": "507f1f77bcf86cd799439021",
"companyId": "<string>",
"name": "<string>",
"kind": "zendesk",
"config": {},
"aiContext": "<string>",
"routingConditions": [
{
"trackerId": "507f1f77bcf86cd799439011",
"relationToPrevious": "AND",
"operator": "equals",
"value": "<string>"
}
],
"credentialsHint": "••••a1b2",
"template": {
"preset": "custom",
"body": "<string>"
},
"enabled": true,
"status": "active",
"lastDeliveryAt": "2023-11-07T05:31:56Z",
"lastError": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"statusCode": 400,
"message": "<string>",
"error": "Bad Request"
}{
"statusCode": 403,
"message": "Authentication required",
"error": "Forbidden"
}Crea un destino de tickets
kind: zendesk | custom | email. config/credentials se validan segun el kind (ver CreateTicketDestinationRequest). routingConditions admiten el operador equals (un valor) o any (el tracker completo).
curl --request POST \
--url https://clientapi.woku.app/v1/ticket-destinations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Zendesk Soporte Chile",
"kind": "zendesk",
"config": {
"connectionId": "665f1a2b3c4d5e6f7a8b9c0d",
"groupId": 360000123456
},
"credentials": {},
"routingConditions": [
{
"trackerId": "507f1f77bcf86cd799439011",
"operator": "equals",
"value": "reclamo"
}
]
}
'{
"_id": "507f1f77bcf86cd799439021",
"companyId": "<string>",
"name": "<string>",
"kind": "zendesk",
"config": {},
"aiContext": "<string>",
"routingConditions": [
{
"trackerId": "507f1f77bcf86cd799439011",
"relationToPrevious": "AND",
"operator": "equals",
"value": "<string>"
}
],
"credentialsHint": "••••a1b2",
"template": {
"preset": "custom",
"body": "<string>"
},
"enabled": true,
"status": "active",
"lastDeliveryAt": "2023-11-07T05:31:56Z",
"lastError": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"statusCode": 400,
"message": "<string>",
"error": "Bad Request"
}{
"statusCode": 403,
"message": "Authentication required",
"error": "Forbidden"
}Autorizaciones
Clave de API de la empresa. Obtenla desde tu panel de Woku en Configuracion > API Keys. La misma clave usada para los endpoints v0.
Cuerpo
120"Zendesk Soporte Chile"
zendesk, custom, email Configuracion no secreta, especifica por tipo, validada segun el tipo:
zendesk:{ connectionId, groupId? }.connectionIdes el id de la Integration de Zendesk de la empresa;groupIdes el grupo numerico de agentes, opcional, donde llega el ticket.custom:{ url, method, headers? }.methodesPOSToPUT;headersson cabeceras adicionales no secretas (nuncaAuthorization).email:{ emails }. Hasta 20 direcciones de destinatarios; el servidor envia el ticket como un correo con formato, sin llamada externa.
Credenciales de solo escritura, especificas por tipo. La API nunca las devuelve; ver credentialsHint en la respuesta.
zendesk: se autentican a traves de la Integration de la empresa (conectada por separado en el panel). Enviar{}.custom:{ authType, ... }dondeauthTypeesnone,basic(agregausername,password),bearer(agregatoken) oapi-key-header(agregaheaderName,headerValue).email: enviar{}. El servidor es dueno del transporte de correo; no hay credencial que enviar.
Contexto en lenguaje natural por destino, inyectado en el prompt de triage de la IA.
200020Show child attributes
Show child attributes
Solo tiene sentido para kind custom; los kinds con nombre (zendesk/email) usan un preset fijo y rechazan este campo.
Show child attributes
Show child attributes
Respuesta
Destino creado
Las credenciales nunca se incluyen: credentialsHint muestra solo los ultimos 4 caracteres enmascarados del secreto almacenado (vacio para tipos que no tienen secreto propio).
"507f1f77bcf86cd799439021"
zendesk, custom, email Show child attributes
Show child attributes
Vista previa enmascarada del secreto almacenado (por ejemplo "••••a1b2"). Vacio cuando el tipo no tiene secreto propio.
"••••a1b2"
Solo tiene sentido para kind custom; los kinds con nombre (zendesk/email) usan un preset fijo y rechazan este campo.
Show child attributes
Show child attributes
error = la ultima entrega o prueba de conexion fallo (ver lastError).
active, error Motivo de falla saneado del ultimo intento de entrega. Nunca contiene credenciales.