Versão 1.0 · Integração ativa

API de geração de sites, propostas, orçamentos e contratos

O CRM dispara um webhook com os dados do cliente. O servidor gera a página pronta, publica e devolve a URL na mesma resposta, em segundos. A automação usa essa URL para enviar ao cliente pelo canal que quiser.

1. CRM disparaA automação envia um POST com os dados do contato.

2. Servidor geraA página é montada e publicada com HTTPS.

3. Resposta imediataO JSON de retorno traz a URL pública.

4. CRM enviaA automação manda o link ao cliente.

Autenticação

Toda chamada precisa do cabeçalho de chave. Sem ele, a resposta é 401.

Cabeçalho	Valor
`X-Chave`	Chave fornecida separadamente pela R Engenharia
`Content-Type`	application/json

Importante: a chave identifica a origem e não deve ser publicada em páginas, repositórios ou no front-end. Ela vive apenas na configuração do webhook, dentro do CRM.

Endpoints

Endereço base: https://api.rengenhariaofc.com.br

POST/webhook/site

Cria um site de uma página para o cliente, com apresentação, serviços, contato e botão de WhatsApp.

POST/webhook/proposta

Gera uma proposta comercial em formato de página, com escopo, valores e condições.

POST/webhook/orcamento

Gera um orçamento com itens e total.

POST/webhook/contrato

Gera um contrato com objeto, cláusulas e condições.

GET/health

Verifica se o serviço está no ar. Não exige chave.

Campos aceitos

Todos opcionais, menos cliente. O que não for enviado simplesmente não aparece na página.

Campo	Onde se aplica	Descrição
`cliente`	todos	Nome do cliente ou do negócio. Obrigatório.
`slug`	todos	Define o endereço da página. Se omitido, é gerado pelo nome.
`titulo`	todos	Título principal exibido.
`numero`	proposta, orçamento, contrato	Número do documento.
`empresa`	proposta, orçamento, contrato	Quem emite o documento.
`introducao`	proposta, orçamento, contrato	Texto de apresentação ou objeto.
`itens`	proposta, orçamento, contrato	Lista de itens. Aceita array de objetos com `descricao` e `valor`, ou texto separado por ponto e vírgula.
`total`	proposta, orçamento, contrato	Valor total, numérico ou em texto.
`condicoes`	proposta, orçamento, contrato	Condições de pagamento.
`prazo`, `validade`	proposta, orçamento, contrato	Prazo de execução e validade da proposta.
`subtitulo`, `sobre`	site	Chamada e texto de apresentação do negócio.
`servicos`	site	Lista de serviços, separados por ponto e vírgula.
`telefone`, `email`, `endereco`	site	Dados de contato exibidos na página.
`whatsapp`	todos	Número com DDI e DDD, só dígitos. Vira botão de ação.
`cor`	todos	Cor de destaque em hexadecimal, por exemplo `#b5651d`.
`html`	todos	Se enviado, substitui o modelo e publica esse HTML direto.
`contactId`, `locationId`	todos	Identificadores do CRM, guardados junto ao registro.

Exemplo de chamada

Proposta com três itens e total.

# requisição
curl -X POST https://api.rengenhariaofc.com.br/webhook/proposta \
  -H "X-Chave: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente": "Padaria Pão Quente",
    "numero": "001",
    "empresa": "Sua Empresa",
    "titulo": "Reforma da fachada",
    "introducao": "Recuperação da fachada frontal.",
    "itens": [
      { "descricao": "Remoção do revestimento solto", "valor": 2400 },
      { "descricao": "Chapisco e emboço", "valor": 3100 },
      { "descricao": "Pintura acrílica", "valor": 1800 }
    ],
    "total": 7300,
    "condicoes": "50% na assinatura e 50% na entrega",
    "prazo": "10 dias",
    "whatsapp": "5513999887766"
  }'

# resposta
{
  "ok": true,
  "tipo": "propostas",
  "url": "https://docs.rengenhariaofc.com.br/propostas/padaria-pao-quente-001/",
  "slug": "padaria-pao-quente-001",
  "cliente": "Padaria Pão Quente",
  "mensagem": "Proposta criado: https://docs.rengenhariaofc.com.br/..."
}

Como ligar no CRM

Configuração dentro da automação, do lado de vocês.

Na automação, adicione a ação Webhook com método POST e a URL do endpoint desejado.
Inclua o cabeçalho X-Chave com a chave recebida.
Monte o corpo em JSON usando as variáveis do contato, por exemplo {{contact.name}} e {{contact.phone}}.
Na etapa seguinte, use o campo url da resposta para enviar o link ao cliente, ou grave em um campo personalizado do contato.
Se a IA de vocês montar o conteúdo, basta mandar os textos já prontos nos campos, ou enviar a página inteira pelo campo html.

Respostas de erro: 401 quando a chave está ausente ou incorreta, 400 quando falta o campo cliente, e 500 em caso de falha interna, sempre com um campo erro explicando o motivo.

Observações técnicas

Todas as páginas são publicadas com HTTPS e certificado válido, e ficam acessíveis por link direto.
Enviar o mesmo slug novamente atualiza a página existente, sem criar duplicata.
As páginas são responsivas e abrem bem no celular, que é onde o cliente final costuma clicar.
As páginas de documento não são indexadas por buscadores.
O serviço reinicia sozinho em caso de queda do servidor.