Responder numa conversa

POST 
/inbox/conversations/:id/messages

Manda uma mensagem pelo número da conversa, escolhida por kind:

kind	O quê
text	Texto livre. Só com a janela de 24 horas aberta
media	Um arquivo já enviado em POST /inbox/conversations/{id}/media. Só com a janela aberta
template	Um template aprovado. Reabre a conversa a qualquer momento
note	Nota interna: fica na conversa, nunca vai para o WhatsApp

Fora da janela, text e media são recusados antes do envio com 422 window_closed e o windowExpiresAt. A resposta reabre uma conversa fechada ou adiada e pausa as automações por um tempo, como quando alguém da equipe responde.

Request

Responses

201

Mensagem registrada.

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).

404

Recurso inexistente (not_found).

409

O número da conversa não está mais conectado (phone_unavailable).

422

window_closed, contact_unreachable, media_not_found, template_unavailable, template_variables_invalid, contact_opted_out (template de marketing), meta_error ou invalid_request.

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.