Actualizar etiqueta

Actualiza una etiqueta existente por su nombre.

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}/labels

Actualiza una etiqueta existente por su nombre.

Solo se pueden actualizar la descripción y el color de la etiqueta. El nombre de la etiqueta no es editable, pero puedes eliminar una etiqueta y crear una nueva con un nombre diferente.

Las etiquetas actualizadas mediante la API no se sincronizan con la cuenta de WhatsApp vinculada, por lo tanto, las actualizaciones de etiquetas solo estarán disponibles a través del chat multiagente y la API.

Nota: este endpoint está limitado a los planes con soporte de chat multiagente.

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í	`minLength: 1` · `maxLength: 30`
`description`	['string', 'null']	No	`minLength: 2` · `maxLength: 100`
`color`	string	Sí	`enum: ['ruby', 'tomato', 'orange', 'sunflower', 'bubble', 'rose', 'poppy', 'rouge', 'raspberry', 'purple', 'lavender', 'violet', 'pool', 'emerald', 'kelly', 'apple', 'turquoise', 'aqua', 'gold', 'latte', 'cocoa', 'iron']`

Respuestas

Código	Descripción
`200`	Etiquetas actualizadas
`400`	Campos del cuerpo inválidos o faltantes
`401`	Acceso no autorizado debido a un token de API inválido o caducado
`403`	Falta el token de API requerido
`404`	Número no encontrado
`409`	Conflicto: el atajo de la etiqueta ya existe
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio temporalmente no disponible: inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Update label
curl --request PATCH \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/labels \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"welcome","color":"orange"}'

AnteriorActualizar el estado de la cola SiguienteActualizar grupo

¿Te sirvió esta página?