Pular para o conteúdo principal

​
O que são Etiquetas

Etiquetas marcam destinos (telefone E.164 ou grupo do WhatsApp ...@g.us) no escopo do tenant. Gerencie-as em Config → Etiquetas (/labels): crie etiquetas, importe CSV/Excel, edite nome/destino, copie um contato de uma etiqueta para outra.
Página de Labels do Pilot Status

​
API Pública — enviar mensagem

Em POST /v1/messages/send, opcionalmente envie: 
"labels": ["vip", "customers"]
  • Funciona com destinationNumber ou groupId.
  • O processamento de etiquetas é assíncrono: faz upsert das Etiquetas por nome e associa o destino.
  • A plataforma pode tentar preencher o nome de exibição do contato a partir dos dados do WhatsApp na instância conectada quando ainda estiver vazio.

​
Exemplo

curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_your_key_here" \
  -d '{
    "destinationNumber": "+5511999999999",
    "templateId": "order_update",
    "labels": ["vip", "customers"]
  }'

​
Retenção (PII) e chave de API

A retenção é configurada por chave de API (retentionDays em /api-keys).
  • Se retentionDays > 0: as linhas de etiqueta–contato podem armazenar destino/metadados conforme a política.
  • Se retentionDays = 0: ao usar a API pública com labels, as Etiquetas ainda são criadas, mas as linhas de contato não são persistidas (sem armazenamento de PII para essa associação).

​
Importação pela interface

  • Colunas de telefone: iguais às de Mensagens (number, destinationnumber, phone, etc.).
  • Coluna de grupo opcional: groupId, group — se terminar com @g.us, a linha é tratada como GRUPO.
  • Se o mesmo destino já existir na etiqueta com um nome vazio e a importação fornecer um nome, o nome é atualizado.

​
Copiar contato

Use Copiar para… para duplicar o vínculo em outra etiqueta (deduplicação por destino; preenche o nome no destino quando estiver vazio).