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

Cada chave de API tem direito a ~600 requisições/minuto (sustentadas) com picos curtos acima disso. Exceder esse limite retorna HTTP 429 com um header Retry-After indicando quantos segundos esperar; respostas bem-sucedidas trazem X-RateLimit-Limit e X-RateLimit-Remaining para você se autorregular. Sob carga agregada excepcional, a plataforma pode descartar requisições brevemente com HTTP 503 + Retry-After — trate 429 e 503 da mesma forma: respeite Retry-After e tente novamente. Isso é uma proteção generosa, não um limite rígido do produto — se você precisa de mais throughput sustentado, fale conosco. A Meta tem seus próprios limites por canal (exibidos no Meta Business Manager, 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

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.