Configurar Integrações de Webhook no Drimify

As integrações de webhook da Drimify permitem-lhe 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 para cada uma, pode definir exatamente quais os campos de dados que serão transmitidos.

Introdução

Navegue para Minha Conta → Integrações. Se ainda não tiver configurações feitas, 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ção.

Selecionar um Tipo de Integração

Abrirá um modal intitulado "Selecionar Integração de Webhook". Pode filtrar por categoria usando o dropdown (definido por padrão em Todos). As três integrações disponíveis são:

• Custom API — para qualquer endpoint REST da API que controla
• HubSpot — para automação de CRM e Marketing via HubSpot
• Salesforce — para CRM da Salesforce

Clique no bloco 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 (padrão é "Custom API Integration"). Pode renomeá-lo para algo descritivo.
• Endpoint da API: O URL completo do seu receptor de webhook (por exemplo, https://api.example.com/webhook). Deve ser um endpoint HTTPS.
• **Método HTTP : **

Selecione o método HTTP usado para enviar a solicitação de webhook para o seu endpoint. As opções são:

• POST — Recomendado para a maioria dos casos de uso (cria um novo recurso ou envia dados)
• PUT — Substitui um recurso existente completamente
• PATCH — Atualiza parcialmente um recurso existente

Escolha o método que corresponde à forma como a sua API espera receber dados.

• Tipo de Chave 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 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 com sucesso o seu endpoint com as credenciais fornecidas antes de guardar.

Integração HubSpot

Após selecionar HubSpot, o painel exibe:

• Nome da Integração: Padrão é "HubSpot Integration".
• Chave API / Token de Acesso: Cole aqui o seu Token de Acesso de Aplicação Privada do HubSpot. O HubSpot descontinuou as chaves API antigas em 2022, por isso 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 HubSpot antes de guardar.## Salesforce Integração

Após selecionar Salesforce, o painel exibe:

• Nome da Integração Padrão para "Salesforce Integration".
• Domínio Salesforce A URL da sua instância do Salesforce (ex.: suaempresa.my.salesforce.com).
• Chave do Consumidor e Segredo do Consumidor Estes são obtidos de uma Aplicação Conectada configurada no Salesforce em Setup → Gerenciador de Aplicativos → Novo Aplicativo Conectado. A Drimify utiliza o fluxo de credenciais do cliente OAuth 2.0.
• Nome do campo de ID Externo O nome na API do campo usado para fazer a correspondência (upsert) de registros — normalmente 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 menu suspenso para selecionar qual campo de dados Drimify usar como chave de correspondência (ex.: Email).
• Verificar Conexão Testa a conexão OAuth do Salesforce antes de salvar.

⚠️ Campos Obrigatórios para Salesforce

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

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

Se estiver a atualizar ou criar Contatos, o Salesforce requer:

• Último Nome (lastName) — obrigatório para a criação de Contato

Email não é obrigatório pelo esquema do Salesforce por padrão, mas geralmente é necessário como o ID Externo para corresponder corretamente e evitar duplicações de registros ao usar upsert. Sem uma correspondência de ID externo confiável, o Salesforce criará registros duplicados ou retornará um erro.

Melhor prática: Sempre mapear no mínimo Último Nome e Email ao conectar-se ao Salesforce. Omitir Apelido fará com que o webhook retorne um erro e o registro não será criado ou atualizado.

Mapeamento de Campo

Disponível em todos os três tipos de integração, o Mapeamento de Campo permite que você especifique exatamente quais campos de dados Drimify são enviados para sua integração, e sob quais nomes de chave.

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

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

Campos de Origem Drimify Disponíveis

Você pode adicionar quantas linhas precisar. Para remover um mapeamento, clique no ícone de lixeira à direita da linha.

Disponível nos Espaços de Trabalho

Na parte inferior de cada formulário de integração há uma seção Disponível nos Espaços de Trabalho. Use o alternador ao lado de cada espaço de trabalho para controlar quais espaços de trabalho podem usar esta integração. Clique em Selecionar Todos para habilitá-lo para todos os espaços de trabalho de uma vez.## Guardar e Gerir Integrações

Depois de preencher todos os campos, clique em Guardar Alterações para criar a integração. Ela aparecerá então na lista principal de Integrações. Pode editar ou eliminar integrações existentes dessa lista a qualquer momento. Clique em Cancelar para descartar quaisquer alterações não guardadas.

Actualizado em: 22/04/2026