Markdown
API autenticada · somente leitura

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
curl "https://api.patrociniotech.com/public/v1/tags?limit=50" \
  -H "Authorization: Bearer SUA_CHAVE"
JSON · resposta de exemplo
{
  "success": true,
  "data": {
    "tags": [
      {
        "id": 123,
        "name": "Agências parceiras",
        "contacts_count": 4795
      },
      {
19 linhas
CampoSignificado
idNúmero inteiro estável da etiqueta. Renomear no painel mantém o ID.
nameNome exato, com os mesmos acentos, maiúsculas e espaços do painel.
contacts_countContatos 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_idCursor da próxima página. null indica fim da lista.
checked_atMomento UTC da consulta. Não é a data de criação ou renomeação da etiqueta.

Paginação e atualização (link para esta seçã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
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.

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.