Comprendiendo Webhooks, APIs y Callbacks de JavaScript
Integrar Drimify: Una Guía sobre APIs, Webhooks y Callbacks de JavaScript
Al crear experiencias interactivas con Drimify, a menudo necesitas que los datos fluyan hacia tu infraestructura tecnológica existente —por ejemplo, agregando automáticamente un nuevo lead a tu CRM o activando un evento personalizado en tu página web en el momento en que un usuario completa un juego. Para lograr esto, Drimify ofrece tres métodos de integración: APIs, Webhooks y Callbacks de JavaScript. Aquí te mostramos cómo elegir el adecuado para las necesidades de tu negocio.
1. API: Pedir Datos "Bajo Demanda"
Una API (Interfaz de Programación de Aplicaciones) permite que tu sistema solicite información específica de Drimify cuando la necesites.
- Cómo funciona: Tu servidor envía una solicitud a Drimify pidiendo datos específicos (por ejemplo, "Dame todas las entradas de las últimas 24 horas"). Luego, Drimify te envía esos datos de vuelta.
- Mejor para: Generar informes, sincronizar datos masivos en tu escritorio o auditar los números de participación al final de una campaña.
- Punto clave: Tu sistema inicia la conversación.
2. Webhook: Notificaciones "En Tiempo Real"
Un Webhook es una notificación que Drimify envía automáticamente a tu servidor en el momento en que ocurre un evento específico.
- Cómo funciona: Definas un "Disparador" (como cuando un usuario completa un formulario de registro o termina una experiencia). Tan pronto como eso sucede, Drimify empuja los datos de contacto del usuario o detalles directos a la URL de tu CRM o base de datos.
- Mejor para: Automatización en tiempo real, como enviar instantáneamente un correo electrónico de "Bienvenida" o actualizar el perfil de un lead en tu CRM.
- Punto clave: Drimify inicia la conversación automáticamente basado en un evento predefinido.
3. JavaScript Callback: Reacción "En el Navegador"
Un Callback de JavaScript maneja la comunicación entre el widget de Drimify y la página web o aplicación donde está incrustado. A diferencia de APIs o Webhooks, esto sucede localmente en el navegador del usuario.
- Cómo funciona: Tu página web "escucha" las acciones que tienen lugar dentro del iframe de Drimify. Cuando un usuario alcanza un hito específico, el juego envía una señal a tu página principal (por ejemplo,
onComplete). - Mejor para: Provocar cambios visuales inmediatos en tu sitio, como ocultar el juego para revelar un enlace de descarga oculto o redirigir al usuario a una página específica de aterrizaje.
- Punto clave: Conecta la experiencia con la interfaz de tu sitio web en tiempo real.
Comparación y Casos de Uso
Función | API | Webhook | Callback de JavaScript |
Dirección | Tu Sistema → Drimify | Drimify → Tu Sistema | Drimify → Tu Sitio Web/App |
Entorno | Servidor a Servidor | Servidor a Servidor | Navegador/Cliente |
Uso Común | Sincronización masiva de datos | Automatización de CRM y Correos Electrónicos | Cambios Dinámicos de UI |
Ejemplo | Extracción de un informe semanal | Enviar un nuevo lead a HubSpot | Mostrar un botón de "Reclamar Premio" |
Entendiendo el "Backend" vs. "Frontend"
Para elegir el método adecuado, pregúntate: "¿A dónde necesitan ir los datos?"
- A tu Base de Datos o CRM (Backend): Usa Webhooks. Así es como envías el correo electrónico de un lead o los detalles de contacto de manera segura desde Drimify a tus sistemas internos (como HubSpot, Salesforce o una base de datos personalizada). Funciona perfectamente ya sea que tu campaña esté en una página web o en una aplicación.
- A la Pantalla del Usuario (Frontend): Usa Callbacks de JavaScript. Esto es para cuando quieres que el sitio web reaccione instantáneamente a la acción de un jugador—por ejemplo, mostrando un botón de "Reclama Tu Descuento" en tu página web en el momento que terminen el juego.### Comparativa de Integración
Característica | Webhooks (Recomendado para Datos) | JavaScript Callbacks (Ideal para UX) |
Conexión | Servidor a Servidor | Navegador a Navegador |
Objetivo Principal | Transferir de forma segura datos de leads e información de contacto. | Crear una experiencia sin interrupciones "en vivo" en tu sitio. |
Ejemplo en el Mundo Real | Añadir automáticamente un participante a tu lista de correo. | Ocultar el juego y mostrar un código promocional en tu página. |
Seguridad | Alta (ocurre en segundo plano). | Directa (ocurre en el dispositivo del usuario). |
Resumen de Casos de Uso
Ya sea que estés incorporando Drimify en un sitio web o dentro de una aplicación móvil, a menudo utilizarás una combinación de ambos:
- Un Webhook para asegurarte de que tu equipo de marketing reciba los detalles de contacto del lead en tu CRM.
- Un JavaScript Callback para asegurarte de que el usuario vea un mensaje de "Gracias" o un enlace de recompensa de inmediato sin necesidad de refrescar la página.
Nota sobre Callbacks: Dado que los JavaScript Callbacks se ejecutan en el navegador del usuario, son excelentes para la experiencia del usuario (UX) pero no deben usarse para la validación de datos de alta seguridad. Para transferencias seguras de datos en el lado del servidor (como información sensible de leads), siempre prioriza los Webhooks.
Actualizado el: 20/03/2026
¡Gracias!