# Cuando algo falla (/es/docs/b24/troubleshooting)

Empieza por el síntoma, haz la comprobación y vuelve a ejecutar el comando. Guarda el código de error y el nombre del
perfil para una solicitud de soporte.

| Síntoma | Qué hacer |
| --- | --- |
| No sabes qué está configurado | Ejecuta `b24 doctor`. No lee ningún llavero ni usa la red. |
| No se encuentra `b24` | Abre una terminal nueva y comprueba que la carpeta global de npm está en `PATH`. |
| "name a profile" | Pon el perfil primero, como en `b24 work config show`, o define `B24_PROFILE`. |
| El archivo de ajustes no se puede leer | `doctor` muestra cada problema del archivo en `config.issues`. Ejecuta el `config unset` que indica cada uno o corrige el archivo a mano. |
| `doctor` muestra `files.problems` | Otros usuarios del ordenador pueden leer `config.json` o entrar en su carpeta. Ejecuta cada `chmod` que `doctor` imprime tras "to make it private:". `doctor` nunca cambia por sí mismo los permisos de un archivo. |
| "no CRM user is chosen" | Una sincronización copia las negociaciones y los prospectos de los usuarios que eliges. Busca sus ids con `users list` y luego ejecuta `config set crm.bitrix24:<portal>.unassigned <ids>`. Consulta [de quién son las negociaciones y los prospectos](/llms.mdx/docs/es/b24/usage/content.md#whose-deals-and-leads). |
| "not signed in" | Ejecuta `session start` con tu perfil, por ejemplo `b24 work session start`, y pega la dirección del webhook. |
| Bitrix24 rechazó este webhook o el inicio de sesión con la aplicación | El webhook se borró o se editó en Bitrix24, y eso cambia su dirección, o la aplicación local se borró o cambió su clave. Crea uno nuevo y ejecuta `session start` otra vez. |
| Falta el permiso de acceso para un método, o `ERROR_METHOD_NOT_FOUND` | Añade el permiso de acceso (`crm`, `user_basic`, `department`) al webhook en Bitrix24. |
| `rate_limited` | El portal permite unas 2 peticiones por segundo para todas sus aplicaciones juntas. `b24` espera por sí mismo una espera corta; si es larga, te avisa. |
| `outcome_unknown` en una escritura | Puede que el portal hiciera el cambio. Mira primero el elemento (`sync` y luego `show`), y repite la escritura solo si el cambio no está: Bitrix24 haría la repetición por segunda vez. Consulta [escribir](/llms.mdx/docs/es/b24/usage/content.md#write). |
| Se rechaza una escritura | Lo impiden los permisos del perfil o `B24_READ_ONLY`; consulta los [permisos](/llms.mdx/docs/es/b24/permissions/content.md). |

Nunca pegues un token, una contraseña ni contenido privado en una solicitud de soporte.