Integración WhatsApp (Evolution API)
Sistema > Integraciones > WhatsApp (/settings/integrations/whatsapp). Con Evolution conectado, la herramienta Obtener fotos (en Mantenimiento) pasa a intentar la foto de WhatsApp de los contactos.
Qué hace — y qué no hace
Esta integración no muestra ninguna foto por sí sola. Es una fuente para la búsqueda de fotos, no un recurso autónomo. Sin ella, la búsqueda usa solo Gravatar — "y raramente tiene una foto para un número brasileño", que es justamente el motivo por el que la integración existe.
La foto encontrada se guarda en el registro de la persona. No se busca en cada visita, ni por debajo: solo cuando alguien ejecuta Obtener fotos.
La foto aparece en Personas — en el listado y en el detalle. No aparece en las pantallas de cuentas por pagar o por cobrar.
Configuración por empresa
Las credenciales son por empresa, no por espacio de trabajo — cada una puede tener su propia instancia. Sin una empresa seleccionada, la página no muestra la configuración: se queda en "Selecciona una empresa".
La empresa viene del selector del encabezado, no de un paso dentro de la página.
Son tres campos, y el botón solo se habilita con los tres completos:
| Campo | Ejemplo |
|---|---|
| URL de Evolution API | https://evolution.example.com |
| Nombre de instancia | kobana-finance |
| Clave API | La clave de la instancia. "La clave se almacena cifrada y nunca se devuelve en GET." |
El botón es "Conectar" — o "Actualizar", si ya hay credenciales.
Privacidad y seguridad
- La Clave API se cifra en reposo y nunca se devuelve en la lectura.
- El sistema rechaza destinos privados: direcciones de loopback, redes internas y link-local están bloqueadas, lo que impide usar la integración para alcanzar servicios de la infraestructura.
No es obligatorio que sea HTTPS. http:// se acepta — lo que el sistema rechaza es el destino, no el protocolo. Aun así, un endpoint en HTTP transporta la Clave API en claro: prefiere HTTPS.
Obtener fotos
La búsqueda es manual, en Mantenimiento → Obtener fotos. No hay worker periódico.
Cada ejecución:
- Intenta Gravatar primero (por el correo) y WhatsApp después (por el teléfono), parando en la primera fuente que responda.
- Recorre solo a quien todavía no tiene foto — a quien ya la tiene se lo omite.
- Procesa como máximo 100 personas por vez.
- Espera 30 días antes de reintentar con quien falló.
Eliminar
El botón es "Eliminar". La confirmación dice el efecto exacto: "Las credenciales de la empresa serán eliminadas. La próxima ejecución de 'Obtener Fotos' para esta empresa omitirá WhatsApp — solo Gravatar."
Las fotos ya obtenidas continúan en el registro: eliminar la credencial no borra lo que se encontró.