Crear departamento

Crea un nuevo departamento de equipo 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.

POST https://api.getincloud.ai/v1/devices/{deviceId}/departments

Crea un nuevo departamento de equipo en el número de WhatsApp actual.

Para crear un nuevo departamento, debes proporcionar un nombre, un color y una lista de miembros del equipo (agentes) que se añadirán al nuevo departamento.

El nombre del departamento debe ser único. Cada departamento puede tener de 1 hasta 30 miembros del equipo.

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

Campo	Tipo	Obligatorio	Descripción
`name`	string	Sí	Nombre del departamento `minLength: 2` · `maxLength: 25`
`color`	string	Sí	Nombre 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']`
`icon`	string	Sí	Identificador 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'] · `default: briefcase`
`description`	string	No	Descripción del departamento. Opcional `minLength: 0` · `maxLength: 300`
`agents`	array<string>	Sí	Lista de IDs de usuarios agentes que se incluirán en el departamento. Se requiere al menos un agente

Respuestas

Código	Descripción
`200`	Canal creado
`400`	Datos de consulta o cuerpo de la solicitud no válidos
`401`	Acceso no autorizado por token de API no válido o caducado
`403`	Operación no admitida: se requiere actualizar el plan
`404`	Número no encontrado
`409`	Ya existe un canal con el mismo nombre
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Operació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

// Create a new channel
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/departments \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"Support Team","color":"red","description":"This is a sample department description","agents":["5f7b1b1b1b1b1b1b1b1b1b1b"]}'

AnteriorCrear canal SiguienteCrear enlace de reunión

¿Te sirvió esta página?