Documentação

Conectar Cadulis a serviços externos


Conecte seu Cadulis ao seu ambiente de negócios

O Cadulis se integra facilmente com suas ferramentas externas graças a conectores dedicados ou por meio de webservices configuráveis.

Assim, você pode automatizar fluxos como:

  • Criação de intervenções
  • Atualização de fichas de clientes
  • Recuperação de documentos provenientes da sua contabilidade

Este guia acompanha você passo a passo na configuração dos principais tipos de acessos externos.


1. Acessar as integrações

No menu lateral esquerdo:

  1. Clique em Configurações
  2. Selecione Conectar Cadulis a serviços externos
  3. Clique em Acesso externo
  4. Depois em Criar um acesso externo

2. Escolher o tipo de acesso externo

Aqui estão os principais tipos oferecidos e suas especificidades:

🔁 Webservice REST

Conexão bidirecional entre Cadulis e uma ferramenta de terceiros (CRM, portal do cliente, ERP…).

Campos a serem preenchidos:

  • Nome e descrição
  • Restrições de acesso (tipos de intervenções, visibilidade)
  • Permissões detalhadas: consultar, modificar, criar, encerrar…
  • Regras de tratamento de campos (mesclagem, sobrescrita…)

🎯 Recomendação: ative apenas os direitos estritamente necessários.

A documentação técnica está disponível via swagger aqui: 👉 Swagger API entrante Cadulis


📋 Webhooks Kizeo Forms

Conexão entre os formulários Kizeo Forms e o Cadulis.

  • Nome, descrição
  • Permissões: criar, modificar, encerrar
  • Injeção automática de campos personalizados
  • Transformação JSON editável

🔗 Recepção de dados do HubSpot

Conexão direta com sua conta HubSpot para recuperar contatos ou clientes.

Etapas:

  1. Criar o acesso (nome, BU, descrição)
  2. Salvar
  3. Modificar > Conectar HubSpot via redirecionamento seguro
  4. Acompanhamento via logs de troca

📘 Recepção de dados do Notion

Automatize a criação de atividades Cadulis a partir de itens do Notion (chamados, tarefas…).

  • Criar o acesso (nome, BU)
  • Conexão segura ao Notion
  • Acesso aos logs técnicos

📄 Recepção de documentos de faturamento do EBP

Conexão com EBP - Gestão comercial.

⚠️ Requer ativação da API Rest EBP (via suporte deles).

  • Insira o Client ID e Client Secret no Cadulis
  • Os documentos contábeis são recebidos automaticamente
  • Acompanhamento via logs de trocas e erros

💼 Conexão com Pennylane (via gatilho)

Transforme automaticamente suas intervenções Cadulis em orçamentos ou faturas no Pennylane.

Pré-requisitos:

  • Conta Cadulis + conta Pennylane ativa
  • Numeração definida no Pennylane

Etapas:

  1. Ativar a gestão financeira no Cadulis:
    • Configurações > Catálogo
    • Selecionar o tipo de atividade > Ativar dados de faturamento
  2. Criar um gatilho em Configurações > Gatilhos
  3. Selecionar Faturar com Pennylane
  4. Conectar sua conta Pennylane via redirecionamento seguro
  5. Configurar as condições e dados a serem transmitidos

Uma ficha de cliente é criada automaticamente no Pennylane se ainda não existir.


📬 Caixa de e-mail externa

Permite que o Cadulis leia automaticamente uma caixa de e-mail e extraia informações para criar ou modificar atividades.

  • Importação automática a cada 15 minutos
  • POP3 / IMAP, SSL, portas, identificadores
  • Mapeamento por tags personalizadas:
    • {campo} para extrações de linha única
    • {{campo}} para extrações de múltiplas linhas
  • Extração possível de anexos

3. Boas práticas

Para integrações confiáveis e seguras

  • Utilize ambientes de teste
  • Nunca conceda mais direitos do que o necessário
  • Documente cada acesso (nomeação, uso, descrição)
  • Crie um acesso distinto por uso ou ferramenta conectada
  • Consulte os logs desde as primeiras trocas

Para ir mais longe

Consulte os guias específicos para cada conector: