gensAPI

Changelog

Histórico do contrato e da documentação pública. A disponibilidade de uma mudança depende da versão publicada do serviço, não apenas da atualização desta página.

Próxima publicação — correções financeiras e etiquetas individuais#

Consulta, edição e cancelamento em /v1/contacts/{contact_id}/sales/{sale_id}, com versão da venda, justificativa, idempotência e snapshots auditáveis.
Autoria confiável pela credencial da API e rótulo opcional por venda; autoria desconhecida não é inventada para vendas antigas.
Vínculo opcional com uma atribuição de anúncio do próprio contato, sem escolher um anúncio automaticamente.
Correções ajustam o LTV pelo delta; cancelamentos retiram a venda do faturamento ativo e preservam consulta individual do snapshot.
Correções não criam nova compra na Meta; eventos em envio bloqueiam a operação e eventos já enviados permanecem intactos.
Inclusão/remoção de uma tag sem substituir as demais; novas ferramentas MCP específicas para vendas, etiquetas e histórico de anúncios.
Implementação local; depende de migration e deploy antes de uso em produção.

2026-10-06 — Histórico de anúncios publicado#

Nova consulta GET /v1/contacts/{contact_id}/ad-attributions, com scope contacts:read e paginação por cursor.
Entradas do mais antigo ao mais recente, com data de criação do contato, data da entrada e data do registro.
Retornos pelo mesmo anúncio permanecem como eventos separados; metadados Meta dependem de correspondência validada.
O campo ad_attribution existente continua representando a atribuição mais recente.
Ferramenta MCP correspondente: gens_listContactAdAttributions.
Migration aplicada e funções REST/MCP publicadas no projeto de produção.

2026-09-25 — CRUD de retornos#

PATCH /v1/returns/{return_id} atualiza data, motivo, anotação, executor, modo e responsável.
DELETE /v1/returns/{return_id} cancela e preserva a tarefa para auditoria.
Reagendar e cancelar pelos caminhos antigos continuam válidos.
A edição não muda o contato nem o estado da tarefa.

Próxima atualização — segurança e clareza#

Documentação alinhada aos nomes reais dos campos, aos envelopes de resposta e às limitações de retornos.
Busca por telefone com conferência exata e paginação antes de usar o UUID.
Orientação de retry que preserva a operação original e evita duplicação de vendas.
Escritas MCP passam a exigir idempotency_key explícita; clientes que dependiam da geração automática precisam se adaptar antes da ativação.
Autenticação completa também na descoberta MCP, limites de corpo durante a leitura e respostas de retornos com campos explícitos.
Navegação mais clara, incluindo Retornos, e instruções para agentes.

2026-08-30 — Atribuição de anúncios nos contatos#

Contatos e /v1/ads/contacts passam a informar a evidência de anúncio mais recente em ad_attribution.
Referências capturadas continuam separadas dos IDs de provedor; IDs e nomes só aparecem após correspondência validada.
O contrato não expõe payload bruto, IDs de mensagem, identificadores de clique, tokens ou erros internos.

2026-08-29 — Chaves e domínio próprio#

Documentação utiliza https://api.crm.agenciagens.com.br/v1.
Geração de chaves com presets de validade e indicação de alto risco nos scopes sensíveis.

2026-08-26 — Vendas do contato#

Consulta e registro em /v1/contacts/{contact_id}/sales.
Valor, serviço e data de venda integram o histórico comercial.
Alterar lifetime_value não equivale a registrar compra.

2026-08-24 — Retornos#

Agenda, criação, reagendamento e cancelamento de retornos.
Fluxo de tarefa para IA externa com permissões separadas e aprovação humana em modo rascunho.
Contexto restrito da tarefa; veja regras e limitações.

2026-08-19 — Guia público#

Guia estático com menu por recurso, início rápido, referência das rotas e exemplos de terminal.

2026-08-12 — Contrato inicial V1#

Contas, assinatura somente leitura, usuários, contatos, Kanban, follow-ups, anúncios, links, tags, serviços e agendamentos. Autenticação por chave de clínica, scopes, limites de uso e idempotência.

Versionamento#

Mudanças incompatíveis no contrato entram em uma nova versão de URL (/v2, /v3...). A V1 permanece disponível por pelo menos 12 meses após /v2 sair. Novas rotas, campos anuláveis de resposta e parâmetros opcionais podem ser adicionados à V1. Comportamentos não documentados são tratados como bugs.

O endurecimento do MCP anunciado acima ainda requer uma decisão de publicação e transição dos clientes; não altera silenciosamente esta política.

Os consumidores devem tolerar novos campos de resposta e códigos de erro documentados. Envie somente os campos de entrada aceitos pela operação. Mudanças de comportamento de segurança e requisitos de integração são destacadas aqui para permitir adaptação dos clientes.