# Llamadas (/es/docs/b24/calls)

Lee esta página si los teléfonos de tu empresa funcionan con la telefonía de Bitrix24. Explica cómo copiar las
llamadas del portal al almacén local de WireCat, convertir sus grabaciones en texto en este ordenador y encontrar las
llamadas de un cliente junto a sus negociaciones, mensajes y correo. Al final, `memo context` muestra las llamadas de
un cliente en su historial.

Palabras que usa esta página:

- **Historial de llamadas**: la lista de llamadas que el portal guarda en Telephony → Call history. b24 la lee con el
  método `voximplant.statistic.get`.
- **Perfil**: el nombre del inicio de sesión de un portal, como `work`. Es la primera palabra de un comando.

## Antes de la primera sincronización [#antes-de-la-primera-sincronización]

El webhook necesita el permiso `telephony`, además de `crm`, `user_basic` y `department`. Edita el webhook en
Developer resources → Integrations, marca Telephony y guarda. Una aplicación local necesita el mismo permiso en su
ficha. El empleado que creó el webhook también necesita el permiso del portal para ver las estadísticas de llamadas.

Copiar las llamadas solo lee. Ningún comando hace una llamada ni cambia una línea. Solo `calls export`, desactivado
hasta que lo actives, escribe en el portal. Consulta
[Escribir en Bitrix24 las llamadas de otras centralitas](#write-other-phone-systems-calls-into-bitrix24).

## Copiar las llamadas [#copiar-las-llamadas]

`b24 work sync` copia las llamadas después del CRM y dice cuántas en su respuesta. Si no puede copiarlas, por ejemplo
porque al webhook le falta el permiso de telefonía, dice por qué en una nota y la sincronización del CRM termina bien
igualmente. Para dejar las llamadas fuera de `sync`: `b24 work config set sync_calls false`. `meetings sync` copia
solo las llamadas:

```sh
b24 work meetings sync                                   # calls since the last sync; the first reads 30 days
b24 work meetings sync --since-time 2026-11-01T00:00:00Z # calls from a date on
b24 work meetings list                                   # newest first, from the store, offline too
b24 work meetings show 12                                # one call: who, when, how it ended
```

Cada llamada es una reunión de tipo llamada. Guarda su dirección (entrante o saliente), el número del cliente, el
empleado, cuánto hablaron y cómo terminó: contestada, no contestada, ocupado o fallida. También guarda el contacto, la
empresa o el prospecto del CRM al que el portal vinculó la llamada, y la actividad del CRM de la llamada, como números
para buscar.

En una línea con mucho uso, una primera sincronización lee muchas páginas antes de guardar nada. Si se detiene por su
límite de tiempo, dale un periodo más corto o más tiempo: `meetings sync --since-time 7d` o `--timeout 5m`.

Cada sincronización vuelve a leer las tres horas anteriores a la última, así que una llamada que seguía en curso
aparece la vez siguiente. Un temporizador que ejecuta `sync` también mantiene las llamadas al día.

### De quién son las llamadas [#de-quién-son-las-llamadas]

La misma regla que para las negociaciones: una copia nunca es todo el portal. `meetings sync` copia las llamadas del
usuario que inició sesión, o de los usuarios que elegiste en `crm.bitrix24:<portal>.unassigned`
(consulta [De quién son las negociaciones y los prospectos](/llms.mdx/docs/es/b24/usage/content.md#whose-deals-and-leads)).
Un perfil cuyo `scope` es `all` se niega a sincronizar llamadas hasta que lo pongas en `mine`.

## El cliente y el empleado [#el-cliente-y-el-empleado]

El empleado de una llamada es la misma persona que el usuario del portal en tu copia: sus llamadas aparecen en esa
persona.

El cliente se encuentra por su número. Un número que el portal escribe con `+` se lee tal cual. Un número sin `+`,
como `79000000001`, necesita su país:

```sh
b24 work config set phone_region ru        # or several: ru,kz
b24 work meetings sync --rescan            # read the calls again with it
```

Sin `phone_region`, o cuando dos de sus países leen un número de forma distinta, el número se guarda tal como está
escrito y no se une a nadie. Con él, una llamada desde un móvil se une al contacto, a la cuenta de WhatsApp o
Telegram, o a las llamadas de otra centralita que tienen el mismo número. Un fijo no se une a nadie por sí solo: una
línea de oficina es de todos los que trabajan allí.

```sh
memo context person:12        # the client's history: messages, mail and calls, newest first
```

## Grabaciones [#grabaciones]

Las grabaciones se quedan en el portal salvo que las pidas:

```sh
b24 work config set download_recordings true
b24 work meetings sync         # downloads the recording of each new call
```

Cada grabación se guarda en la carpeta de estado de b24, en `recordings/<profile>/`, y solo tú puedes leerla.
`meetings show` da su ruta como `local_path`, y WireCat Desktop la reproduce. Una grabación puede ocupar unos
megabytes por llamada: comprueba el espacio antes de activarlo en una línea con mucho uso.

El enlace que da el portal para una grabación lleva un token de acceso. b24 solo lo sigue en la dirección del propio
portal, justo después de leerlo, y nunca lo guarda ni lo imprime.

## Convertir las llamadas en texto [#convertir-las-llamadas-en-texto]

El texto se hace en este ordenador con un modelo de voz local: ninguna grabación sale de él.

```sh
b24 models download gigaam-v3        # once, a few hundred megabytes
b24 work meetings transcribe         # calls of five seconds or more with no text yet, newest first
b24 work meetings transcript 12      # one call's text
```

Una grabación guardada por `download_recordings` se lee de este ordenador. Cualquier otra se descarga para la
transcripción, y se guarda solo cuando `download_recordings` está activado. Bitrix24 no dice qué lado de una
grabación estéreo es el empleado, así que el texto nombra los canales "Channel 1" y "Channel 2". Una llamada de más
de una hora se omite.

## Permisos [#permisos]

Cada comando tiene su propia clave: `meetings.sync`, `meetings.transcribe`, `meetings.list` y otras. Para que los
agentes no copien llamadas:

```sh
b24 work config set permissions.meetings.sync deny
```

`api call voximplant.statistic.get` sigue denegado: su respuesta lleva los enlaces de las grabaciones con sus tokens.
Consulta [Permisos](/llms.mdx/docs/es/b24/permissions/content.md).

## Escribir en Bitrix24 las llamadas de otras centralitas [#escribir-en-bitrix24-las-llamadas-de-otras-centralitas]

Las llamadas de otra centralita, como pbx, pueden llegar al contacto del cliente en Bitrix24, para que el CRM las
muestre junto a las llamadas del propio portal. Está desactivado hasta que lo actives, y escribe cada llamada una vez.

Bitrix24 solo deja escribir una llamada a una aplicación, no a un webhook. Primero inicia la sesión del perfil como
aplicación local:
`b24 work session start --portal <portal> --client-id <id>`. Luego actívalo y permite sus dos métodos:

```sh
b24 work config set export_calls true
b24 work config set permissions.api.telephony.externalcall.register allow
b24 work config set permissions.api.telephony.externalcall.finish allow
b24 work calls export --since-time 7d --dry-run   # each call, the fields it would send, where it would land
b24 work calls export --since-time 7d
```

Una llamada llega solo cuando su cliente está vinculado a exactamente un contacto de este portal, y su empleado a un
usuario del portal (`memo people link` los vincula). Cualquier otra llamada aparece como omitida, con el motivo. Las
llamadas del propio portal se omiten: ya están en Bitrix24.

Cada llamada se registra y se termina con `telephony.externalCall.register` y `telephony.externalCall.finish`, sin un
registro nuevo en el CRM, sin ficha de llamada y sin mensaje en el chat. b24 guarda las llamadas que escribió en su
carpeta de estado, en `calls-export/<portal>.json`, así que una segunda ejecución nunca vuelve a escribir una llamada.
Bitrix24 por sí solo solo detecta una repetición dentro de 30 minutos.

Para pararlo: `b24 work config set export_calls false`. Nada de lo escrito en el portal se deshace.
