curl --request PATCH \
--url https://clientapi.woku.app/v1/ticket-destinations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"credentials": {
"authType": "bearer",
"token": "sk_live_new"
}
}
'{
"_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"
}{
"statusCode": 404,
"message": "External tracker not found",
"error": "Not Found"
}Actualiza un destino de tickets
Todos los campos son opcionales. Enviar credentials rota el secreto almacenado. Enviar kind cambia el proveedor; luego config/credentials se validan contra el NUEVO kind.
curl --request PATCH \
--url https://clientapi.woku.app/v1/ticket-destinations/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"credentials": {
"authType": "bearer",
"token": "sk_live_new"
}
}
'{
"_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"
}{
"statusCode": 404,
"message": "External tracker not found",
"error": "Not Found"
}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.
Parámetros de ruta
ObjectId de MongoDB del destino de tickets.
^[0-9a-fA-F]{24}$Cuerpo
Todos los campos son opcionales; solo se cambian los que estan presentes. Un payload de credentials rota el secreto almacenado (se revalida y se vuelve a cifrar). kind puede cambiar: entonces config/credentials se validan contra el NUEVO tipo.
120zendesk, 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.
Presente = rotacion de credencial. 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.
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 actualizado
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.