Capacidades e Limites

O que cada canal suporta, os planos de licença e os limites da plataforma.

Capacidades por canal

Os três canais são conectados da mesma forma (OAuth). A tabela abaixo mostra o que cada canal suporta.

Recurso	WhatsApp	Instagram	Facebook Messenger
Texto de saída — tamanho máximo	4096 chars	1000 chars	2000 chars
Mídia de saída (Pro)	image, audio, video, document	image, audio, video, document	image, audio, video, document
Mensagens de modelo (Pro)	✅ Obrigatórias fora da janela de 24h	❌ Não suportado	❌ Não suportado
Webhooks recebidos — texto	✅ `type: "text"`	✅ `type: "text"`	✅ `type: "text"`
Webhooks recebidos — mídia (Pro)	image, audio, video, document, sticker	image, audio, video, document	image, audio, video, document
Status de entrega	`sent` `delivered` `read` `failed`	`delivered` `read`	`delivered` `read`
Formato do destinatário	Número de telefone sem `+`	IGSID	PSID
Contorno da janela de 24h	Usar modelos aprovados	Nenhum — aguardar o usuário enviar mensagem	Nenhum — aguardar o usuário enviar mensagem
Identificador do canal	`phone_number_id`	`ig_account_id`	`page_id`
Perfil do remetente	`data.from_name` (dos contatos da Meta)	Via endpoint de perfil	Via endpoint de perfil

Observação: Cada conta Meta (número de telefone, conta do Instagram ou Página do Facebook) só pode estar conectada a um usuário Fiwano por vez.

Planos de licença

O Fiwano oferece dois planos de licença. Cada canal conectado exige uma licença ativa.

Plano	Mensal	Capacidades
Starter	US$ 12	Mensagens de texto recebidas e enviadas ilimitadas, status de entrega
Pro	US$ 19	Tudo do Starter + mídia recebida com arquivos, mídia enviada via URL HTTPS (URLs assinadas suportadas), gerenciamento e envio de modelos do WhatsApp

Contas novas começam com um período de teste gratuito de 7 dias (plano Pro). Para o ciclo de cobrança e como o estado de assinatura de um canal é reportado, veja Assinaturas e Cobrança. Para entender como essa taxa fixa se relaciona com as tarifas por mensagem da própria Meta, veja Custos de Mensagens Explicados.

Limites de taxa

Os envios são limitados a 10 tentativas de envio aceitas por segundo por canal, somadas entre todas as API keys. Texto, mídia e modelos compartilham esse limite: criar outra key não aumenta a capacidade de um canal, enquanto uma única key pode operar vários canais de forma independente. Ao excedê-lo, a API retorna HTTP 429 com Retry-After. As outras operações da API pública não compartilham um limite global de RPS. Em saturação excepcional do envio, uma tentativa pode retornar brevemente HTTP 503 + Retry-After; respeite o header e tente novamente. A Meta também aplica limites próprios por canal e destinatário (fora do controle do Fiwano).

Janelas de mensagem (24h)

A Meta restringe quando você pode enviar mensagem a um usuário fora de uma conversa aberta:

WhatsApp — você só pode enviar texto comum dentro de 24 horas da última mensagem do cliente. Fora da janela, use um modelo aprovado via POST /api/v1/messages/send-template. Isso é política da Meta.
Instagram e Facebook Messenger — você só pode responder dentro de 24 horas da última mensagem do usuário. Não há contorno por modelo — aguarde o usuário enviar mensagem novamente.

Limites de mídia

Tamanho de arquivo enviado

A Meta baixa sua media_url e aplica seus próprios limites por plataforma. O Fiwano não reverifica o arquivo, então um arquivo acima do limite é rejeitado pela Meta com error_code 100 e a mensagem não é repetida — veja Erros.

Tipo de mídia	WhatsApp	Instagram
Imagem	5 MB (JPEG, PNG)	8 MB (JPEG, PNG)
Vídeo	16 MB (MP4, 3GPP)	25 MB (MP4, OGG, AVI, MOV, WebM)
Áudio	16 MB (AAC, AMR, MP3, MP4, OGG)	25 MB (AAC, M4A, WAV, MP4)
Documento	100 MB (PDF, Office, texto)	25 MB (PDF)

A Meta não publica limites por tipo para a Send API do Facebook Messenger. Trate os valores do Instagram como suposição segura para o Messenger e trate a rejeição por tamanho em vez de confiar em um número fixo.

Estes são limites da Meta e podem mudar. Note que a sobrecarga de codificação pode ultrapassar o limite mesmo quando o tamanho em disco parece seguro.

Tamanho de arquivo recebido

Mídia recebida (imagens, áudio, vídeo, documentos) é armazenada temporariamente por 60 minutos. Baixe-a via GET /api/v1/media/{media_id} prontamente após o webhook; os arquivos são removidos automaticamente após a expiração. Tamanho máximo de arquivo: 10 MB.
Licença Pro obrigatória para enviar/receber mídia e usar modelos do WhatsApp. Com uma licença Starter, a mídia recebida chega como type: "unsupported" com upgrade_required: "pro". Veja Assinaturas e Cobrança.