Soporte — Sakbe

Ayuda, configuración y preguntas frecuentes

¿Necesitas ayuda?

Escríbenos a [email protected] y te respondemos en 1–2 días hábiles.

Antes de escribir, revisa las preguntas frecuentes.

Configuración y conexión

Pantalla de Ajustes de Sakbe con la conexión A2A configurada y el indicador de estado A2A Listo

¿Necesito una cuenta para usar Sakbe?

No. Sakbe no tiene cuentas, no tiene servidores propios y no tiene suscripciones. Es un cliente: tú le dices a qué agente conectarse (dominio + token) y listo.

¿Qué servidores puedo usar?

Es cualquier servidor que implemente el protocolo Agent2Agent (JSON-RPC 2.0). Puede ser un agente que tú construyas, un gateway con herramientas, o un servicio gestionado. Sakbe no incluye ni exige un agente específico.

¿Dónde escribo mi dominio y mi token?

Abre Sakbe → icono de engranaje (Ajustes) → sección A2A Connection. Escribe el dominio (ej. miagente.com o https://miagente.com:8443) y pega tu bearer token. Al guardar, Sakbe verifica la conexión y muestra el punto verde/rojo.

¿Puedo cambiar de agente mientras uso la app?

Sí. Cambia el dominio o el token en Ajustes. Sakbe limpia el contexto de tareas pendiente y re-verifica la conexión.

¿Qué pasa si no tengo conexión a mi agente?

El punto de estado se pone rojo, el micrófono y el botón de envío se desactivan, y aparece un mensaje. No se envía nada. Cuando la conexión vuelve, toca pull-to-refresh para re-verificar.

¿Sakbe envía mis mensajes a algún servidor de Sakbe?

No. Sakbe no tiene backend. Tus mensajes van exclusivamente al endpoint que tú configuras.

Voz

¿El reconocimiento de voz funciona sin internet?

Sí, siempre que tu idioma tenga modelo local en el dispositivo (español e inglés sí lo tienen). Si tu idioma no tiene modelo local, iOS usa el reconocimiento de Apple y necesitarás conexión. Cuando falta el modelo, iOS lo descarga automáticamente.

¿Puedo elegir el idioma de la voz por separado al de la app?

Sí. En Ajustes → Speech Recognition eliges el idioma del reconocedor, y en Text-to-Speech eliges la voz. Son independientes del idioma de la interfaz.

¿Por qué el micrófono se cierra solo?

Sakbe detiene la grabación tras 2 s de silencio (si ya hablaste) o 10 s sin detectar sonido. Si prefieres detener tú, toca el micrófono de nuevo: el transcript cae en el campo de texto para que edites antes de enviar.

¿Puedo pausar la lectura en voz alta?

Sí. El botón tiene tres estados: Leer → Detener → Reanudar. Mantén presionado (medio segundo) para detener; si la lectura está en pausa, te pide confirmación antes de reiniciar el mensaje. La píldora flotante te da los controles.

¿Cómo funciona el resaltado palabra por palabra?

Mientras Sakbe lee la respuesta, cada palabra que suena se ilumina en la burbuja y la vista hace scroll automático para seguirla. Se calcula con CoreText para alineación exacta, incluso con Markdown, diacríticos o emojis.

Respuestas y media

Respuesta de Sakbe leída en voz alta con la palabra actual resaltada en amarillo y los controles de lectura

¿Qué formatos de respuesta entiende Sakbe?

  • Markdown: encabezados, listas, código, tablas, enlaces, citas.
  • Imágenes: rejilla de 2 columnas.
  • YouTube: reproductor embebido.
  • Video directo / HLS: póster + reproductor.
  • Audio: reproductor inline.
  • Enlaces: preview con Open Graph + apertura en Safari.

¿Puedo guardar una imagen de la respuesta?

Sí. Toca la imagen → visor a pantalla completa → Guardar en Fotos o Compartir.

¿Sakbe renderiza HTML de los previews?

No. Solo extrae <meta> y <title> con un parser y los muestra como texto plano. El HTML nunca se ejecuta.

Continuidad y segundo plano

¿Qué pasa si mi agente tarda más de 30 segundos?

Sakbe inserta una frase de espera hablada apenas detecta que tu agente está trabajando (generada on-device, en tu idioma, sin inventar resultados). A los 30 s se repite y luego cada 60 s mientras el agente reporta WORKING. Cuando llega la respuesta real, las frases se borran.

¿Recibo notificaciones si la respuesta tarda mucho?

Sí. Si la respuesta no llega en ~10 min, iOS te muestra un aviso local para que reintentes. Si la respuesta llega cuando no estás en esa conversación, se publica una notificación con los primeros 300 caracteres. Al tocarla, Sakbe abre, refresca y lee la respuesta.

¿Sakbe consume batería haciendo polling?

El polling es adaptativo: arranca a 1 s y crece ×1.5 en conexiones rápidas; en lentas respeta tu intervalo base. BGAppRefreshTask solo se ejecuta cuando iOS lo permite. Ajustes → Behavior (10–240 s).

Privacidad y seguridad

¿Dónde se almacena mi token?

En el Keychain de iOS. No en UserDefaults, no en disco plano, no en la nube.

¿Dónde se guardan mis conversaciones?

En el sandbox de la app (Application Support/sakbe/conversations.json). Escritura atómica. No salen de tu dispositivo excepto cuando se envían a tu endpoint.

¿Qué datos envía Sakbe a la red?

  1. Tus mensajes al endpoint que tú configuras.
  2. Fetchs de previews de enlaces (HTTPS, max 512 KB, max 3 redirects).
  3. Miniaturas y media de los enlaces de tus respuestas, desde su propio sitio.
  4. Nada más. Sin analytics, ads ni telemetría.

¿Puedo borrar todo?

Clear Conversation (con confirmación) borra el historial de la conversación abierta. Reset to Defaults (con confirmación) borra dominio, token, idioma y voz. O desinstala la app.

Requisitos

¿En qué dispositivos funciona?

iPhone y iPad con iOS / iPadOS 26.2 o superior.

¿Necesito Apple Intelligence?

No. Sakbe los usa para tareas auxiliares, pero si no están disponibles, usa un fallback local y todo sigue funcionando.

¿Hay versión para Android / macOS / web?

No, al momento. Sakbe es iOS / iPadOS.

¿Debo pagar por Sakbe?

No. La app es gratuita. El costo de tu agente A2A lo define el dueño del endpoint.

Problemas comunes

Problema Solución
Punto rojo de conexión Verifica dominio y token. Sakbe comprueba el endpoint con una petición JSON-RPC de estado (GetTask); asegúrate de que tu agente la responda.
El micrófono no se activa Revisa permisos en Ajustes de iOS → Sakbe (micrófono + reconocimiento).
La voz suena cortada Prueba otra voz en Ajustes → Text-to-Speech. Verifica que no haya otra app usando audio.
No veo la imagen de un preview El sitio puede no tener og:image o la URL fue rechazada. Abre el link directamente.
Sakbe no notifica al volver Asegúrate de que las notificaciones estén habilitadas para Sakbe en Ajustes de iOS.

Contacto