Saltar al contenido
Fipeo

Fipeo para desarrolladores

Widget y WordPress

Acceso anticipado. La API, los webhooks y el widget están apagados para la mayoría de las cuentas mientras los probamos con las primeras escuelas y agencias. Esta documentación es pública para que puedas planear tu integración: escríbenos a [email protected] y te lo encendemos.

El widget de precios enseña cursos con precios en vivo en tu propia web. El visitante elige curso, fecha de inicio, semanas y alojamiento, ve el precio y manda una solicitud de reserva. En una escuela, la solicitud llega a su bandeja de reservas (confirmada al instante si hay plazas); en una agencia, entra en su CRM como estudiante con una oportunidad. Nunca se enseña una comisión ni un precio neto.

Crea un widget

  1. Escuela: Formulario de reserva para tu web › Widget de precios. Agencia: Widget de precios en el menú (titular o administrador).
  2. Elige qué enseña (cursos y alojamientos, o escuelas en una agencia), su idioma y su color, si el teléfono es obligatorio, si se ve el desglose del precio o solo el total, y el enlace a tus condiciones.
  3. Añade las direcciones de tu web donde lo vas a poner (por ejemplo https://www.miescuela.com). El navegador solo deja que el widget salga en esas webs.
  4. Actívalo y pulsa Copiar el código. Puedes tener hasta 10 widgets.

Ponlo en tu web

El script ligero (recomendado): crea el iframe y ajusta su altura al contenido. No lee nada de tu página ni guarda cookies.

html
<div data-fipeo-widget="wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" data-lang="es"></div>
<script src="https://fipeo.net/w/embed.js" async></script>
AtributoQué hace
data-fipeo-widgetLa clave del widget (w + 31 caracteres). Obligatorio.
data-langen, es, fr, it, de o pt. Por defecto, el idioma de tu página.
data-heightAltura inicial en píxeles (640 por defecto). Después sigue al contenido.
data-titleTítulo del iframe, para los lectores de pantalla.

O un iframe sin más, si tu web no deja poner scripts (su altura no se ajusta sola):

html
<iframe src="https://fipeo.net/api/v1/public/widget/wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/frame?lang=es"
        title="Prices and booking" style="width:100%;min-height:640px;border:0" loading="lazy"></iframe>

También puedes compartir un enlace directo: https://fipeo.net/w/<clave>.

WordPress

El plugin de Fipeo añade un shortcode. Pégalo en cualquier página o entrada:

text
[fipeo_widget key="wXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" lang="es" height="800"]
  • lang y height son opcionales (el idioma de tu web y 640 píxeles por defecto).
  • El plugin solo pinta el <div> del widget y carga embed.js de Fipeo: no guarda nada ni manda nada desde tu servidor.
  • Todavía no está en el directorio de WordPress: pide el .zip a [email protected] y súbelo en Plugins › Añadir nuevo › Subir plugin.

Seguridad

El widget vive en un iframe de fipeo.net, con una política de seguridad de contenido estricta: scripts solo de Fipeo y frame-ancestors limitado a tus direcciones. Las solicitudes van firmadas y con hora, tienen una trampa para robots y límites por dirección, y la casilla de consentimiento nunca viene marcada (se guarda el texto exacto que aceptó el visitante).