Documentación de Riverz

Riverz atiende, vende y hace seguimiento por WhatsApp, Instagram, Messenger, correo y Mercado Libre. Esta documentación es para conectarle tus propias herramientas.

Conectar un agente

Riverz habla MCP (Model Context Protocol). Con eso, cualquier asistente que lo soporte —Claude, un flujo de n8n, algo tuyo— puede preguntarle a tu operación y actuar sobre ella: quién escribió y nadie contestó, por qué no le llegó el mensaje a un cliente, cómo salió una campaña, mandarle algo a alguien.

Hay dos formas de conectarlo, y las dos terminan en el mismo lugar:

  • Con una llave que copiás de Ajustes y pegás en tu cliente. Es lo más rápido y funciona con todo lo que sepa mandar una cabecera. Cómo se hace.
  • Con OAuth, para los clientes que descubren el servidor solos y te mandan a una pantalla a decir que sí. Cómo funciona.

Lo que hay que saber antes de empezar

  • La llave lleva tu cuenta adentro. No hay forma de que un agente tuyo toque la cuenta de otro, ni aunque lo pida: el servidor no le cree cuando nombra una.
  • Por defecto las llaves son de sólo lectura. Escribir se pide aparte.
  • Lo irreversible —mandarle un mensaje a una persona— no se ejecuta de una: primero devuelve qué haría y espera confirmación.
  • Queda registrado todo, incluidas las lecturas. Lo ves en Ajustes → Agentes (MCP).

La dirección

El servidor está en https://riverz.co/api/mcp. Es el mismo para las dos formas de conectarse.