Subir arquivo para uma conversa

POST 
/inbox/conversations/:id/media

Envie os bytes do arquivo no corpo (não é multipart), com o nome em X-File-Name. O tipo é detectado pelo conteúdo: imagem (JPEG, PNG), figurinha (WebP), vídeo (MP4, 3GP), áudio, PDF, documentos do Office e texto. Limites: imagem 5 MB, vídeo e áudio 16 MB, documento 100 MB, figurinha 500 KB. Use o id devolvido como assetId numa resposta kind: media.

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

413

Acima do limite do tipo (media_too_large, com limit e kind).

415

Tipo de arquivo não reconhecido (media_type_not_allowed).

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.