Configurar Integrações De Webhook no Drimify

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

Primeiros Passos

Vá para My Account → Integrations. Se ainda não tiver nenhuma integração configurada, verá a mensagem de espaço reservado “No integrações de webhook yet”. 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

Uma janela modal com o título “Selecionar Integração Webhook” irá aparecer. Pode filtrar por categoria usando o menu dropdown (o padrão é All). As três integrações disponíveis são:

• Custom API — para qualquer endpoint REST de uma API que controle
• HubSpot — para automação de CRM & Marketing através do HubSpot
• Salesforce — para o CRM Salesforce

Clique no bloco da integração que deseja configurar.

Integração API Personalizada

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 a sua própria referência (padrão: “Custom API Integration”). Pode renomeá-lo para algo mais descritivo.
• Endpoint da API: O URL completo do receptor do seu webhook (por exemplo: https://api.example.com/webhook). Deve ser um endpoint HTTPS.
• Método HTTP:

Selecione o método HTTP utilizado para enviar o pedido de webhook para o seu endpoint. Opções disponíveis:

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

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

• Tipo de Chave da API: Escolha o método de autenticação utilizado pelo seu endpoint.

• Quando Cabeçalho Personalizado é selecionado, aparece um campo adicional Nome do Cabeçalho Personalizado onde pode introduzir o nome da chave do cabeçalho.
• Chave da API: O valor secreto enviado usando o método de autenticação selecionado.
• Verificar Conexão: Clique neste botão para testar se o Drimify consegue alcançar com sucesso o seu endpoint utilizando as credenciais fornecidas antes de salvar.

Integração HubSpot

Após selecionar HubSpot, o painel exibe:

• Nome da Integração: Padrão: “HubSpot Integration”.
• API Key / Token de Acesso: Cole aqui o seu Token de Acesso de Aplicação Privada do HubSpot. O HubSpot descontinuou as chaves de API legadas em 2022, por isso deve usar um token de aplicação privada gerado na sua conta do HubSpot em: Settings → Integrations → Private Apps
• Verificar Conexão: Testa o token contra a API do HubSpot antes de salvar.# Integração Salesforce

Depois de selecionar Salesforce, o painel exibe:

• Nome da Integração: Padrão: “Integração Salesforce”.
• Domínio Salesforce: A URL da sua instância Salesforce (por exemplo: yourcompany.my.salesforce.com).
• Consumer Key e Consumer Secret: Obtidos de uma Aplicação Conectada configurada em Salesforce em: **Setup → Gerenciador de Aplicativos → Nova Aplicação Conectada **. O Drimify usa o fluxo de credenciais do cliente OAuth 2.0.
• Campo de ID Externo Nome: **O nome da API do campo usado para corresponder (upsert) registros — geralmente algo como Email_External_Id__c ou um campo de ID externo personalizado no objeto Contato ou Lead. Este campo deve ser marcado como um **ID Externo no Salesforce.
• Fonte de ID Externo: Um menu suspenso que permite selecionar qual campo de dados do Drimify deve ser usado como chave de correspondência (por exemplo: Email).
• Verificar Conexão: Testa a conexão OAuth com o Salesforce antes de salvar.

⚠️ Campos Obrigatórios do Salesforce

O Salesforce exige campos obrigatórios a nível de objeto. Se estiver a fazer upsert de Leads, o Salesforce requer no mínimo:

• lastName — obrigatório para a criação de Leads

Se estiver a fazer upsert de Contatos, o Salesforce requer:

• lastName — obrigatório para a criação de Contatos

Embora o Email não seja obrigatório pelo esquema padrão do Salesforce, é quase sempre necessário como ID Externo para corresponder e eliminar duplicatas de registros durante os upserts. Sem uma correspondência confiável de ID Externo, o Salesforce pode criar registros duplicados ou retornar um erro.

Melhor Prática

Sempre mapeie pelo menos:

• Apelido
• Email

ao conectar-se ao Salesforce. Omitir o Apelido causará a falha do webhook e o registro não será criado ou atualizado.

Mapeamento de Campos

Disponível para todos os três tipos de integração, o Mapear Campos permite especificar exatamente quais campos de dados 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 em:

• Campo Webhook (esquerda) — o nome da chave que aparecerá na carga útil de saída (definido por você para corresponder aos requisitos da sua integração)
• → Campo Fonte (menu suspenso à direita) — o campo de dados do Drimify a ser mapeado

Campos de Origem Drimify Disponíveis

Pode adicionar quantos mapeamentos forem necessários. Para remover um mapeamento, clique no ícone da lixeira à direita da linha.

Disponível em Espaços de Trabalho

Na parte inferior do formulário de integração, a seção Disponível em Espaços de Trabalho permite usar a opção de alternância ao lado de cada espaço de trabalho para controlar qual pode usar a integração. Clique em Selecionar Tudo para ativar a integração 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. A integração aparecerá então na lista principal de Integrações. Pode editar ou eliminar integrações existentes desta lista a qualquer momento. Clique em Cancelar para descartar as alterações não guardadas.

Integrações de Mailer

As integrações de mailer permitem-lhe enviar e-mails transacionais (por exemplo, confirmações, resultados ou seguimentos) diretamente das suas experiências Drimify usando o seu fornecedor de e-mail preferido.

Adicionar uma Integração de Mailer

1. Aceda a Integrações → Integrações de Mailer
2. Clique em Adicionar Integração de Mailer
3. Selecione o seu fornecedor:

• Amazon SES
• Brevo
• Drimify
• Mailgun
• Mailjet
• Mandrill
• SendGrid
• SMTP Personalizado

Configure a sua Integração de Mailer

Configurações Gerais

Todos os fornecedores partilham as seguintes configurações gerais:

• Nome da Integração – Nome interno para identificar a sua integração
• Nome do Remetente – Nome exibido como remetente do e-mail
• E-mail do Remetente – Endereço de e-mail utilizado para enviar e-mails (não aplicável para Drimify — veja abaixo)
• Email em Cco (opcional) – Adicione um endereço de e-mail para receber uma cópia de todos os e-mails enviados

Autenticação

Cada fornecedor requer credenciais específicas. Veja a secção de configuração específica do fornecedor abaixo para mais detalhes.

Teste a Sua Conexão

Depois de inserir as suas credenciais, clique em Enviar E-mail de Teste para verificar se a integração está a funcionar corretamente. Uma confirmação "E-mail de teste enviado com sucesso" aparecerá se a conexão for válida.

Campos de Parâmetro de Template

Mapeie os campos de dados Drimify para as variáveis de template do seu fornecedor de e-mail. Esta secção está disponível para fornecedores que suportam templates de e-mail dinâmicos: Brevo, Mailgun, Mailjet, Mandrill e SendGrid.

• Nome do Parâmetro – O nome da variável esperada no seu template de e-mail
• Campo – O correspondente dado Drimify (por exemplo, Nome, Email, Pontuação, etc.)

Clique em Adicionar Campo para criar mapeamentos adicionais.

Disponível em Espaços de Trabalho

Selecione quais espaços de trabalho podem usar esta integração de mailer.### Configuração Específica do Provedor

Amazon SES

O que você precisa:

• Um utilizador AWS IAM com permissões de ses:SendEmail
• Chave de Acesso API e Chave Privada API (do AWS IAM)
• Sua região AWS (ex.: eu-west-1, us-east-1)
• Token de Sessão (apenas se usar credenciais temporárias/STS)
• Um email ou domínio remetente verificado no Amazon SES

Etapas:

1. No AWS IAM, crie um utilizador com permissões de envio SES e gere um par de chave de acesso
2. No Drimify, insira sua Chave de Acesso API, Chave Privada API e Região
3. Se usar credenciais temporárias, insira também o Token de Sessão
4. Certifique-se de que seu email ou domínio remetente está verificado no Amazon SES
5. Clique em Enviar Email de Teste para validar a conexão
6. Salve sua integração

Brevo

O que você precisa:

• Uma chave api Brevo

Etapas:

1. Na sua conta Brevo, gere uma chave api em Configurações → Chaves API
2. Cole-a no campo Chave API no Drimify
3. Clique em Enviar Email de Teste para validar a conexão
4. Salve sua integração

Drimify

Autenticação não obrigatória. Os e-mails são enviados pela infraestrutura de e-mail interna do Drimify (notification@digitaservice.com).

O que você precisa:

• Um nome remetente
• Um endereço de e-mail de resposta (ex.: contact@suacompanhia.com)
• Opcionalmente, um endereço de e-mail BCC

Etapas:

1. Selecione Drimify como seu provedor
2. Insira seu Nome Remetente e E-mail de Resposta
3. Opcionalmente, adicione um E-mail BCC
4. Selecione os espaços de trabalho que devem usar esta integração e salve

Mailgun

O que você precisa:

• Uma chave api Mailgun
• Seu domínio de envio registrado no Mailgun
• Sua região API (EUA ou UE)

Etapas:

1. Na sua conta Mailgun, recupere sua chave de api e domínio de envio
2. No Drimify, insira sua Chave API, Domínio API e Região API
3. Clique em Enviar Email de Teste para validar a conexão
4. Salve sua integração

Mailjet

O que você precisa:

• Uma Chave de Acesso API Mailjet e Chave Privada API

Etapas:

1. Na sua conta Mailjet, vá para Configurações da Conta → REST API → Gestão de Chave API
2. Copie sua Chave de Acesso API e Chave Privada API
3. Insira ambas no Drimify
4. Clique em Enviar Email de Teste para validar a conexão
5. Salve sua integração

Mandrill

O que você precisa:

• Uma chave api Mandrill (Mandrill é um add-on de e-mails transacionais do Mailchimp)

Etapas:

1. Na sua conta Mandrill, vá para Configurações → Chaves API e gere uma chave
2. Cole a Chave API no Drimify
3. Clique em Enviar Email de Teste para validar a conexão
4. Salve sua integração

SendGrid

O que você precisa:

• Uma chave api SendGrid com permissões de Envio de Email

Etapas:

1. Na sua conta SendGrid, vá para Configurações → Chaves API e crie uma chave com permissões de Envio de Email
2. Cole a Chave API no Drimify
3. Clique em Enviar Email de Teste para validar a conexão
4. Salve sua integração

SMTP Personalizado

O que você precisa:

• O hostname do seu servidor SMTP
• Porta SMTP (tipicamente 587 para TLS, 465 para SSL)
• Login SMTP (geralmente seu endereço de email)
• Senha SMTP

Etapas:

1. Recupere suas credenciais SMTP do seu provedor de hospedagem de email ou configuração do servidor
2. No Drimify, insira seu Host, Porta, Login e Senha
3. Clique em Enviar Email de Teste para validar a conexão
4. Salve sua integração

Actualizado em: 07/05/2026