Configuração das Integrações De Webhook no Drimify

As integrações de webhook do Drimify permitem enviar automaticamente dados de participantes para serviços externos sempre que um utilizador completa ou interage com a sua aplicação. Pode conectar-se a uma Custom API, HubSpot, ou Salesforce — e, em cada uma, pode definir exatamente quais os campos de dados que são transmitidos.

Começar

Navegue para Configurações → Integrações. Se ainda não houver integrações configuradas, verá a tela de placeholder "Ainda não há integrações de webhook". Clique em + Adicionar Nova Integração (disponível tanto no canto superior direito quanto no centro da página) para abrir o seletor de integração.

Selecionar um Tipo de Integração

Um modal aparecerá com o título "Selecionar Integração Webhook". Pode filtrar por categoria usando o dropdown (por defeito em Todas). As três integrações disponíveis são:

• Custom API — para qualquer endpoint REST de API que controle
• HubSpot — para automação de CRM e marketing via HubSpot
• Salesforce — para CRM do Salesforce

Clique na tile do tipo de integração que deseja configurar.

Integração Custom API

Autenticação

Após selecionar Custom API, o painel Adicionar Integração abre com os seguintes campos:

Nome da Integração Um rótulo para sua própria referência (por defeito "Integração Custom API"). Pode renomeá-lo para algo descritivo.

Endpoint da API A URL completa do seu receptor de webhook (por exemplo, https://api.example.com/webhook). Deve ser um endpoint HTTPS.

Tipo de Chave de API Escolha o método de autenticação que o seu endpoint utiliza. As opções são:

Quando Cabeçalho Personalizado é selecionado, um campo adicional Nome do Cabeçalho Personalizado aparece onde pode inserir o nome da chave do cabeçalho.

Chave de API O valor secreto enviado com o método de autenticação escolhido.

Verificar Conexão Clique neste botão para testar se o Drimify consegue alcançar o seu endpoint com as credenciais fornecidas antes de salvar.

Integração HubSpot

Após selecionar HubSpot, o painel mostra:

Nome da Integração Por defeito "Integração HubSpot".

Chave de API / Token de Acesso Cole aqui o seu Token de Acesso Privado de Aplicação HubSpot. O HubSpot descontinuou as chaves de API legadas em 2022, portanto, deve usar um token de aplicação privada gerado a partir da sua conta HubSpot em Configurações → Integrações → Aplicações Privadas.

Verificar Conexão Testa o token contra a API do HubSpot antes de salvar.

Integração Salesforce

Após selecionar Salesforce, o painel mostra:

Nome da Integração Por defeito "Integração Salesforce".

Domínio Salesforce A URL da sua instância Salesforce (por exemplo, suaempresa.my.salesforce.com).

Consumer Key e Consumer Secret Estes são obtidos de uma Aplicação Conectada configurada no Salesforce em Setup → Gerenciador de Aplicativos → Nova Aplicação Conectada. O Drimify usa o fluxo de credenciais OAuth 2.0 do cliente.

Nome do Campo de ID Externo O nome da API do campo usado para corresponder (upsert) registros — tipicamente Email_External_Id__c ou um campo de ID externo personalizado no objeto Contato ou Lead. Este campo deve ser marcado como ID Externo no Salesforce.

Fonte de ID Externo Um dropdown para selecionar qual campo de dados do Drimify usar como chave de correspondência (por exemplo, Email).

Verificar Conexão Testa a conexão OAuth do Salesforce antes de salvar.### ⚠️ Campos Obrigatórios para Salesforce

Salesforce exige campos obrigatórios ao nível do objeto. Se estiver a inserir ou atualizar Leads, o Salesforce requer no mínimo:

• Apelido (lastName) — necessário para a criação de Lead.

Se estiver a inserir ou atualizar Contacts, o Salesforce requer:

• Apelido (lastName) — necessário para a criação de Contactos.

O Email não é obrigatório no esquema do Salesforce por defeito, mas é quase sempre necessário como o ID Externo para corresponder e eliminar duplicados corretamente em operações de inserção ou atualização. Sem uma correspondência confiável de ID externo, o Salesforce poderá criar registros duplicados ou devolver um erro.

Melhor prática: Mapear sempre no mínimo Apelido e Email ao conectar ao Salesforce. Omissão do Apelido fará com que o webhook devolva um erro e o registro não será criado ou atualizado.

Mapeamento de Campos

Disponível nos três tipos de integração, o Mapeamento de Campos permite-lhe especificar exatamente quais os campos de dados Drimify são enviados para a sua integração e sob quais nomes de chaves.

Clique em + Adicionar Campo para adicionar uma linha de mapeamento. Cada linha consiste em:

• Campo Webhook (à esquerda) — o nome da chave que aparecerá no payload de saída (você define isso, correspondendo aos nomes de campo esperados pela sua integração)
• → Campo Fonte (drop-down à direita) — o campo de dados Drimify para mapear para ele

Campos Fonte Drimify Disponíveis

Pode adicionar quantas linhas forem necessárias. Para remover um mapeamento, clique no ícone do caixote do lixo no lado direito da linha.

Disponível nos Espaços de Trabalho

Na parte inferior de cada formulário de integração há uma secção Disponível nos Espaços de Trabalho. Utilize a alternância junto a cada espaço de trabalho para controlar quais espaços de trabalho podem usar esta integração. Clique em Selecionar Todos para ativar para todos os espaços de trabalho de uma só vez.

Salvar e Gerir Integrações

Após todos os campos serem preenchidos, clique em Guardar Alterações para criar a integração. Aparecerá então na lista principal de Integrações. Pode editar ou excluir integrações existentes dessa lista a qualquer momento.

Clique em Cancelar para descartar quaisquer alterações não guardadas.

Actualizado em: 06/03/2026