Documentación
Integraciones.md

H2O — Sistema de gestión

¿Qué es?

H2O conecta el sistema de gestión de aguas (Gestión Aguas) con tus agentes de Anunzi. Una vez conectado, tus agentes —de voz y de WhatsApp— pueden consultar datos reales del cliente durante la conversación: buscar un cliente, ver su próxima visita, sus envases y equipos, el catálogo de productos y su saldo.

Es una integración especializada: la tarjeta y las funciones solo aparecen para las cuentas que tienen acceso a los agentes habilitados para este sistema.


Conectar la integración

  1. Ve a Integraciones y abre la tarjeta 💧 H2O — Sistema de gestión.
  2. Pega el access token (el token bearer del sistema de gestión) en el campo correspondiente.
  3. Haz clic en Conectar.

Al guardar, Anunzi valida el token contra la API antes de activar la integración: si el token es inválido, te avisa en el momento en vez de fallar más tarde en una conversación.

El token no vence. Si en algún momento lo revocan, la integración deja de funcionar y hay que pegar uno nuevo desde esta misma pantalla (Actualizar token).


Activar las funciones en un agente

Con la integración conectada, las funciones se agregan desde la ficha del agente:

  1. Abre el agente (de voz o de WhatsApp).
  2. Ve a Funciones → Agregar función → 🧩 Personalizadas.
  3. Elige 💧 Marinaro — Gestión de aguas y actívala. Se agregan las cinco funciones juntas.
  4. En agentes de voz, confirma con Guardar funciones.

Qué puede hacer el agente

Función Qué consulta
Buscar cliente Encuentra al cliente por razón social, CUIT o código. Devuelve sus datos y el identificador que usan las demás funciones.
Próxima visita La siguiente visita programada del cliente.
Envases y equipos Los envases y equipos que el cliente tiene asignados.
Listar productos El catálogo de productos, con búsqueda por texto (ej. "bidón 20 litros").
Saldo del cliente Si el cliente registra saldo pendiente y de cuánto.

Cómo trabaja el agente

  • Primero identifica al cliente. El agente pide la razón social o el CUIT y busca. Si no aparece, reintenta con una parte del nombre. Si hay varios resultados, ofrece las opciones para que la persona confirme.
  • Una vez identificado el cliente, encadena el resto de las consultas (próxima visita, envases, saldo) sin volver a pedir los datos.
  • Si una consulta no devuelve resultados, el agente lo dice con naturalidad y ofrece tomar el dato para verificarlo, en vez de inventar una respuesta.

Preguntas frecuentes

No veo la tarjeta de H2O en Integraciones. Es una integración especializada: solo aparece para las cuentas con acceso a los agentes habilitados. Si crees que deberías verla, contáctate con el equipo de Anunzi.

Conecté el token pero el agente dice que "no está configurado". Verifica que la integración figure como Conectado en la tarjeta de H2O, y que la función esté activada en la ficha de ese agente (Funciones → 🧩 Personalizadas).

Cambié el token. ¿Hace falta algo más? No. Al actualizar el token se refresca todo automáticamente; los agentes toman el nuevo en la siguiente consulta.

Esc