Herramientas

Las 13 herramientas que expone Riverz por MCP. Esta lista se genera del código que corre en producción, así que no puede quedar vieja.

workspace_id aparece en muchos esquemas porque el servidor lo usa internamente, pero no hace falta que lo mandes: sale de tu llave. Si mandás uno que no es el tuyo, la llamada se rechaza.

Lectura

No cambia nada. Disponible con cualquier llave.

cuentas_listar

Lista las cuentas (workspaces) vivas con su nombre, cuántos contactos y canales tienen, y cuántas automatizaciones activas. Es el punto de entrada: el workspace_id que devuelve se usa en todas las demás. Con una clave de comercio devuelve sólo la suya.

operacion_estado

Panorama de una cuenta: canales conectados, automatizaciones activas con su última corrida, mensajes enviados hoy, crons que fallaron y decisiones esperando aprobación.

por_que_no_salio

Explica por qué una persona no recibió un mensaje. Recibe un teléfono y devuelve: si está dada de baja, qué automatizaciones corrieron para ese contacto y con qué resultado, qué barrera lo frenó, y los mensajes que sí salieron. Es la herramienta de diagnóstico.

Parámetros: telefono (obligatorio), dias

conversaciones_pendientes

Las conversaciones que están esperando una respuesta: alguien escribió y nadie contestó, o la IA pidió que intervenga una persona. Es la primera pregunta de la mañana.

Parámetros: limite

contacto_buscar

Busca un cliente por teléfono, nombre o correo y devuelve su ficha: etiquetas, si pidió la baja, cuándo escribió por última vez, sus pedidos y qué le interesó. Sirve para contestar "¿quién es este?" antes de escribirle.

Parámetros: busqueda (obligatorio)

metricas

Cómo viene la cuenta en un período: mensajes que entraron y salieron, cuántos contestó la IA, contactos nuevos, pedidos y cuánto facturaron. Es el "¿cómo vamos?".

Parámetros: dias

plantillas_estado

Las plantillas de WhatsApp con su estado en Meta y el motivo de rechazo cuando lo hay. Una rechazada no se puede usar en ninguna campaña ni automatización, así que suele ser la causa de que algo no salga.

campanas_estado

Las campañas y cómo terminaron: a cuántos salió, cuántos la recibieron, cuántos contestaron y cuántas fallaron. Incluye las que quedaron trabadas en "enviando".

Parámetros: dias

pedidos_listar

Los pedidos de la cuenta con su estado de pago y de envío, incluido el seguimiento cuando existe. Sirve para contestarle a un cliente dónde está lo suyo.

Parámetros: dias, estado_pago

Reversible

Cambia algo que se puede deshacer. Necesita una llave de escritura.

automatizacion_activar

Prende o pausa una automatización. Se deshace llamando de nuevo.

Parámetros: automation_id (obligatorio), activa (obligatorio)

automatizacion_editar_espera

Cambia cuánto espera un paso de espera. El paso se identifica por su id, que sale de operacion_estado o del lienzo.

Parámetros: step_id (obligatorio), amount (obligatorio), unit (obligatorio)

aprobacion_decidir

Aprueba o rechaza una decisión que estaba esperando (las que devuelve operacion_estado). Aprobar ejecuta lo que estaba pendiente.

Parámetros: approval_id (obligatorio), aprobar (obligatorio)

Irreversible

Le llega a una persona. Necesita llave de escritura Y confirmación.

mensaje_enviar

Manda un mensaje de WhatsApp a un contacto de la cuenta. Le llega a una persona real, así que primero devuelve qué haría y espera confirmación.

Parámetros: contact_id (obligatorio), texto (obligatorio)