Autenticación

Claves de API, scopes y qué rutas se pueden usar con una clave y cuáles son solo del panel.

Actualizado:

Claves de API

Las claves las crea el Dueño en Configuración → Desarrolladores. Se muestran una sola vez. Enviá tu clave como bearer token:

GET /v1/me HTTP/1.1
Host: api.fiuit.com
Authorization: Bearer wg_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxx
PrefijoModo
wg_live_Datos de producción y mensajes reales
wg_test_Solo lectura: permite listar y leer, no crear ni modificar nada. Un sandbox para escrituras es Próximamente

Las claves pertenecen a un proyecto (workspace). El proyecto siempre se toma de la clave: no hay id de workspace en paths ni en bodies. Las claves se guardan hasheadas.

Scopes

ScopePermite
slots:readGET /slots
bookings:readLeer reservas y tareas (/bookings, /work-items), historial de etapas, adjuntos, estadísticas del equipo
bookings:writePre-reservas, confirmar, cancelar, reprogramar, check-in, ausencia, completar, ejecutar acciones y editar prioridad, etiquetas y vencimiento de una tarea
customers:readLeer y buscar clientes, su historial, resumen y comentarios
customers:writeCrear y editar clientes
messages:readLeer conversaciones y mensajes
messages:writeEnviar mensajes, cambiar el modo (bot o persona), resolver, marcar como leído
config:read / config:writeServicios, recursos, equipos, horarios, automatizaciones por regla, conocimiento y bot
settings:writeReemplazar y revertir etapas, acciones y formularios (/services/{id}/stages)
webhooks:manageEndpoints de webhooks salientes
products:read / products:writeLeer y gestionar el catálogo de productos
payments:read, payments:read_balanceLeer cobros y saldos de tareas
payments:record, payments:link, payments:void, payments:adjust, payments:refund, payments:fiscalRegistrar cobros, generar enlaces, anular, ajustar, devolver y marcar datos fiscales
expenses:read, expenses:record, expenses:void, expenses:approveLeer, registrar, anular y aprobar gastos
commissions:read, commissions:configure, commissions:adjust, commissions:settle, commissions:exportLeer, configurar, ajustar, liquidar y exportar comisiones
cash:read, cash:remit, cash:close, cash:configureLeer caja, rendir, cerrar y configurar
finance:analyze, finance:exportConsultar y exportar reportes de Dinero
customer_balance:read, customer_account:readLeer el saldo y la cuenta corriente del cliente
prepaid:read, prepaid:manage, prepaid:sell, prepaid:benefitsLeer, administrar y vender paquetes y clubes, y gestionar beneficios
partner:readLeer el panel del partner que emitió la clave

Un request sin el scope necesario devuelve 403 con code: "insufficient_scope".

Las fuentes de conocimiento (/knowledge/sources) y la política del bot por canal aceptan config:read / config:write. GET /connection/projects permite listar los proyectos de la credencial; administrarlos sigue siendo solo del panel.

Qué es solo del panel

Estas áreas no aceptan claves de API: usan la sesión de una persona del equipo (con su rol) y están protegidas con CSRF. Si las llamás con una clave, la API responde que no están disponibles para ese tipo de credencial.

  • Canales, pausas de canales y de la IA, estado del servicio.
  • Reglas de automatización (/automation-flows), asistente Wagy y su plan.
  • Equipo, invitaciones, claves de API, proyectos y soporte de plataforma.
  • Telegram del equipo y preferencias de avisos.

El listado de endpoints marca cuáles son cuáles.

Rotación

Creá una clave nueva, desplegala y después revocá la vieja en Configuración → Desarrolladores. Las claves revocadas devuelven 401 al instante.