API V1

Integre propostas bonitas ao CRM que sua equipe já usa.

A API cria ou atualiza um rascunho e devolve o link de edição. O webhook genérico oferece o mesmo fluxo para sistemas que não permitem configurar cabeçalhos HTTP.

Conector Ollow / Moskit

API Key, URL exclusiva de webhook, importação de negócios e proteção contra eventos duplicados.

Qualquer CRM

Integração por API REST ou webhook com Pipedrive, HubSpot, RD Station, Make, n8n e sistemas próprios.

Autenticação da API

Um administrador gera a chave em Configurações → Central de integrações. Envie a chave no cabeçalho:

Authorization: Bearer pnm_live_SUA_CHAVE
Content-Type: application/json

A chave aparece somente uma vez. Gere uma nova chave se ela for perdida ou compartilhada indevidamente.

Criar ou atualizar um rascunho

POST /api/v1/quotes

{
  "externalId": "negocio-90764",
  "provider": "meu-crm",
  "title": "Academia Condomínio Tatuapé",
  "sellerEmail": "vendedor@empresa.com.br",
  "dealType": "rental",
  "client": {
    "name": "Condomínio Tatuapé",
    "document": "03.239.592/0001-97",
    "email": "sindico@condominio.com.br",
    "phone": "(11) 99999-9999",
    "postalCode": "01001-000",
    "address": "Praça da Sé, 1 · São Paulo · SP"
  }
}

Use sempre o mesmo externalId. Uma nova chamada atualiza o rascunho ligado ao negócio em vez de duplicá-lo.

Resposta

{
  "ok": true,
  "quoteId": 42,
  "quoteNumber": "ST-2026-0042",
  "editorUrl": "https://propostanamao.com.br/empresa/supertech?quote=42"
}

Consultar um orçamento

GET /api/v1/quotes/42

Webhook genérico

A Central de integrações também gera uma URL secreta. Envie nela o mesmo JSON do exemplo acima, sem o cabeçalho de autenticação.

Configurar o Ollow

No Ollow, abra Marketplace → API pública, ative o aplicativo e gere a API Key.
No Proposta na Mão, entre como administrador e cole a chave na Central de integrações.
Copie a URL exclusiva mostrada pelo sistema.
No Ollow, abra Marketplace → Webhooks, crie um webhook e selecione eventos de criação e alteração de negócios.
Faça um negócio de teste. O rascunho aparecerá na lista de orçamentos.