Actualizar etiquetas del chat

Establece, inserta o elimina etiquetas en un chat específico.

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/chat/{deviceId}/chats/{chatWid}/labels

Establece, inserta o elimina etiquetas en un chat específico.

Las etiquetas creadas en la plataforma siempre están disponibles. Las etiquetas sincronizadas desde

WhatsApp también se pueden asociar y desasociar en números en línea de WhatsApp Business,

y el cambio se envía a la sesión de WhatsApp. Crear,

cambiar el nombre o eliminar una etiqueta de WhatsApp solo es posible desde la

aplicación WhatsApp Business.

Por defecto, las etiquetas existentes se reemplazarán por las nuevas.

Para actualizar parcialmente las etiquetas sin reemplazar las existentes, establece el parámetro de consulta de la URL ?upsert=true.

Para eliminar etiquetas específicas, establece el parámetro de consulta de la URL ?remove=true.

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, incluyendo 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.

Parámetros

Campo	Dónde	Tipo	Obligatorio	Descripción
`upsert`	query	boolean	No	Inserta y actualiza etiquetas sin eliminar las existentes `default: False`
`remove`	query	boolean	No	Elimina solo las etiquetas especificadas en el cuerpo de la solicitud. Las demás etiquetas existentes se conservarán. `default: False`

Respuestas

Código	Descripción
`200`	Nuevas etiquetas del chat
`400`	Datos de consulta o de cuerpo de la solicitud no válidos
`401`	No autorizado: token de API no válido o ausente
`403`	Faltan los permisos requeridos
`404`	Recurso no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Servicio no disponible temporalmente: 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 chat labels
curl --request PATCH \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/labels \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '["sales","important"]'


// Upsert chat labels
curl --request PATCH \
  --url 'https://api.getincloud.ai/v1/chat/{deviceId}/chats/{chatWid}/labels?upsert=true' \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '["sales","important"]'

AnteriorActualizar el estado del chat SiguienteActualizar metadatos

¿Te sirvió esta página?