Agregar etiquetas a conversaciones

Permite segmentar conversaciones agregando etiquetas (labels). Las etiquetas son útiles para clasificar, filtrar y analizar conversaciones.

¿Cómo se ven en la interfaz?

Ver Elementos en la interfaz del agente para una referencia visual de cómo se ven las etiquetas en el panel derecho de la conversación.

---

Endpoint

POST /web-api/conversations/labels/add

Headers

Authorization: Bearer {access_token}
Content-Type: application/json

Body

{
  "account_id": "acc_123",
  "conversation_id": "conv_456",
  "labelKey": "venta_calificada"
}

Parámetros

Campo	Tipo	Requerido	Descripción
account_id	string	No*	ID de la cuenta
conversation_id	string	Si	ID de la conversación. Viene en el webhook: payload.conversation.id
labelKey	string	Si	Clave de la etiqueta a agregar

*El account_id es opcional cuando la solicitud proviene de una aplicación/bot, ya que se infiere automáticamente. Es requerido para usuarios de la organización.

---

Respuesta

{
  "success": true
}

Ejemplo

curl -X POST https://api.socialdesk.cr/web-api/conversations/labels/add \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_123",
    "conversation_id": "conv_456",
    "labelKey": "lead_calificado"
  }'

Etiquetas predefinidas

Las etiquetas (labelKey) deben estar previamente creadas en la configuración de la cuenta en Socialdesk. Consulta la plataforma para gestionar las etiquetas disponibles.

Errores comunes

Código	Error	Descripción
403	Forbidden	No tienes permisos sobre esta cuenta/organización
401	Unauthorized	Token inválido o expirado