Recursos por número

​

Como os valores são produzidos

• Os valores vêm de uma conexão de dispositivo vinculado. Um número que nunca teve uma (conectado apenas pela API oficial) informa status unknown. Um número cuja conexão de dispositivo vinculado foi removida mantém os últimos valores sincronizados.
• Os valores refletem a configuração do WhatsApp em syncedAt. Eles não são uma verificação ao vivo. Uma alteração feita pelo WhatsApp aparece depois da próxima sincronização do número.
• Os valores descrevem a última conta do WhatsApp vinculada ao número, esteja ela conectada agora ou não. Leia a sessão do número para saber o status da conexão.
• status é unknown e todo value é null antes da primeira sincronização do número e quando outra conta do WhatsApp é vinculada ao número: desde a primeira tentativa de sincronização dessa conta até a configuração dela ser sincronizada. A Polymorfa reconhece outra conta pelo horário de criação da conta que o WhatsApp informa quando o número acessa o WhatsApp. Se o WhatsApp não informar esse horário para a conta recém-vinculada, a troca não é detectada, e os valores continuam sendo os da conta para a qual foram sincronizados até a próxima sincronização. Quando a Polymorfa não consegue saber se a configuração armazenada pertence à conta vinculada agora, status também fica unknown até a configuração do WhatsApp ser sincronizada de novo para essa conta; tentativas de sincronização com falha não mudam isso.
• Um recurso diz o que o WhatsApp permite ao número. Ele não significa que a API da Polymorfa oferece uma operação para esse recurso.
• source é server apenas quando todas as configurações usadas para avaliar um valor foram enviadas pelo WhatsApp e usadas como foram enviadas; caso contrário, o padrão ou o limite do próprio WhatsApp entrou na avaliação, e source é client_default.

​

Antes de começar

• A sua equipe participa do beta. Sair do beta faz as leituras de recursos serem recusadas; os números e todas as outras APIs não são afetados.
• Você chama a partir do seu servidor com uma chave de organização ou um token de projeto que tenha o escopo sessions:read. Um token de projeto alcança apenas os números do próprio projeto. Tokens de cliente são rejeitados.

​

Ler os recursos de um número

curl "https://api.polymorfa.com/platform/sessions/support-line/capabilities" \
  -H "Authorization: Bearer $POLYMORFA_PROJECT_TOKEN"

{
  "data": {
    "session": "support-line",
    "projectId": "0198a2cb-0000-7000-8000-000000000002",
    "status": "synced",
    "syncedAt": "2026-09-24T10:00:00.000Z",
    "checkedAt": "2026-09-24T11:00:00.000Z",
    "accountType": "business",
    "capabilities": [
      { "key": "channels", "kind": "feature", "unit": null, "value": true, "source": "server" },
      { "key": "messageEdit.windowSeconds", "kind": "limit", "unit": "seconds", "value": 1200, "source": "client_default" },
      { "key": "polls.maxOptions", "kind": "limit", "unit": "count", "value": 12, "source": "client_default" }
    ]
  }
}

​

Recursos

​

Erros

​

Recursos de grupo

​

Eventos de alteração de recursos