Changelog
Mudanças na API Externa (/external/v1) e nos webhooks, da mais recente para a mais antiga. A versão no caminho continua v1: as mudanças abaixo foram feitas sem trocar de versão.
18 de novembro de 2026
Adicionado
- Renovação por
refreshToken.POST /external/v1/authpassa a devolverrefreshTokenerefreshExpiresIn. A rota novaPOST /external/v1/auth/refresh-tokendevolveaccessToken,companyTokenerefreshTokennovos. Veja Autenticação.
Alterado
- Limite de uso: 100 requisições por minuto por empresa, somando todas as rotas e valendo também sob chamadas simultâneas. Ao passar,
429com o tempo de espera em segundos. - Paginação:
pageelimitsão opcionais em todas as listagens (padrãopage=1,limit=25). - Respostas nunca trazem credenciais ou segredos (chaves, senhas, certificados, tokens de integração, respostas brutas de gateways).
Removido
POST /external/v1/auth/refresh-company(responde404). Userefresh-token.- Eventos de webhook
charge.status_changedeprotocol.status_changed, que nunca eram enviados. Inscrições que os tinham continuam recebendo os demais eventos.
6 de novembro de 2026
Alterado
- Confirmação em duas etapas nas ações sensíveis. Gerar ou revogar a API Key, criar uma inscrição de webhook, trocar a URL de destino de uma inscrição ou acrescentar eventos a ela passam a pedir o código da verificação em duas etapas a quem a usa. As chamadas da API Externa não mudam.
23 de outubro de 2026
Alterado
- Só a sessão da API Key. As rotas
/external/v1passam a aceitar apenas a sessão criada porPOST /external/v1/auth. O token de login de uma pessoa é recusado com403. - Plano e perfil conferidos em toda rota. Cada rota confere se a empresa tem o recurso correspondente no plano e se o perfil de acesso da conta de serviço permite a ação (
GET= leitura,POST= criação,PUT= edição). Sem o recurso ou sem a permissão, a resposta é403. - Assinatura suspensa deixa a integração só com leitura. Com a assinatura da empresa suspensa, criações e atualizações respondem
402comcode=SUBSCRIPTION_SUSPENDED; as consultas continuam funcionando. - Webhooks: destinos internos recusados. A URL de destino de um webhook que aponte para endereço interno ou de rede privada é recusada no envio; a entrega fica como falhou, sem nova tentativa.
Corrigido
- As listagens de
person-emails,person-phones,deal-items,quote-items,contract-items,purchase-order-items,project-waves,project-epics,project-tasks,project-team-memberseaccounting-journal-entry-linesrespondiam com erro. Agora funcionam e trazem só os registros cujo registro-pai (pessoa, negócio, proposta, contrato, pedido, projeto ou lançamento contábil) é da sua empresa. - A busca por ID desses mesmos recursos passa a responder
{}para registro de outra empresa. - Registros relacionados de outra empresa trazidos com
includeemrelationspassam a ser removidos da resposta.
28 de setembro de 2026
Adicionado
POST /external/v1/integrations/{provider}/connecteDELETE /external/v1/integrations/{provider}/connect: aperto de mão de plataformas parceiras homologadas, com a URL do parceiro e o segredo das chamadas de volta.POST /external/v1/hiring-requests: recebe um item contratado numa plataforma parceira e cria ou reaproveita o cliente, o signatário, o contrato (em rascunho) e o item, sem cobrar nem ativar nada. AceitarequestedBy(quem enviou o pedido) e, para ligar o pedido a cadastros que já existem,contract.idecontractItem.id. Veja Plataformas parceiras.
23 de abril de 2026
Alterado
companyTokenpassa a ser o identificador da sessão da empresa (um UUID), e não mais um JWT. Continue enviando o valor recebido, sem alterar, no cabeçalhox-company-token.- O Secret passa a ter 27 caracteres nas chaves geradas a partir desta data (antes eram 43).
Corrigido
- As listagens passam a trazer só os registros da empresa dona da chave, e a busca por ID responde
{}para registro de outra empresa.
22 de abril de 2026
Alterado
- Webhooks:
financial_entry.createdpassa a ser enviado também para os lançamentos criados na conciliação bancária. - Webhooks:
charge.createdpassa a ser enviado também quando uma cobrança agendada é gerada.
20 de abril de 2026
Alterado
- Webhooks:
deal.status_changedpassa a ser enviado também quando o negócio é marcado como ganho ou perdido pelas ações próprias da tela.
9 de abril de 2026
Removido
- As rotas
POST /external-api/config/generate-key,POST /external-api/config/revoke-keyeGET /external-api/config/key-status. A API Key passa a ser gerada, consultada e revogada só pela tela API Externa do Tesselys.
28 de março de 2026
Corrigido
- Webhooks: as novas tentativas de entrega passam a ser agendadas de fato (1 minuto, 5 minutos, 30 minutos e 2 horas). Antes, a entrega ficava marcada para nova tentativa sem que ela acontecesse.
26 de março de 2026
Adicionado
- 36 recursos novos, além dos 5 da primeira versão:
- CRM e vendas:
leads,activities,deal-items,deal-pipelines,quotes,quote-items,person-emails,person-phones; - contratos:
signs,contracts,contract-items; - projetos:
project-waves,project-epics,project-tasks,project-team-members; - financeiro:
financial-categories,bank-accounts,measurements,invoices,charges,provisioning; - compras:
purchase-orders,purchase-order-items; - RH e timesheet:
employee-profiles,timesheet-entries,timesheet-periods; - help desk:
tickets,ticket-comments,sla-policies; - contabilidade:
accounting-accounts,accounting-journal-entries,accounting-journal-entry-lines,accounting-reports; - consulta:
cost-centers,business-units,custom-fields.
- CRM e vendas:
GET /external/v1/health: verificação de disponibilidade, pública.
18 de março de 2026
Adicionado
- Webhooks: eventos do inbox de atendimento:
inbox_conversation.created,inbox_conversation.resolved,inbox_conversation.assigned,inbox_message.receivedeinbox_message.sent.
13 de março de 2026
Adicionado
- Webhooks: eventos
protocol.processing.completed,protocol.processing.failed,protocol.linked,protocol.unlinked,contract.created,contract.updated,contract.status_changed,contract.renewed,contract.canceled,contract.suspended,timesheet.submitted,timesheet.approved,timesheet.rejectedetimesheet.closed.
Alterado
- Webhooks: o cadastro de uma inscrição passa a recusar eventos que não existem (os curingas de categoria, como
deal.*, continuam aceitos).
10 de março de 2026
Adicionado
- Primeira versão da API Externa: autenticação por API Key e Secret (
POST /external/v1/auth) e os recursospersons,deals,financial-entries,productseprojects, com listagem paginada, busca por ID e criação (e atualização, onde disponível).
4 de março de 2026
Adicionado
- Webhooks: inscrições de webhook com assinatura HMAC-SHA256 (
X-Webhook-Signature), cabeçalhos personalizados, curingas por categoria (por exemplo,deal.*), histórico de entregas, reenvio manual, novas tentativas e desativação automática após 50 falhas seguidas. Eventos:deal.*,financial_entry.*,person.*,purchase_order.*,project.*,project_task.*,appointment.*,protocol.created,protocol.status_changed,charge.*eapproval_request.*.
Ainda com dúvida?
A nossa equipe ajuda você a configurar e usar esse recurso.