API keys

Toda integração (API REST e MCP) se identifica com uma API key da sua empresa.

Criar

No painel, Integrações → Nova API key (só o dono vê essa tela):

1. Dê um nome que diga quem vai usar (ex.: CRM da loja).

2. Marque só as permissões necessárias:

   Permissão	Libera
   conversations:read	Estado da conexão, lista de conversas e mensagens
   messages:send	Enviar mensagens
   webhooks:manage	Cadastrar e remover webhooks pela API

3. Escolha a validade: 30, 90 (padrão), 180 ou 365 dias. Toda chave vence.

A chave (fal_live_...) aparece uma única vez. Guarde num cofre de senhas ou no gerenciador de segredos do sistema — nunca no código, no front-end ou em planilha. O Falia guarda só um hash dela.

Usar

GET /api/v1/status HTTP/1.1
Host: falia.com.br
Authorization: Bearer fal_live_...

Trocar e revogar

• A lista mostra o início da chave, as permissões, o último uso e o vencimento (aviso quando faltam menos de 15 dias).
• Para trocar: crie a nova, atualize o sistema e revogue a antiga. A revogação vale na hora.
• Revogue também quando alguém que conhecia a chave sair da empresa ou se suspeitar de vazamento.

Limites e proteção

Limite	Valor
Requisições por chave	600 por minuto (429 com Retry-After ao passar)
Mensagens enviadas pela API/MCP	1000 por dia por empresa
Chaves ativas	20 por empresa
Tentativas com chave inválida	30 a cada 15 min por IP; depois, bloqueio temporário

Criação, revogação, uso recusado e cada mensagem enviada ficam nos Logs da empresa.