OrçaZap para agentes de IA e desenvolvedores
Como integrar o OrçaZap num agente de IA (ChatGPT, Gemini, Claude, Copilot) ou numa aplicação própria: AgentCard, OpenAPI e tool definition prontos.
Estado (julho de 2026): o OrçaZap hoje é site estático + bot de WhatsApp, sem backend. Os arquivos abaixo (AgentCard, OpenAPI) são o contrato pronto para quando a API estiver ativa. Até lá, a forma de gerar um orçamento é pelo WhatsApp. Não há segredo nem autenticação necessária agora.
O que o OrçaZap faz
Gera um orçamento de serviço a partir de uma descrição em linguagem natural. Exemplo: o input "pintar dois quartos, massa corrida e duas demãos" vira um orçamento com itens, valores e total.
Entrada: texto (ou áudio, no fluxo do WhatsApp) descrevendo o serviço, opcionalmente com a profissão e a região. Saída: orçamento estruturado (itens + total + prazo + condição de pagamento).
Como integrar
1. AgentCard (padrão A2A)
Disponível em
/.well-known/agent.json.
Segue o formato AgentCard do protocolo A2A do Google.
Descreve o OrçaZap como agente/serviço e suas capacidades. Use para
descoberta por outros agentes.
2. OpenAPI (contrato da API)
Disponível em /openapi.yaml.
Descreve o endpoint POST /orcamento (input: descrição +
profissão + região; output: itens, total, prazo). É o que Custom GPTs
(Actions da OpenAI) e geradores de servidor MCP consomem.
3. Tool definition (function calling — copie e cole)
Se você está construindo um agente (ChatGPT, Gemini, Claude) com function calling, use esta definição de ferramenta:
{
"name": "orcazap_gerar_orcamento",
"description": "Gera um orçamento de serviço a partir da descrição. Retorna itens, valores e total. Útil quando o usuário pede 'faça um orçamento de pedreiro/pintor/eletricista'.",
"parameters": {
"type": "object",
"properties": {
"descricao": {
"type": "string",
"description": "Descrição do serviço em linguagem natural."
},
"profissao": {
"type": "string",
"enum": ["pedreiro","eletricista","pintor","gesseiro","encanador","marceneiro","serralheiro","dedetizador","chaveiro","tecnico-refrigeracao","montador","frete-e-mudanca","diarista","jardineiro"]
},
"regiao": { "type": "string", "description": "Cidade/estado (opcional)." }
},
"required": ["descricao"]
}
}4. Fallback (agora): WhatsApp
Enquanto o backend não está ativo, o caminho funcional é direcionar o usuário para o WhatsApp do OrçaZap: wa.me/5521959413223.
Roteiro (quando o backend existir)
- →API REST em
POST /orcamento(Cloudflare Functions/Workers), conforme oopenapi.yaml. - →Servidor MCP remoto (com OAuth 2.1) — qualquer agente (ChatGPT, Claude, Gemini) poderá chamar o OrçaZap nativamente.
- →Webhook de orçamento pronto (notifica o sistema chamador).