Etiquetas

As etiquetas que a organização usa para classificar conversas.

Operação	Endpoint
Listar etiquetas	`GET /tags`

Listar etiquetas

GET/tags

Lista as etiquetas da organização, em ordem alfabética. Sem paginação: a lista é curta.

Permissão exigida na chave: configuracao:read.

Resposta 200

Uma lista de objetos Tag em data.

Erros

Status	Quando
`401`	`unauthenticated`: Não autenticado. `invalid_credential`: Credencial inválida.
`403`	`insufficient_scope`: Escopo insuficiente.
`429`	`rate_limited`: Limite de requisições atingido. Tente de novo depois do tempo indicado em Retry-After.
`500`	`internal_error`: Erro interno. Tente de novo; se persistir, fale com o suporte informando o X-Request-Id.

O corpo segue o formato de Erros.

Exemplo

curl "https://app.conectaai.io/api/v1/tags" \
  -H "Authorization: Bearer $CONECTAAI_API_KEY"

Resposta 200:

{
  "data": [
    {
      "id": "8f0c2a4e-1b7d-4c55-9a1e-3d2f6b7c8a90",
      "slug": "sem-conexao",
      "name": "Sem conexão",
      "description": null,
      "kind": "general",
      "created_at": "2026-11-09T14:32:05.120Z"
    }
  ]
}

Objeto Tag

Etiqueta que a organização usa para classificar conversas.

Campo	Tipo	Descrição
`id`	texto	Identificador da etiqueta.
`slug`	texto	Chave da etiqueta. É o valor que aparece em `tags` da conversa.
`name`	texto	Nome exibido.
`description`	texto ou `null`	Descrição escrita pela equipe.
`kind`	`general`, `resolution`	general: etiqueta comum. resolution: marca como a conversa foi resolvida.
`created_at`	texto	Quando a etiqueta foi criada. Data e hora em ISO 8601, UTC.

Contatos Agentes