Integrações
A CapScore dentro do seu CRM e dos seus sistemas
Crie consultas pela API REST e receba o aviso de relatório pronto por webhook assinado. O background check passa a acontecer no sistema que o seu time já usa.
Como conectar
Três caminhos, a mesma conta
Todos respeitam as regras da sua conta: finalidade declarada, créditos e trilha de auditoria.
Webhooks
Cadastre uma URL https e escolha os eventos. A cada consulta concluída, bloqueada ou em revisão, a CapScore faz um POST assinado no seu sistema.
API REST
Crie consultas, acompanhe o status, leia o relatório em JSON e baixe o PDF. Referência em OpenAPI, pronta para importar na sua ferramenta.
Assistentes de IA (MCP)
Use a CapScore de dentro do Claude, do ChatGPT ou do Cursor, por linguagem natural. Os detalhes estão na página de IA e MCP.
Eventos
O seu sistema é avisado na hora
Nada de ficar perguntando se a consulta terminou. Escolha os eventos que interessam e receba cada um no endpoint que você cadastrou.
| Evento | Quando |
|---|---|
| query.completed | Consulta concluída (relatório pronto) |
| query.failed | Consulta falhou |
| query.blocked | Consulta bloqueada |
| query.manual_review | Consulta em revisão manual |
| monitoring.alert | Acompanhamento detectou mudança |
| source_call.completed | Chamada de API de fonte concluída |
| source_call.failed | Chamada de API de fonte falhou (valor devolvido) |
{
"id": "dl_77a0…",
"type": "query.completed",
"created_at": "2026-09-10T12:00:09.000Z",
"data": {
"query": {
"id": "q_8f2c…",
"status": "completed",
"external_ref": "crm:negocio-1042",
"subject": {
"document_type": "cpf",
"document_masked": "250.***.***-65"
}
},
"report": {
"id": "r_1a9e…",
"risk": "critical",
"flags_count": 3,
"critical_flags": 1,
"links": {
"self": "…/api/v1/reports/r_1a9e…",
"pdf": "…/api/v1/reports/r_1a9e…/pdf"
}
}
}
}external_ref é a referência do seu sistema, enviada na criação da consulta. É ela que liga o evento ao registro certo no CRM.
Onde se encaixa
CRMs e outras plataformas
Webhook e API são padrões abertos: funcionam com qualquer sistema que envie ou receba uma requisição HTTPS, sem depender de conector específico.
CRM e funil comercial
O negócio avança de etapa, o seu sistema cria a consulta do CNPJ e o resultado volta para o mesmo registro, com o nível de risco e o link do relatório.
ATS e sistemas de RH
O candidato chega à fase de verificação, a consulta é criada com a finalidade da vaga e o parecer aparece na ficha antes da admissão.
ERP, compras e jurídico
Homologação de fornecedor e análise de contrato recebem o relatório sem ninguém copiar e colar entre telas.
Automação sem código
Plataformas que recebem webhooks HTTPS podem disparar e-mail, mensagem no chat do time ou uma linha na planilha a cada evento.
Feito para produção
Entrega confiável e verificável
- Cada evento sai assinado com HMAC-SHA256 e carimbo de tempo: o seu sistema confirma que veio da CapScore e rejeita repetição antiga.
- Sem resposta 2xx em 10 segundos, a entrega é repetida em 1 min, 5 min, 15 min, 1 h, 6 h e 24 h.
- Histórico das últimas entregas no painel, com código de resposta e erro, e reenvio manual de qualquer uma.
- Só URLs https públicas são aceitas; endereços internos e privados são recusados no cadastro e a cada envio.
- Idempotency-Key na criação da consulta: reenviar a mesma requisição não cria duas consultas nem cobra dois créditos.
Exemplo
Fornecedor novo no CRM
O comprador move o fornecedor para a etapa de homologação. O CRM chama a API com o CNPJ e o número do negócio como referência. Em minutos chega o evento de consulta concluída, o registro ganha o nível de risco e o link do relatório, e o jurídico só é acionado quando há sinalização crítica.
Como começar
Crie uma chave de teste
Em Chaves de API, gere a chave do sandbox. Ela usa documentos de demonstração e não consome créditos.
Cadastre o webhook
Informe a URL https, escolha os eventos e use o botão de teste para ver o primeiro envio chegar.
Vire para produção
Troque pela chave de produção. As consultas passam a valer e os eventos seguem no mesmo endpoint.
Também
O que mais a integração oferece
Sandbox
Ambiente de teste com consultas de demonstração, para validar o fluxo inteiro antes de ir para produção.
Chaves com escopo
Cada chave define o que pode fazer (ler consultas, criar, ler relatórios) e pode ser revogada a qualquer momento.
Referência própria
Grave o identificador do seu sistema em cada consulta e busque por ele depois, sem manter tabela de correspondência.
Acompanhamento contínuo
O evento de acompanhamento avisa quando uma reconsulta encontra processo novo ou sinalização crítica.
Trilha de auditoria
Consultas criadas por integração ficam no mesmo histórico, com a finalidade declarada e quem as originou.
Segredo protegido
O segredo do webhook aparece uma única vez, fica cifrado e pode ser trocado sem recriar o endpoint.
Quer usar a CapScore por linguagem natural?
Veja como conectar assistentes de IA pelo MCP e como funciona a análise do relatório.
Perguntas frequentes
A CapScore tem conector pronto para o meu CRM?
Não há conector nativo. A integração é feita por webhooks e pela API REST, que funcionam com qualquer sistema capaz de receber ou enviar uma requisição HTTPS: CRMs, ATS, ERPs, plataformas de automação e sistemas próprios.
Preciso de desenvolvedor para integrar?
Depende do destino. Plataformas de automação que recebem webhooks permitem montar o fluxo sem código. Para criar consultas a partir do seu sistema ou validar a assinatura dos eventos, é preciso alguém técnico; a referência OpenAPI e os exemplos ficam na página Desenvolvedor, dentro da conta.
Dá para testar sem gastar créditos?
Sim. As chaves de teste usam um sandbox com documentos de demonstração: a consulta percorre o fluxo inteiro, dispara os webhooks e não consome crédito.
O que acontece se o meu sistema estiver fora do ar?
A entrega é repetida em 1 min, 5 min, 15 min, 1 h, 6 h e 24 h. Você vê as últimas entregas no painel, com o código de resposta, e pode reenviar qualquer uma. Depois de dez falhas seguidas o endpoint é desativado e você é avisado por e-mail.
O webhook traz os dados do relatório?
Traz o resumo: status da consulta, nível de risco, quantidade de sinalizações e os links do relatório e do PDF na API. O conteúdo completo é lido pela API, com a sua chave, e o documento do consultado vai mascarado no evento.
Fale com a gente
Vamos desenhar a sua integração
Conte qual sistema você usa e o volume esperado. Nossa equipe mostra o caminho mais curto para conectar, sem compromisso.