Integrando Drimify: Um Guia para APIs, Webhooks e JavaScript Callbacks

Ao criar experiências interativas com Drimify, muitas vezes é necessário que os dados fluam para o seu stack tecnológico existente. Por exemplo, adicionar automaticamente um novo lead ao seu CRM ou acionar um evento personalizado no seu site assim que um usuário termina um jogo. Para facilitar isso, Drimify oferece três métodos de integração: APIs, Webhooks e JavaScript Callbacks. Veja como escolher o método certo para as necessidades do seu negócio.

1. API: A Extração de Dados "Sob Demanda"

Uma API (Interface de Programação de Aplicativos) permite que o seu sistema solicite informações específicas do Drimify sempre que necessário.

• Como funciona: Seu servidor envia um pedido para o Drimify solicitando dados específicos (por exemplo, "Dê-me todas as entradas das últimas 24 horas"). O Drimify então envia esses dados de volta para você.
• Ideal para: Gerar relatórios, sincronizar dados em massa para o seu painel ou auditar números de participação ao final de uma campanha.
• Dica principal: Seu sistema inicia a conversa.

2. Webhook: O Envio "Em Tempo Real"

Um Webhook é uma notificação enviada automaticamente do Drimify para o seu servidor no momento em que um evento específico ocorre.

• Como funciona: Você define um "Gatilho" (como um usuário completando um formulário de inscrição ou terminando uma experiência). Assim que esse evento acontece, o Drimify envia os detalhes de contato do usuário ou dados diretamente para o URL do seu CRM ou banco de dados.
• Ideal para: Automação em tempo real, como enviar instantaneamente um e-mail de "Bem-vindo" ou atualizar o perfil de um lead no seu CRM.
• Dica principal: O Drimify inicia a conversa automaticamente com base em um evento pré-definido.

3. JavaScript Callback: A Reação "No Navegador"

Um JavaScript Callback lida com a comunicação entre o widget do Drimify e o site ou aplicação onde está incorporado. Diferente das APIs ou Webhooks, isso acontece localmente no navegador do usuário.

• Como funciona: Seu site "ouve" ações ocorrendo dentro do iframe do Drimify. Quando um usuário atinge um marco específico, o jogo envia um sinal para a sua página pai (por exemplo, onComplete).
• Ideal para: Acionar mudanças visuais imediatas no seu site, como ocultar o jogo para revelar um link de download escondido ou redirecionar o usuário para uma página de destino específica.
• Dica principal: Conecta a experiência com o front-end do seu site em tempo real.

Comparação & Casos de Uso

Compreendendo o "Backend" vs. "Frontend"

Para escolher o método certo, pergunte-se: "Para onde os dados precisam ir?"

• Para o seu Banco de Dados ou CRM (Backend): Use Webhooks. É assim que você envia o endereço de e-mail ou detalhes de contato de um lead de forma segura do Drimify para seus sistemas internos (como HubSpot, Salesforce ou um banco de dados personalizado). Funciona perfeitamente, quer sua campanha esteja em um site ou em uma aplicação.
• Para a Tela do Usuário (Frontend): Use JavaScript Callbacks. Isto é para quando você deseja que o próprio site reaja instantaneamente à ação de um jogador—for example, mostrando um botão "Reivindique seu Desconto" na sua página assim que ele termina o jogo.### Integração Comparison

Resumo de Casos de Uso

Seja integrando Drimify num site ou numa app móvel, muitas vezes utilizará uma combinação de ambos:

1. Um Webhook para garantir que a sua equipa de marketing receba os detalhes de contacto dos leads no seu CRM.
2. Um JavaScript Callback para assegurar que o utilizador veja uma mensagem de "Obrigado" ou um link de recompensa imediatamente sem precisar recarregar a página.

Nota sobre Callbacks: Como os JavaScript Callbacks são executados no navegador do usuário, são excelentes para a experiência do utilizador (UX), mas não devem ser usados para validação de dados de alta segurança. Para transferências de dados seguras e do lado do servidor (como informações sensíveis de leads), priorize sempre Webhooks.

Actualizado em: 20/03/2026