Documentação do software de gestão, planeamento e otimização das intervenções

Ligar o Cadulis a serviços externos


Ligue o seu Cadulis ao seu ambiente de negócio

O Cadulis integra-se facilmente com as suas ferramentas externas através de conectores dedicados ou de webservices configuráveis.

Pode assim automatizar fluxos como:

  • A criação de intervenções
  • A atualização de fichas de clientes
  • A recuperação de documentos provenientes da sua contabilidade

Este guia acompanha-o passo a passo na configuração dos principais tipos de acesso externo.


1. Aceder às integrações

A partir do menu lateral esquerdo:

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

2. Escolher o tipo de acesso externo

Eis os principais tipos propostos e as suas especificidades:

🔁 Webservice REST

Ligação bidireccional entre o Cadulis e uma ferramenta de terceiros (CRM, portal de cliente, ERP…).

Campos a preencher:

  • 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 (fusão, sobrescrita…)

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

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


📋 Webhooks Kizeo Forms

Ligaçã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

🔗 Receção de dados a partir do HubSpot

Ligação direta à sua conta HubSpot para receber contactos ou clientes.

Etapas:

  1. Criar o acesso (nome, BU, descrição)
  2. Guardar
  3. Modificar > Ligar o HubSpot via redireccionamento seguro
  4. Acompanhamento através dos registos de troca

📘 Receção de dados a partir do Notion

Automatize a criação de atividades Cadulis a partir de elementos Notion (tickets, tarefas…).

  • Criar o acesso (nome, BU)
  • Ligação segura ao Notion
  • Acesso aos registos técnicos

📄 Receção de documentos de faturação a partir do EBP

Ligação com EBP - Gestão comercial.

⚠️ Requer ativação da API Rest EBP (através do suporte deles).

  • Insira o Client ID e o Client Secret no Cadulis
  • Os documentos contabilísticos são recebidos automaticamente
  • Acompanhamento através dos registos de trocas e erros

💼 Ligação com Pennylane (via desencadeador)

Transforme automaticamente as 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:
    • Definições > Catálogo
    • Selecionar o tipo de atividade > Ativar os dados de faturação
  2. Criar um desencadeador em Definições > Desencadeadores
  3. Selecionar Faturar com Pennylane
  4. Ligar a sua conta Pennylane via redireccionamento seguro
  5. Configurar as condições e dados a transmitir

Uma ficha de cliente é criada automaticamente no Pennylane caso não exista.


📬 Caixa de correio externa

Permite ao Cadulis ler automaticamente uma caixa de correio e extrair informações para criar ou modificar atividades.

  • Importação automática a cada 15 minutos
  • POP3 / IMAP, SSL, portas, identificadores
  • Mapeamento por etiquetas personalizadas:
    • {campo} para extracções de linha única
    • {{campo}} para extracções multi-linha
  • Possibilidade de extracção dos anexos

3. Boas práticas

Para integrações fiáveis e seguras

  • Utilize ambientes de teste
  • Nunca conceda mais direitos do que o necessário
  • Documente cada acesso (nomeação, utilização, descrição)
  • Crie um acesso distinto por utilização ou ferramenta ligada
  • Consulte os registos logo nos primeiros intercâmbios

Para ir mais longe

Consulte os guias específicos para cada conector: