API de WhatsApp y CRM
PATCH/devices/{deviceId}/departments

Actualizar departamento

Actualiza un departamento por ID en el número de WhatsApp actual.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
PATCH https://api.getincloud.ai/v1/devices/{deviceId}/departments

Actualiza un departamento por ID en el número de WhatsApp actual.

Nota: este recurso de la API solo está disponible en las suscripciones Platform Business y Enterprise con acceso a la función Team Chat.


Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

CampoTipoObligatorioDescripción
departmentstringSíID único del departamento a actualizar. Obligatorio minLength: 24 · maxLength: 24 · pattern: ^[0-9A-Fa-f]{24}$
namestringNoNombre del departamento minLength: 2 · maxLength: 25
colorstringNoNombre del color del departamento, usado para identificarlo rápidamente enum: ['ruby', 'tomato', 'orange', 'sunflower', 'bubble', 'rose', 'poppy', 'rouge', 'raspberry', 'purple', 'lavender', 'violet', 'pool', 'emerald', 'kelly', 'apple', 'turquoise', 'aqua', 'gold', 'latte', 'cocoa', 'iron']
iconstringNoIdentificador del icono del departamento. Por defecto es el icono briefcase enum: ['briefcase', 'users', 'user-tie', 'chart-bar', 'clipboard-list', 'comments', 'headset', 'user-cog', 'user-edit', 'user-friends', 'laptop-code', 'network-wired', 'building', 'handshake', 'address-book', 'layer-group', 'project-diagram', 'calendar-check', 'clipboard-check', 'tasks', 'chart-pie', 'hands-helping', 'shield-alt', 'user-lock', 'user-shield', 'bullhorn', 'comments-dollar', 'comment-dots', 'fingerprint', 'check-circle', 'chalkboard-teacher', 'cogs', 'rocket', 'drafting-compass', 'lightbulb', 'envelope', 'inbox', 'people-carry', 'code-branch', 'globe', 'hand-holding-usd', 'money-bill-wave', 'phone', 'wrench', 'balance-scale', 'thumbs-up', 'user-secret', 'user-graduate', 'landmark', 'archive']
descriptionstringNoDescripción del departamento. Opcional minLength: 0 · maxLength: 300
agentsarray<string>NoLista de IDs de usuarios agentes que se incluirán en el departamento

Respuestas

CódigoDescripción
200Departamentos
400Datos de consulta o cuerpo de la solicitud no válidos
401Acceso no autorizado debido a un token de API no válido o caducado
403Faltan los permisos de canal necesarios o la función no es compatible con el plan actual
404Número no encontrado
409Conflicto
429Demasiadas solicitudes: inténtalo de nuevo más tarde
500Error inesperado
501No implementado
503Operación o sesión de WhatsApp no disponible: inténtalo de nuevo
// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Update department information and team members
curl --request PATCH \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/departments \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"Sales","color":"blue","agents":["5f7b1b1b1b1b1b1b1b1b1b1b","5f710b1b1b1b1b1a1a1a1c1a"]}'
AnteriorActualizar canalSiguienteActualizar el estado de la cola
¿Te sirvió esta página?