Etiquetas

​

O que são Etiquetas

​

API Pública — enviar mensagem

"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"]
  }'

{
  "id": "cmm04obm46zz0qv4ycjp8x6r2",
  "correlationId": "b3f1c2a4-9e7d-4c5a-8f21-0a1b2c3d4e5f",
  "status": "QUEUED",
  "createdAt": "2026-07-04T12:00:00.000Z",
  "origin": "api"
}

​

Retenção (PII)

• STORE_INDEFINITE (padrão) — conversas e mensagens são armazenadas indefinidamente.
• STORE_X_DAYS — apenas os últimos N dias de registros de chat são mantidos; registros mais antigos são apagados diariamente.
• RELAY_ONLY — as conversas não são persistidas. As Etiquetas em si ainda são criadas quando você passa labels na API de envio, mas nenhum conteúdo de conversa é armazenado.

​

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