Configurar Integrações De Webhook no Drimify

As integrações de webhook do Drimify permitem que você envie automaticamente dados dos participantes para serviços externos sempre que um utilizador completa ou interage com a sua aplicação. Pode conectar a uma Custom API, HubSpot ou Salesforce — e para cada uma, é possível definir exatamente quais campos de dados serão transmitidos.

Início

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

Selecionar um Tipo de Integração

Uma janela modal aparecerá com o título "Selecione Integração de Webhook". Poderá filtrar por categoria usando o menu suspenso (padrão em Todos). As três integrações disponíveis são:

• Custom API — para qualquer endpoint REST que você controle
• HubSpot — para automação de CRM & Marketing via HubSpot
• Salesforce — para Salesforce CRM

Clique na opção de integração que deseja configurar.

Integração Custom API

Autenticação

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

• Nome da Integração Um rótulo para sua própria referência (padrão para "Integração Custom API"). Pode renomear para algo descritivo.
• Endpoint da API O URL completo do receptor do webhook (exemplo: https://api.example.com/webhook). Este deve ser um endpoint HTTPS.
• Tipo de Chave API Escolha o método de autenticação que seu endpoint utiliza. As opções são:

• Quando Cabeçalho Personalizado é selecionado, um campo adicional Nome de Cabeçalho Personalizado aparece onde deve inserir o nome da chave do cabeçalho.
• Chave 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 acessar seu endpoint com as credenciais fornecidas antes de salvar.

Integração HubSpot

Após selecionar HubSpot, o painel mostra:

• Nome da Integração Padrão para "Integração HubSpot".
• Chave API / Token de Acesso Cole o seu Token de Acesso de Aplicação Privada do HubSpot aqui. O HubSpot descontinuou as chaves de API legadas em 2022, portanto, deve usar um token de Aplicação Privada gerado a partir de 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 Padrão para "Integração Salesforce".
• Domínio do Salesforce O URL da sua instância Salesforce (exemplo: yourcompany.my.salesforce.com).
• Chave do Consumidor e Segredo do Consumidor Estes são obtidos a partir de uma Aplicação Conectada configurada no Salesforce em Configuração → Gerenciador de Aplicativos → Nova Aplicação Conectada. O Drimify utiliza o fluxo de credenciais do cliente OAuth 2.0.
• Nome do Campo de ID Externo O nome 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 do ID Externo Um menu suspenso para selecionar qual campo de dados do Drimify usar como chave de correspondência (exemplo: Email).
• Verificar Conexão Testa a conexão OAuth do Salesforce antes de salvar.

⚠️ Campos Obrigatórios para Salesforce

A Salesforce obriga a definição de campos obrigatórios ao nível dos objetos. Se estiver a inserir ou atualizar Leads, a Salesforce exige pelo menos:

• Apelido (lastName) — obrigatório para a criação de Lead

Se estiver a inserir ou atualizar Contactos, a Salesforce exige:

• Apelido (lastName) — obrigatório para a criação de Contacto

O Email não é obrigatório por padrão no esquema da Salesforce, mas é quase sempre necessário como External ID para corresponder e desduplicar corretamente os registos ao inserir ou atualizar. Sem uma correspondência fiável do ID externo, a Salesforce irá criar registos duplicados ou retornar um erro.

Melhor prática: Deve sempre mapear, pelo menos, Apelido e Email ao ligar à Salesforce. Omitir Apelido causará um erro webhoook e o registo não será criado nem atualizado.

Mapeamento de Campos

Disponível em todos os três tipos de integração, o Mapeamento de Campos permite especificar exatamente quais dados de campos do Drimify são enviados para a sua integração, e sob quais nomes de chave.

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

• Campo Webhook (esquerda) — o nome da chave que aparecerá no payload de saída (você define isto, correspondendo aos nomes de campos esperados pela sua integração)
• → Campo de Origem (menu suspenso à direita) — o campo de dados do Drimify a mapear para ele

Campos de Origem Disponíveis no Drimify

Pode adicionar quantas linhas for necessário. Para remover um mapeamento, clique no ícone da lixeira no lado direito da linha.

Disponível em Espaços de Trabalho

No fundo de cada formulário de integração, há uma secção Available in Workspaces. Utilize o controlo ao lado de cada espaço de trabalho para controlar quais os espaços que podem usar essa integração. Clique em Selecionar Todos para ativar para todos os espaços de trabalho de uma só vez.

Guardar e Gerir Integrações

Assim que todos os campos estiverem preenchidos, clique em Salvar Alterações para criar a integração. Esta 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 que não foram guardadas.

Actualizado em: 10/03/2026