Janela de atendimento (24 h) do contato

GET 
/contacts/:id/window

Se uma mensagem livre (fora de template) ainda chega ao contato, número a número. A janela abre quando o contato escreve e dura 24 h a partir da última mensagem dele (72 h numa conversa que veio de um anúncio de clique para o WhatsApp). Fora dela, só um template aprovado sai — e é ele que reabre a conversa.

Com from, a resposta é sobre um número da conta e traz sempre uma entrada, fechada quando o contato nunca escreveu para ele. Sem from, vêm todos os números com que o contato conversou, do que fecha mais tarde para o que fecha mais cedo, e open/expiresAt resumem o melhor deles.

Com uma API key restrita a alguns números, só aparecem esses números; um from fora deles responde 403, e um contato sem conversa neles responde 404, como um que não existe.

Request

Responses

200

Janelas do contato.

401

Token ausente, malformado, desconhecido ou revogado (authentication), ou conta suspensa (tenant_inactive).

402

Sem direito de uso (payment_required). O corpo traz o motivo em reason e a saída em action: o que fazer (kind) e a página do painel onde se faz (url).

403

O recurso informado não pertence à sua conta (forbidden), ou o caminho está na lista de bloqueio do espelho (forbidden_endpoint), ou a sua API key é restrita a alguns números e a operação é da conta inteira (forbidden).

404

Recurso inexistente (not_found).

422

Payload reprovado na validação (invalid_request, com o detalhamento em issues) ou recusado pela Meta (meta_error, com o corpo original em meta).

429

Limite de requisições excedido (rate_limit).

Response Headers

Retry-After

Segundos a aguardar antes de tentar de novo.

X-RateLimit-Category

Categoria do limite aplicada — send, media ou default.

X-RateLimit-Scope

Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).

X-RateLimit-Limit

Teto de requisições da categoria na janela atual.

X-RateLimit-Remaining

Requisições restantes na janela atual.