Roadmap
O que está disponível, o que está em desenvolvimento ativo e o que está sob avaliação.
Este roadmap é honesto sobre o que existe, o que está sendo construído e o que ainda é aspiração. Datas só aparecem quando há ticket priorizado.
Disponível
Endpoint em Beta
| Endpoint | Versão | Status |
|---|---|---|
GET /contacts/message-search | 0.1 | Beta |
Beta significa: API funcional, contrato pode mudar (mas avisaremos com no mínimo 30 dias de antecedência), elegível para uso em produção com expectativa de evolução.
Sob avaliação
Endpoints abaixo estão na lista mas ainda não foram priorizados. Sem previsão de lançamento.
| Endpoint | Escopo proposto |
|---|---|
GET /contacts | contacts:read |
GET /contacts/{id} | contacts:read |
GET /contacts/{id}/messages | messages:read |
GET /messages/search | messages:read |
GET /conversations | messages:read |
GET /conversations/{id} | messages:read |
POST /webhooks | webhooks:manage |
GET /webhooks | webhooks:manage |
Se algum desses endpoints é crítico para o seu projeto, abra uma issue descrevendo o caso de uso. Priorizamos pelo que tem demanda real.
Em consideração
Conceitos maiores ainda em discussão. Sem garantia de implementação.
- Test mode — chaves com prefixo
ofm_test_em ambiente isolado para CI/CD - Rate limits documentados — limites explícitos por chave/escopo (hoje há limites internos não-publicados)
- Webhooks de entrada — notificar sua aplicação quando eventos ocorrem (nova mensagem, novo contato)
- Bulk operations — operações em lote para sincronização inicial massiva
- GraphQL — alternativa ao REST para clientes que preferem (sem decisão tomada)
Política de versionamento
- v0.x — Beta. Mudanças de contrato com 30+ dias de aviso via changelog e header
Sunset - v1.x — GA. Mudanças quebradoras só em major bump (
v2.0), com 6 meses de coexistência
Não está na lista
Coisas que não pretendemos implementar:
- Modo "admin sem chave" — toda integração externa precisa de Bearer API key
- WebSocket público — webhooks resolvem o caso de uso de tempo real
- SDK oficial em todas as linguagens — focamos em REST bem documentado; SDKs surgirão pela comunidade
Sobre datas
Você não verá "previsto para Q3" neste roadmap. Datas sem commit de produto envelhecem mal e quebram confiança. Quando algo for prometido com data, será aqui com link para o ticket público.