Quickstart

Instala el widget de Feedjolt, crea una clave API y recibe tu primer webhook en un túnel local. Guía rápida de 10 min para desarrolladores; omite lo que no uses.

Estado final: botón de feedback en tu sitio, una llamada a la API funcionando desde tu terminal y un webhook llegando a un túnel a localhost. Salta las partes que no necesites.

Requisitos

Un espacio de Feedjolt. Regístrate si no tienes uno.
Tu slug de espacio - la parte de la URL. Está en Panel -> Ajustes -> General.
10 minutos.

Pega esto antes de </body> en cualquier página de tu sitio:

<script async src="https://www.feedjolt.com/widget-loader.js"
        data-workspace="TU_SLUG_DE_ESPACIO"></script>

Recarga la página. Deberías ver un botón "Feedback" flotante en la esquina inferior derecha.

Haz clic; el widget se abre. Envía un post de prueba. Debería aparecer en tu panel en Panel -> Tableros -> [tu tablero por defecto] en segundos.

2. Consigue una clave API (3 min)

Panel -> Ajustes -> Claves API -> Nueva clave.

Pon un nombre honesto: local-dev-marc, no key.
Scopes: empieza con scopes de solo lectura.
Copia la clave cuando se muestre. Empieza con fjk_. No la verás otra vez.

Pruébala (sustituye TU_SLUG_DE_TABLERO por uno de tus tableros):

curl -H "Authorization: Bearer fjk_TU_CLAVE" \
  "https://api.feedjolt.com/api/v1/boards/TU_SLUG_DE_TABLERO/posts?limit=5"

Deberías recibir JSON con hasta 5 posts. Si recibes 401, la clave es incorrecta o está revocada. Si 403, el scope es demasiado estrecho.

La referencia completa de endpoints está en https://api.feedjolt.com/docs.

3. Recibe un webhook (5 min)

Para dev local, necesitarás un túnel. Recomendamos ngrok o Cloudflare Tunnel.

ngrok http 3000
# -> https://abc123.ngrok-free.app

En tu código, acepta peticiones POST:

// Node + Express
import express from "express";
const app = express();
app.use(express.json());

app.post("/feedjolt-webhook", (req, res) => {
  console.log("event:", req.headers["x-feedjolt-event"]);
  console.log("body:", req.body);
  res.status(200).send("ok");
});

app.listen(3000);

En Feedjolt: Panel -> Ajustes -> Webhooks -> Nuevo endpoint.

URL: https://abc123.ngrok-free.app/feedjolt-webhook
Eventos: elige unos cuantos (por ejemplo, post.created, status.changed).
Haz clic en Guardar. Copia el secreto de firma.

Dispara un evento enviando un post de feedback (usa el widget que acabas de instalar). En unos 5 segundos, tu endpoint debería recibir un POST.

La verificación de firma es esencial antes de pasar a producción. Ver Webhooks: firma.

4. Limpieza

Revoca la clave API al terminar las pruebas: Ajustes -> Claves API -> Revocar.
Elimina el endpoint de webhook de prueba: Ajustes -> Webhooks -> Eliminar.
Elimina los posts de prueba: abre el post -> Eliminar, o usa la API.

Qué viene después

Configuración del widget - los cinco atributos data-*.
Firma de webhooks - verifica que las peticiones son realmente nuestras.
Referencia API - cada endpoint, con try-it.

Si algo de esta guía no funcionó, reporta el bug - queremos que esta guía sea sin fricción.