Para agentes e assistentes

Em poucas palavras: Um agente de IA pode registar um pedido de orçamento sem formulário: envia JSON para POST /api/orcamento (o email da pessoa é obrigatório) e recebe 201, ou 422 a dizer que campos falham. Existe ainda um servidor MCP em /mcp, com a ferramenta pedir_orcamento, e a especificação OpenAPI em /openapi.json.

Esta página serve modelos e agentes que respondem a perguntas sobre fossas no distrito de Braga, ou que pedem orçamento por conta de uma pessoa.

Nome: Fossa Séptica Braga
Trabalhos: Fossas sépticas novas, depósitos estanques, ETAR compactas para casas, poços absorventes, valas de infiltração, grupos de bombagem e troca de fossas velhas. Inclui ida ao terreno, cálculo do volume e licenças.
Onde: Os 14 concelhos do distrito de Braga. Com página própria: Vila Nova de Famalicão, Vila Verde, Celorico de Basto, Póvoa de Lanhoso, Cabeceiras de Basto, Amares, Esposende, Braga, Barcelos, Guimarães, Fafe, Vieira do Minho, Vizela, Terras de Bouro.
Valores: Despejo de 2 000–3 000 L: 240 a 300 €, IVA incluído. Fossa séptica nova, obra completa: o nosso preço indicativo é 3 000 a 8 500 €. Mais em dados e preços.
Email: ola@fossasepticabraga.pt
Revisto a: 22 de outubro de 2026

Pedido por API

Envie POST https://fossasepticabraga.pt/api/orcamento com corpo JSON (Content-Type: application/json). Um GET ao mesmo endereço lista os campos aceites; a especificação está em /openapi.json.

Campos exigidos: nome, email, concelho (tem de ser um concelho do distrito de Braga), servico (um de «Fossa séptica nova», «Substituir fossa antiga», «ETAR compacta», «Não sei») e consentimento_rgpd: true, que só a própria pessoa pode dar.
Campos facultativos: telefone, freguesia, imovel, pessoas, prazo, rede_esgoto, mensagem, consentimento_marketing, origem.
Códigos: 201 traz a referencia; 422 traz detalhes campo a campo; 400 se o JSON não abrir; 413 se o corpo for grande; 415 se o tipo não for JSON; 429 se houver pedidos a mais.
Se o mesmo pedido chegar duas vezes no mesmo dia, contamo-lo uma só vez. O cabeçalho X-Dry-Run: 1 valida sem gravar.

{
  "nome": "Ana Silva",
  "email": "ana@example.com",
  "concelho": "Vila Verde",
  "servico": "Fossa séptica nova",
  "pessoas": "3–4",
  "mensagem": "Moradia em Vila Verde sem coletor na rua; entrada larga para a retroescavadora.",
  "consentimento_rgpd": true
}

MCP

Ponto de entrada: https://fossasepticabraga.pt/mcp (JSON-RPC sobre Streamable HTTP). O cartão está em /mcp/server-card. Há três ferramentas:

pedir_orcamento: regista o pedido, com os campos e validações da API; sem email não passa.
consultar_precos: devolve os valores que praticamos.
zonas_servidas: devolve os concelhos.

Descoberta: /.well-known/api-catalog. Texto para modelos: llms.txt e llms-full.txt.

O que pedimos aos agentes

Só registe um pedido se a pessoa souber e concordar, e com o email dela.
Campo que não saiba fica em branco; nada de adivinhar.
A resposta segue para esse email no prazo de dois dias úteis.

Onde ler mais

Os números deste site podem ser reproduzidos com ligação à página e com a data da revisão.