Hemos lanzado una nueva página para desarrolladores que explica la API REST de wwidgets con ejemplos en cURL, JavaScript, PHP y Python, un asistente de preguntas y respuestas y el webhook de ventas que convierte tus pedidos reales en notificaciones sin necesidad de clave API. Si quieres automatizar tus campañas, activar widgets según un horario o llevar las estadísticas a tus propios paneles, ahora tienes todo lo necesario en un solo sitio: la página para desarrolladores de wwidgets.
¿Qué hay en la nueva página para desarrolladores?
Con la nueva página queremos que cualquier desarrollador, o cualquier propietario de tienda con algo de mano técnica, pudiera empezar a integrar wwidgets en pocos minutos. Esto es lo que encontrarás:
- Una explicación clara de la API REST: cómo autenticarte, qué recursos puedes consultar y modificar (campañas, widgets y estadísticas) y qué devuelve cada llamada.
- Ejemplos de código listos para copiar en cuatro lenguajes: cURL, JavaScript, PHP y Python.
- Un asistente de preguntas y respuestas para resolver dudas rápidas sobre la API sin tener que leer toda la documentación.
- La documentación del webhook de ventas, la forma más sencilla de enviar pedidos reales al widget de ventas recientes.
¿Por qué cuatro lenguajes?
Porque cada equipo trabaja con lo suyo. Quien mantiene una tienda WooCommerce o un WordPress suele sentirse cómodo con PHP. Quien construye paneles internos o scripts de automatización tira de Python. Los desarrolladores front-end y de Node.js prefieren JavaScript. Y cURL es el idioma universal para probar una llamada desde la terminal antes de escribir una sola línea de código.
Cada ejemplo muestra la misma operación en los cuatro lenguajes, de modo que puedes copiar el que te encaje, cambiar tu clave y tus identificadores y tenerlo funcionando enseguida.
El webhook de ventas: pedidos reales sin clave API
Una de las preguntas que más nos hacen es cómo mostrar ventas reales en el pop-up de ventas recientes. La respuesta es el webhook de ventas. El widget de ventas recientes puede recibir pedidos a través de un webhook: cuando tu tienda envía los datos de un pedido, el widget lo muestra como notificación.
Lo mejor es que no necesitas clave API para usarlo. Basta con configurar tu tienda para que avise al webhook cuando se complete un pago:
- WooCommerce: puedes usar el hook de pago completado para enviar los datos del pedido al webhook.
- Shopify y otras plataformas: puedes enviar los pedidos al webhook desde tu propia integración o automatización, siguiendo los ejemplos de la página.
Así, la prueba social que ve tu visitante se basa en compras reales, que es exactamente como debe ser.
¿Qué puedes construir con la API de wwidgets?
La API REST te da acceso a tus campañas, widgets y estadísticas. Estas son algunas ideas prácticas:
Sincronizar campañas
Si gestionas varias webs o trabajas en una agencia con varios clientes, puedes crear y actualizar campañas desde tu propio sistema en lugar de hacerlo a mano en el panel. Por ejemplo, mantener la misma configuración en la tienda de Madrid y en la de Barcelona.
Activar y desactivar widgets según un horario
Imagina una cuenta atrás que solo quieres mostrar durante el fin de semana de rebajas, o un botón de WhatsApp que solo debe estar visible en horario de atención. Con una tarea programada (un cron, por ejemplo) que llame a la API, puedes activar y desactivar widgets automáticamente.
Llevar las estadísticas semanales a tus paneles
Las estadísticas de wwidgets incluyen impresiones, hovers, clics, envíos de formulario, CTR y tasa de conversión. Con la API puedes extraerlas cada semana y llevarlas a una hoja de cálculo, a tu herramienta de informes o al panel que uses con tus clientes, junto al resto de tus métricas.
Enviar pedidos de WooCommerce o Shopify
Combinando el webhook de ventas con tu plataforma, cada pedido real puede aparecer como notificación en tu web. Es una integración pequeña que aporta mucha credibilidad.
Detalles técnicos que conviene conocer
| Aspecto | Detalle |
|---|---|
| Tipo de API | REST |
| Recursos | Campañas, widgets y estadísticas |
| Ejemplos | cURL, JavaScript, PHP y Python |
| Límite de peticiones | 60 por minuto |
| Webhook de ventas | Sin clave API |
| Disponibilidad | Plan E-Commerce World y prueba gratuita de 14 días |
| Dónde obtener la clave | Cuenta → API |
El límite de 60 peticiones por minuto es más que suficiente para sincronizaciones, tareas programadas e informes. Si tu script hace muchas llamadas seguidas, añade una pequeña pausa entre ellas o agrupa las operaciones.
¿Qué plan necesito para usar la API?
La API está incluida en el plan E-Commerce World, que cuesta 14 € al mes. También puedes usarla durante la prueba gratuita de 14 días, así que puedes construir y probar tu integración antes de pagar nada. Tienes todos los detalles en la página de planes y precios.
Cómo empezar en cinco minutos
- Crea tu cuenta gratuita si aún no la tienes.
- Entra en Cuenta → API y genera tu clave API.
- Abre la página para desarrolladores y elige un ejemplo en tu lenguaje favorito.
- Sustituye la clave de ejemplo por la tuya y lanza la primera llamada, por ejemplo para listar tus campañas.
- Si tienes dudas, pregunta al asistente de la propia página.
Guarda tu clave API como cualquier otra credencial: no la publiques en el código del navegador ni en repositorios públicos. Si sospechas que se ha filtrado, genera una nueva.
¿Para quién es útil la API?
No hace falta ser una gran empresa para sacarle partido. Estos son los perfiles que más pueden aprovecharla:
- Agencias y freelancers que gestionan las webs de varios clientes y quieren ahorrar tiempo repitiendo configuraciones o preparando informes mensuales con las estadísticas de cada widget.
- Tiendas con su propio equipo técnico que prefieren conectar wwidgets con su sistema de pedidos, su calendario de campañas o su herramienta de análisis.
- Propietarios de tiendas WooCommerce o WordPress que se manejan con un poco de PHP y quieren mostrar ventas reales en sus notificaciones sin depender de terceros.
- Equipos de marketing que quieren ver los clics, el CTR y las conversiones de sus widgets en el mismo panel que el resto de sus campañas.
Si aún no sabes por dónde empezar, el webhook de ventas suele ser la primera integración más útil: es sencilla y se nota enseguida en la web.
Preguntas frecuentes
¿Necesito saber programar para usar el webhook de ventas?
Un poco ayuda, pero no hace falta ser desarrollador. El webhook no necesita clave API y la página incluye ejemplos que puedes adaptar. En WooCommerce, basta con enviar los datos del pedido al completarse el pago.
¿Puedo usar la API con el plan Professional?
La API está incluida en el plan E-Commerce World y en la prueba gratuita de 14 días. Si necesitas la API, E-Commerce World es el plan adecuado.
¿Qué pasa si supero el límite de 60 peticiones por minuto?
Diseña tu integración para respetar el límite: espacia las llamadas, agrupa las operaciones y, si una petición falla, espera unos segundos antes de reintentarla. Para sincronizaciones e informes habituales, 60 peticiones por minuto son de sobra.
Esperamos que la nueva página te ahorre tiempo y te dé ideas para sacar más partido a wwidgets. Échale un vistazo en la página para desarrolladores y, si aún no tienes cuenta, pruébalo gratis 14 días y construye tu primera integración.
