Markdown
Referência · atendimento

Janela de 24h

Confira se o contato pode receber texto livre pelo número que fará o envio.

A janela define se você pode enviar texto livre. Fora dela, use um template aprovado. Estar dentro da janela não significa que a mensagem será gratuita: a cobrança depende das regras da Meta.

GET/public/v1/window/{to}

O fluxo (link para esta seção)

Consulte o mesmo número que fará o envio antes de escolher o formato da mensagem. A Meta confirma a permissão no momento do envio, porque a janela pode vencer entre as duas chamadas.

fluxo
janela aberta   ->  POST /messages com "text" ou "template"
janela fechada  ->  POST /messages com "template" aprovado
curl
curl https://api.patrociniotech.com/public/v1/window/5521999999999 \
  -H "Authorization: Bearer SUA_CHAVE"

Resposta (link para esta seção)

200
{
  "success": true,
  "data": {
    "to": "5521999999999",
    "open": true,
    "can_send_text": true,
    "seconds_left": 84141,
    "expires_at": "2026-08-03T11:14:22.000Z",
    "last_inbound_at": "2026-08-02T11:14:22.000Z",
    "opt_in": "accepted"
  }
}
CampoO que é
openA janela está aberta agora.
can_send_textMesmo valor de open. Indica se o envio com text está permitido.
seconds_leftQuantos segundos faltam para fechar. Zero quando está fechada.
expires_atQuando fecha, em UTC. Nulo se o contato nunca escreveu.
last_inbound_atÚltima vez que o contato escreveu para você.
opt_inaccepted, pending, declined ou nulo. Vale para campanha, não para a janela.

O que abre a janela (link para esta seção)

A mensagem do contato renova a janela por 24 horas a partir do horário da mensagem. Envio, entrega e leitura de mensagens da empresa não estendem o prazo.

Se não houver mensagem recebida registrada, a resposta será open: false. Para iniciar a conversa, use um template aprovado e respeite a permissão do destinatário.

Vários números (link para esta seção)

Se a sua conta tem mais de um número conectado, a janela é por número. Passe phone_number_id para consultar a de um específico; sem ele, consultamos o número padrão, seguindo a mesma seleção usada no envio. Não combinamos janelas de números diferentes.

curl
curl "https://api.patrociniotech.com/public/v1/window/5521999999999?phone_number_id=1234567890" \
  -H "Authorization: Bearer SUA_CHAVE"

Usar a janela recebida no webhook (link para esta seção)

A consulta é opcional. O evento message.received já informa window_expires_at. Mantenha a maior validade por contato e número da empresa para escolher entre texto e template sem consultar a cada resposta.

Perto do vencimento, confirme a janela com esta consulta. Trate o erro outside_24h_window caso o prazo termine antes do envio.