# Etiquetas de contato

Sincronize o catálogo interno usado para segmentar campanhas. Os nomes são os mesmos exibidos no painel.

### GET /public/v1/tags

Use a mesma chave Bearer da integração, exclusivamente no backend. A consulta lista apenas as etiquetas da empresa da chave, incluindo etiquetas sem contatos. Não envia mensagens nem altera contatos, etiquetas ou consentimentos.

cURL · primeira página

```bash
curl "https://api.patrociniotech.com/public/v1/tags?limit=50" \
  -H "Authorization: Bearer SUA_CHAVE"
```

JSON · resposta de exemplo

```json
{
  "success": true,
  "data": {
    "tags": [
      {
        "id": 123,
        "name": "Agências parceiras",
        "contacts_count": 4795
      },
      {
        "id": 122,
        "name": "Lista em revisão",
        "contacts_count": 0
      }
    ],
    "next_before_id": null,
    "checked_at": "2026-11-10T12:00:00Z"
  }
}
```

| Campo | Significado |
| --- | --- |
| id | Número inteiro estável da etiqueta. Renomear no painel mantém o ID. |
| name | Nome exato, com os mesmos acentos, maiúsculas e espaços do painel. |
| contacts\_count | Contatos vinculados por número de atendimento, unindo aliases comprovados. Uma pessoa vinculada em dois números pode contar duas vezes. Não é o público elegível para envio. |
| next\_before\_id | Cursor da próxima página. null indica fim da lista. |
| checked\_at | Momento UTC da consulta. Não é a data de criação ou renomeação da etiqueta. |

## Paginação e atualização

A ordem é por ID decrescente. `limit` aceita de 1 a 100 (padrão 50). Se `next_before_id` vier preenchido, repita com `before_id` e o mesmo limite. O cursor funciona como em `GET /deliveries`. Parâmetros inválidos retornam 422 `invalid_request`; autenticação e cota seguem as regras comuns da API.

cURL · próxima página

```bash
curl "https://api.patrociniotech.com/public/v1/tags?limit=50&before_id=122" \
  -H "Authorization: Bearer SUA_CHAVE"
```

Atualize o catálogo completo com cache curto no seu backend e antes de criar uma campanha ou link. Substitua o cache somente depois de ler todas as páginas com sucesso. Uma criação, exclusão ou renomeação durante a consulta pode exigir nova leitura. Não há `updated_at` por etiqueta nem eventos `tag.created` ou `tag.renamed` nesta versão.

## Proteger nomes internos em links públicos

Compare os nomes com os parâmetros públicos, como `utm_campaign` e `utm_content`, após decodificar a URL e normalizar caixa, acentos e separadores no seu sistema. Use códigos próprios de campanha e variação no link, sem copiar etiquetas internas. A Patrocinio fornece o catálogo; a validação do link acontece na integração.

> Uma etiqueta e sua contagem não comprovam autorização para marketing. Confira consentimento e pedidos de saída separadamente. Em falha de sincronização, não trate uma lista vazia como catálogo válido: mantenha o último cache válido e sinalize a atualização pendente.

---

Fonte: https://patrociniotech.com/documentacao-api/etiquetas
Índice para IA: https://patrociniotech.com/documentacao-api/llms.txt