Skip to main content
PATCH

Autorizaciones

​
Authorization
string
header
requerido

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

​
id
string
requerido

ObjectId de MongoDB del destino de tickets.

Pattern: ^[0-9a-fA-F]{24}$

Cuerpo

application/json

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.

​
name
string
Maximum string length: 120
​
kind
enum<string>
Opciones disponibles:
zendesk,
salesforce,
slack,
custom,
email
​
config
object

Configuracion no secreta, especifica por tipo, validada segun el tipo:

  • zendesk: { connectionId, groupId? }. connectionId es el id de la Integration de Zendesk de la empresa; groupId es el grupo numerico de agentes, opcional, donde llega el ticket.
  • salesforce: { queueId?, caseOrigin? }. queueId es un id de Case Queue ("00G...", 15 o 18 caracteres); caseOrigin por defecto es "Web".
  • slack: { connectionId, channelId, channelLabel? }. connectionId es el id de la Integration de Slack de la empresa; channelId es el id del canal de Slack ("C..."); channelLabel es un nombre solo de visualizacion (por ejemplo "#soporte").
  • custom: { url, method, headers? }. method es POST o PUT; headers son cabeceras adicionales no secretas (nunca Authorization).
  • email: { emails }. Hasta 20 direcciones de destinatarios; el servidor envia el ticket como un correo con formato, sin llamada externa.
​
credentials
object

Presente = rotacion de credencial. Credenciales de solo escritura, especificas por tipo. La API nunca las devuelve; ver credentialsHint en la respuesta.

  • zendesk, salesforce, slack: se autentican a traves de la Integration de la empresa (conectada por separado en el panel). Enviar {}.
  • custom: { authType, ... } donde authType es none, basic (agrega username, password), bearer (agrega token) o api-key-header (agrega headerName, headerValue).
  • email: enviar {}. El servidor es dueno del transporte de correo; no hay credencial que enviar.
​
aiContext
string
Maximum string length: 2000
​
routingConditions
object[]
Maximum array length: 20
​
template
object

Solo tiene sentido para kind custom; los kinds con nombre (zendesk/salesforce/slack/email) usan un preset fijo y rechazan este campo.

​
enabled
boolean

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).

​
_id
string
Ejemplo:

"507f1f77bcf86cd799439021"

​
companyId
string
​
name
string
​
kind
enum<string>
Opciones disponibles:
zendesk,
salesforce,
slack,
custom,
email
​
config
object
​
aiContext
string
​
routingConditions
object[]
​
credentialsHint
string

Vista previa enmascarada del secreto almacenado (por ejemplo "••••a1b2"). Vacio cuando el tipo no tiene secreto propio.

Ejemplo:

"••••a1b2"

​
template
object

Solo tiene sentido para kind custom; los kinds con nombre (zendesk/salesforce/slack/email) usan un preset fijo y rechazan este campo.

​
enabled
boolean
predeterminado:true
​
status
enum<string>

error = la ultima entrega o prueba de conexion fallo (ver lastError).

Opciones disponibles:
active,
error
​
lastDeliveryAt
string<date-time>
​
lastError
string

Motivo de falla saneado del ultimo intento de entrega. Nunca contiene credenciales.

​
createdAt
string<date-time>
​
updatedAt
string<date-time>