Docs para desarrolladores
Español

Primeros pasos

Hablar con agentes de IA

Un bot contesta mensajes y también llamadas: el mismo bot en el ordenador, el teléfono y el Apple Watch, agentes que cualquiera puede crear, adónde van los datos y qué puedes decidir tú.

Con los bots de voz, Pabal se convierte en un lugar para hablar con agentes de IA. Un bot contesta mensajes y también llamadas. Puedes preguntarle algo por escrito a un bot desde el ordenador, llamarlo desde el teléfono y seguir desde el Apple Watch mientras haces deporte. Esta página lo reúne todo en un solo sitio: qué se puede hacer, adónde van los datos y qué puede decidir la organización que gestiona el servidor. Los detalles están en Usar la aplicación (para quien llama), Bots de voz (para quien crea bots) e Instalar el servidor (para quien gestiona el servidor).

Todavía en preparación

Los bots de voz, la app del reloj para Apple Watch y «Guardar conversación» que se describen aquí todavía no se pueden usar en pabal.me. Se están probando en el servidor de desarrollo y solo se activarán cuando terminen la revisión legal y la publicación de las aplicaciones. El estado actual está en la tabla del final.

Qué cambia

  • Los bots contestan llamadas. Cuando llamas a un bot, contesta el modelo de voz de IA de Pabal y te responde hablando. El bot siempre dice que es una IA y nunca finge ser una persona.
  • Mensajes y llamadas en el mismo chat. Cuando termina la llamada, queda un registro de la llamada en el chat con ese bot. Si quieres, también puedes guardar como texto la conversación de la llamada (Guardar conversación).
  • Cualquiera puede crearlos. Quien creó el bot activa la voz en @BotFather y define con instrucciones a qué se dedica el bot. También puede hacer que, durante la llamada, el bot use sus propios sistemas (buscar pedidos, confirmar reservas…).
  • Quien llama confirma primero. Antes de llamar, la pantalla de confirmación «An AI answers this call» («Una IA contesta esta llamada») indica adónde va el audio, y solo pueden llamar las personas de 19 años o más.

Un agente en todos tus dispositivos

Tus dispositivos Pabal (servidor del operador) Fuera de Pabal App de escritorio Mac · Windows App del teléfono Android · iPhone App del reloj Solo llamadas · pronto pabal-server Un solo chat con el bot, el mismo en todas partes Registro de llamadas · texto guardado (si se elige) Consentimiento · admisión · límites Operador: emergencia · autorización · apertura Cuentas y mensajes se guardan aquí pabal-voice Pasarela de voz Descifra el audio → modelo No guarda el audio Código del propietario Bot API · voice_call Herramientas · servidores MCP Transcripción (si se activa) Google Vertex AI Gemini Live (predeterminado) us-central1 · EE. UU. Servidor del desarrollador Modo stream (wss) Recibe el audio tal cual ① ② Audio — apps: relé (coturn) Reloj: punto de entrada (WSS) ③ enlace ④ ⑤ ⑥
Un solo bot desde cualquier dispositivo: los registros, en el servidor del operador; el audio, al destino que se haya fijado

Explicación del diagrama

  • Tres zonas: a la izquierda, los dispositivos de la persona; en el centro, el servidor de la organización que gestiona Pabal; a la derecha, lo que queda fuera de Pabal. Las cajas rojas son los lugares donde el audio de la llamada sale de Pabal.
  • ①②: las apps de escritorio y del teléfono llegan al servidor por la conexión de siempre (MTProto), y la app del reloj, por un punto de entrada HTTPS propio del reloj. Llames desde el dispositivo que llames, el registro de la llamada queda en el mismo chat con el mismo bot, y las cuentas y los mensajes se guardan en el servidor del operador.
  • Las líneas grises discontinuas son el audio de la llamada: las apps pasan por el relé de llamadas (coturn) y el reloj por el punto de entrada de audio (WSS) hasta llegar a la pasarela de voz. Como la pasarela descifra el audio para pasárselo al modelo, las llamadas con un bot no tienen cifrado de extremo a extremo.
  • ③ Enlace: el servidor pasa a la pasarela la llamada que ha aceptado, junto con las instrucciones, el saludo, la voz, el idioma y las herramientas que definió el propietario del bot. Las reglas básicas de Pabal (decir que es una IA, etc.) siempre van primero.
  • ④: el programa del propietario del bot recibe los avisos de llamada (voice_call) y las consultas de herramienta del modelo, y las responde (flecha gris). Los servidores MCP del propietario del bot también están aquí. El propietario del bot no recibe el audio de la llamada.
  • ⑤⑥: el audio de una llamada gestionada va a Google (Gemini Live de Vertex AI, us-central1 en Estados Unidos) o, si el propietario del bot usa su propia clave de modelo, a la cuenta de su proveedor. Si el bot usa el modo stream, en lugar de Google es el servidor del desarrollador del bot el que recibe el audio tal cual (línea roja discontinua).

Un día cualquiera

  1. Por la mañana, por escrito en el ordenador. En la app de escritorio le escribes al bot de pedidos: «¿Cuándo llega lo que pedí ayer?». El programa del propietario del bot te contesta por escrito.
  2. Al mediodía, por teléfono. Pulsas el botón de llamada de la parte superior del chat con ese mismo bot. Lees la pantalla de confirmación y pulsas «I'm 19 or older · Call» («Tengo 19 años o más · Llamar»): tras el aviso de voz sobre la IA, el bot te saluda. Durante la llamada, el modelo busca el pedido con las herramientas del propietario del bot y te lo cuenta.
  3. Por la tarde, corriendo, con el reloj. Aunque salgas sin el iPhone, con la app del reloj para Apple Watch llamas al mismo bot. Lo mejor es escuchar con AirPods.
  4. Al terminar, dejarlo por escrito. Si en la pantalla de confirmación marcaste «Keep this call's conversation as text in my chat» («Guardar la conversación de esta llamada como texto en mi chat»), al terminar la llamada la conversación queda como mensaje silencioso justo debajo del registro de la llamada en tu chat (Guardar conversación). Solo la ves tú; no va ni al bot ni a su propietario.
Límites que conviene conocer
  • Mientras hablas por el reloj no puedes ver la pantalla de la app de entrenamiento. Si la abres durante la llamada, el reloj muestra «End Call to Continue» (hay que colgar para seguir).
  • La app del reloj todavía no gestiona mensajes. Solo sirve para llamar a bots de voz. En el reloj no puedes registrarte: inicias sesión con una cuenta que ya existe.
  • Durante la llamada, el modelo no conoce por sí solo los mensajes del chat. Para que la llamada siga lo que escribiste por la mañana, el propietario del bot tiene que contárselo al empezar la llamada con sendVoiceCallContext. Al revés, el texto guardado de la conversación tampoco va al bot, así que el bot no sabe qué se habló en la llamada.
  • Todavía no se puede llamar desde el reloj a bots que usan herramientas, servidores MCP, clave propia, modo stream o la transcripción del propietario del bot.

Cualquiera puede crearlos

Un agente de IA empieza con una simple cuenta de bot. Después de crear el bot con Crear un bot:

  • Activar la voz: en @BotFather, /mybots → el bot → llamadas de voz; acepta las reglas y actívalas (Activar las llamadas de voz).
  • A qué se dedica el bot: define las instrucciones, el saludo y la voz. El bot puede hablar 9 idiomas, entre ellos el coreano y el inglés (Ajustes, Voces e idiomas).
  • Conectarlo con tus sistemas: herramientas (Bot API) para que el modelo llame al código del bot durante la llamada, o un servidor MCP que ya tengas.
  • El audio, a tu servidor: el modo stream, en el que tu servidor recibe directamente el audio de la llamada en lugar del modelo de IA, y una clave de modelo propia, para que el coste vaya a tu cuenta.
  • Registros: la transcripción, con la que el propietario del bot recibe el texto de la conversación (quien llama oye un aviso al conectarse). Es distinta de «Guardar conversación», que elige quien llama.

Adónde van los datos

Las llamadas con un bot no tienen cifrado de extremo a extremo

Las llamadas entre personas se cifran para que solo los dos dispositivos puedan descifrarlas, pero en una llamada con un bot la pasarela de voz de Pabal descifra el audio y se lo pasa al modelo de IA (o, en modo stream, al servidor del desarrollador del bot). Antes de llamar, la pantalla de confirmación te lo indica, junto con adónde va el audio.

QuéAdóndeDurante cuánto tiempo
Cuentas, mensajes y registros de llamadasEl servidor del operador (base de datos)Hasta que se eliminen
Audio de una llamada gestionadaLa pasarela de voz lo descifra y lo envía a Google (API Gemini Live de Vertex AI, Iowa, Estados Unidos, us-central1)Pabal no lo guarda. Google no guarda nada después de generar la respuesta, pero el contenido que sus controles automáticos marquen como posible abuso puede conservarse hasta 90 días (lo mismo que dice la pantalla de confirmación)
Audio de una llamada con clave propiaLa cuenta del proveedor que eligió el propietario del botLas reglas de ese proveedor
Audio de una llamada en modo streamEl servidor del desarrollador del bot (wss)Responsabilidad del desarrollador del bot
Valores usados por las herramientasEl programa del propietario del bot · sus servidores MCPResponsabilidad del propietario del bot. Los números que parecen de tarjeta o de identificación nacional no se envían
Transcripción del propietario del bot (si se activa)Se entrega una vez al propietario del botPabal borra a las 24 horas lo que no se haya recogido
Guardar conversación (solo si se elige)Solo en el chat de la propia persona; no va al bot ni a su propietarioHasta que se elimine
Metadatos de la llamada (quién, cuándo, cuánto duró)El servidor del operador180 días

El propietario del bot recibe el nombre, el número de cuenta y el idioma de la aplicación de quien llama, la hora y la duración de la llamada, y los valores usados por las herramientas. No recibe el número de teléfono, el nombre de usuario ni el audio de la llamada. Para que esto coincida con lo que dice la pantalla de confirmación, el operador debe desactivar la caché de datos de Vertex (Instalar el servidor: clave de Vertex AI).

Lo que puedes decidir

Una empresa u organización que gestiona su propio Pabal puede elegir por sí misma adónde van las conversaciones con los agentes de IA.

  • Gestionar tu propio servidor: las cuentas, los mensajes y los registros de llamadas están en tu servidor y en tu base de datos (Instalar el servidor).
  • La clave de modelo del propietario del bot: las llamadas pasan por la cuenta que el propietario del bot contrató con un proveedor, en lugar de la clave predeterminada de Pabal (Clave de modelo propia).
  • El modo stream: es tu servidor, y no Google, el que recibe el audio de la llamada y contesta como tú decidas (Modo stream).
  • Los interruptores del operador: el interruptor de emergencia que detiene todas las llamadas, aceptar solo los bots autorizados, los testers, los límites, permitir la transcripción a los propietarios de bots y la apertura al público (Administración y ajustes: pestaña Voz).

Por eso lo que promete Pabal es «una comunicación con agentes de IA en la que tú decides adónde van los datos». No significa que «todo se queda dentro del servidor»: el audio de una llamada con el motor predeterminado va a Google en Estados Unidos, y con el modo stream, las herramientas o MCP va al servidor del propietario o del desarrollador del bot.

Estado actual (pabal.me)

Funciónpabal.meNotas
Llamadas a bots de vozDesactivadoEn pruebas en el servidor de desarrollo. Antes hacen falta la sección sobre llamadas a bots de la política de privacidad y compilaciones de la aplicación con la pantalla de confirmación (Bots de voz: estado actual)
App del reloj para Apple WatchEn preparaciónSolo pruebas internas (TestFlight). Solo sirve para llamar a bots de voz
Guardar conversaciónDesactivadoFalta la revisión legal del texto de la pantalla de confirmación
Llamadas de botsDesactivado: a la espera de la revisión legalPrimero tienen que estar sus secciones en la política de privacidad y en los términos, y versiones de la aplicación con la pantalla de permiso (Bots de voz — Llamadas de bots)
HerramientasDesactivadoNecesitan que las llamadas a bots de voz estén activadas
Servidores MCP · clave de modelo propia · modo streamDesactivadoFalta la versión de la pantalla de confirmación que muestra esos destinatarios

Esta tabla refleja el estado a 2026-10-02. En otros servidores puede variar según lo que haya activado el operador: para saber si tu bot puede contestar llamadas, consulta getVoiceCallSettings.