/org

Devolve a organização da chave, o plano contratado, os limites e o consumo do mês.

Não exige escopo específico: qualquer chave válida lê os dados da própria organização. Limite: 60 requisições por minuto.

Endpoints

Método	Rota	Devolve
GET	`/org`	Organização, plano, limites e consumo
GET	`/org/usage`	Só o consumo do mês corrente

Exemplo

curl "https://api.wevi.chat/functions/v1/org" \
  -H "Authorization: Bearer wevi_SUA_CHAVE"

const res = await fetch("https://api.wevi.chat/functions/v1/org", {
  headers: { Authorization: "Bearer wevi_SUA_CHAVE" },
});
const org = await res.json();

if (org.usage.conversations_this_month >= (org.plan.limits.conversations_per_month ?? Infinity)) {
  console.warn("Limite de conversas do mês atingido");
}

Resposta

{
  "id": "746853d9-c2c9-44b1-8557-56e2129953dc",
  "name": "Clínica OdontoVita",
  "slug": "odonto-vita",
  "type": "client",
  "is_partner": false,
  "custom_domain": null,
  "created_at": "2026-06-12T11:47:26Z",
  "plan": {
    "tier": "pro",
    "trial_ends_at": null,
    "limits": {
      "agents": 5,
      "conversations_per_month": null,
      "rag_files": null,
      "members": 5,
      "campaign_sends_per_month": 5000,
      "whatsapp": true,
      "campaigns": true,
      "api_write": true,
      "multi_agent": true
    }
  },
  "usage": {
    "period_start": "2026-09-01T00:00:00Z",
    "conversations_this_month": 22,
    "campaign_sends_this_month": 0,
    "agents": 5,
    "rag_files": 7,
    "members": 2
  }
}

Limite sem teto vem como null, porque JSON não representa infinito. No exemplo acima, o plano Pro não limita conversas por mês nem arquivos na base de conhecimento.

api_write diz se o plano permite escrever e enviar mensagem pela API. Leitura funciona em qualquer plano.

Serve bem para um alerta interno: cheque usage contra limits no seu monitoramento e avise a equipe antes de bater o teto.

`alerts`

A resposta traz uma lista alerts com o que está quebrado agora:

`type`	Quando aparece
`webhook_failing`	Um webhook está falhando há mais de uma hora, ou foi desligado depois de 3 dias falhando.
`connection_config_error`	Um número de WhatsApp está com erro de configuração e não envia.
`api_key_expiring`	Uma chave vence nos próximos 7 dias.

Cada item traz message já pronta em português, severity (warning ou error), o resource_id do que está com problema e um detail que varia por tipo.

Vem vazio quando está tudo certo. Consulte de tempos em tempos e avise o seu time: é mais barato que descobrir pelo cliente.

/health

→