Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.braviloai.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

La integracion de MercadoLibre conecta tu cuenta de vendedor a un Agente. Bravilo puede recibir eventos (mensajes y preguntas) por webhook y responder automaticamente segun la configuracion del agente.

Requisitos

  • Una cuenta de MercadoLibre con permisos de administrador (no operador)
  • Una aplicacion creada en MercadoLibre Developers (App ID / Secret)
  • Tu Bravilo accesible publicamente (para recibir webhooks)

Quick start (Dashboard)

1

Conectar MercadoLibre

  1. Abre tu Agente en el dashboard. 2. Ve a la pestana Implementar. 3. Selecciona MercadoLibre. 4. Hace click en Conectar y autoriza en MercadoLibre.
2

Verificar

Al volver, deberias ver el estado Conectado y datos de tu cuenta.
3

Webhook (automatico)

Durante la conexion, Bravilo intenta registrar webhooks para los topics messages y questions.

Self-host (configuracion)

Variables de entorno:
NEXT_PUBLIC_MERCADOLIBRE_CLIENT_ID=...

MERCADOLIBRE_CLIENT_ID=...
MERCADOLIBRE_CLIENT_SECRET=...
NEXT_PUBLIC_DASHBOARD_URL=https://tu-dominio.com
Callback URL: https://tu-dominio.com/api/integrations/mercadolibre/callback Webhook URL (la que se registra en MercadoLibre): https://tu-dominio.com/api/integrations/mercadolibre/webhook
El flujo de autorizacion actualmente usa el dominio auth.mercadolibre.com.ar. Si operas en otros sites, puede requerir ajustes.

Troubleshooting

  • No conecta / error en autorizacion: revisa que el redirect_uri coincida exactamente.
  • invalid_operator_user_id: estas autorizando con un usuario operador/colaborador; usa la cuenta admin.
  • No llegan eventos: confirma que el webhook sea accesible desde internet y que MercadoLibre lo tenga registrado.

Limitaciones

  • La recepcion de eventos depende de webhooks; si tu deployment no es publico, no vas a recibir mensajes/preguntas.