No plano Business você já pode ler suas propostas por API e receber eventos em tempo real por webhook. Veja como começar em poucos minutos.

Chegou a API do FechaFácil

A pergunta que mais ouvimos de quem usa o FechaFácil em times maiores era a mesma: "dá para conectar isso ao meu CRM / ERP / planilha?". A partir de hoje, dá.

No plano Business, você agora tem uma API REST para consultar suas propostas e clientes, e webhooks que avisam o seu servidor a cada mudança — proposta enviada, visualizada, aceita, assinada. Tudo gerenciado numa página nova: Desenvolvedor, no menu lateral.

Por que isso importa

Sua proposta não vive sozinha. Ela faz parte de um fluxo: o lead entra no CRM, vira oportunidade, recebe a proposta, fecha (ou não). Até agora, a parte do "recebe a proposta e fecha" ficava numa ilha — você tinha que abrir o FechaFácil para saber o que estava acontecendo.

Com a API e os webhooks, esse dado passa a fluir sozinho:

Atualize o CRM automaticamente quando uma proposta for assinada.
Dispare uma cobrança no seu financeiro assim que o cliente aceitar.
Avise o time no Slack quando uma proposta quente for visualizada.
Alimente um dashboard com o seu pipeline em tempo real.

Começando em 3 passos

1. Gere uma chave de API

Em Desenvolvedor › Chaves de API, clique em Nova chave. Ela aparece uma única vez — copie e guarde com segurança. A chave começa com ff_live_.

2. Consulte a API

A API é somente leitura e responde em JSON. Autentique com a chave no header:

curl https://fechafacil.app/api/public/v1/proposals \
  -H "Authorization: Bearer ff_live_sua_chave_aqui"

Resposta:

[
  {
    "id": "a1b2c3d4-0000-4000-8000-000000000001",
    "number": 42,
    "title": "SOC 24x7 com Monitoramento Contínuo",
    "client_name": "Indústrias Martins S.A.",
    "status": "signed",
    "grand_total": "25700.00",
    "valid_until": "2026-06-30",
    "sent_at": "2026-06-01T13:20:00Z"
  }
]

Tem também GET /proposals/{id} (com os blocos da proposta) e GET /clients. A documentação interativa completa — com botão para testar as chamadas no navegador — fica em /api/docs.

3. Receba eventos por webhook

Em vez de ficar consultando a API, deixe o FechaFácil te avisar. Em Desenvolvedor › Webhooks, cadastre a URL do seu servidor e marque os eventos que quer receber. A cada evento, chega um POST:

{
  "event": "proposal.signed",
  "created_at": "2026-06-15T12:00:00Z",
  "data": {
    "id": "a1b2c3d4-0000-4000-8000-000000000001",
    "number": 42,
    "title": "SOC 24x7 com Monitoramento Contínuo",
    "status": "signed",
    "client_name": "Indústrias Martins S.A.",
    "grand_total": "25700.00"
  }
}

Eventos disponíveis: proposal.sent, proposal.viewed, proposal.accepted, proposal.signed, proposal.expired e proposal.rejected.

Feito para não te deixar na mão

Duas decisões de engenharia que valem a pena conhecer:

Retentativas automáticas. Se o seu servidor estiver fora do ar quando o evento acontecer, o FechaFácil não desiste: tenta de novo com intervalos crescentes (1 min, 5 min, 30 min, 2 h, 6 h). Você vê o status de cada entrega na própria página de Desenvolvedor.

Assinatura HMAC. Toda entrega vem assinada no header X-FechaFacil-Signature: sha256=…, calculada com o segredo do seu endpoint. Assim você confirma que a requisição veio mesmo do FechaFácil, e não de um impostor:

import hashlib, hmac

def assinatura_valida(corpo: bytes, header: str, segredo: str) -> bool:
    esperado = "sha256=" + hmac.new(segredo.encode(), corpo, hashlib.sha256).hexdigest()
    return hmac.compare_digest(esperado, header)

O que vem a seguir

Esta primeira versão é somente leitura — você consulta dados e recebe eventos. Criar e enviar propostas pela API está no roteiro. Se isso é importante para o seu fluxo, conta pra gente: ajuda a priorizar.

A API e os webhooks já estão disponíveis no plano Business. Veja os detalhes no guia API e webhooks ou abra a página Desenvolvedor se você já é Business. Ainda não é? Conheça os planos.

Chegou a API do FechaFácil — integre suas propostas aos seus sistemas