Recursos
Suporte
Como reportar bugs, abrir issues e solicitar novos recursos.
Encontrou um bug?
- Confirme se não é um erro de uso lendo a referência do endpoint e Erros e retry
- Tente reproduzir com
curldireto, sem sua aplicação - Reporte com as informações abaixo
Informações úteis no report
- Endpoint chamado (método + path)
- Timestamp da requisição em ISO 8601 com timezone
- Resposta completa do servidor (corpo + headers relevantes)
- Prefixo da API key (ex:
ofm_live_a1b2c3d4) — nunca a chave inteira - Request ID se exposto em header
X-Request-Id - Comportamento esperado vs comportamento observado
Nunca compartilhe a chave inteira em tickets, prints ou logs públicos. Se vazou acidentalmente, rotacione imediatamente.
Solicitar nova feature ou endpoint
Você precisa de um endpoint que está no roadmap como "Sob avaliação" ou algo que não está listado?
Descreva o caso de uso concreto, não só a feature. Exemplos bons:
- ✅ "Precisamos sincronizar contatos do CRM para nosso ERP a cada 5 minutos. Hoje fazemos polling com
message-searchmas seria mais eficiente um webhook decontact.created." - ✅ "Nossa LLM precisa de até 50 mensagens de contexto por contato, mas
messages_limitmáximo é 20."
Exemplo ruim:
- ❌ "Adiciona suporte a GraphQL" (sem caso de uso)
Canais de contato
- GitHub Issues — para bugs, propostas e discussões públicas
- Email —
infra@oficinamartech.com.brpara questões privadas (segurança, contrato, billing)
Reportar vulnerabilidade de segurança
Não abra issue pública para vulnerabilidades. Envie por email para infra@oficinamartech.com.br com:
- Descrição da vulnerabilidade
- Passos para reproduzir
- Impacto estimado
- Sua proposta de fix (opcional)
Respondemos em até 48 horas. Vulnerabilidades válidas seguem coordenação de disclosure responsável.
SLA
- Beta (atual): não há SLA formal. Respondemos em até 5 dias úteis para bugs e propostas
- GA (futuro): SLA será publicado no contrato